UnityPy 1.2.6.0

A pythonic port of AssetStudio by Perfare

UnityPy

A Unity asset extractor based on AssetStudio.

Installation

UnityPy

main module

pip install UnityPy

or download/clone the git and use

python setup.py install

optional modules

It's highly recommended to install following modules to enjoy the full power of UnityPy.

All texture modules use Cython, so they won't work on some systems.

Windows users have to install Microsoft Visual C++ 14.0 Build Tools Only to be able to use Cython.

• python-fsb5 - FSB Audio Sample Support

pip install fsb5

• decrunch - crunch texture support

pip install decrunch

• etcpack - ETC texture support

pip install etcpack

• pvrtc_decoder - PVRTC Texture Support

pip install pvrtc_decoder

• astc_decomp - ASTC Texture Support

pip install astc_decomp

Usage

from UnityPy import AssetsManager

am = AssetsManager()

# Load file via file path
am.load_file(fp)
# Load all files in a folder
am.load_folder(fp)

for name, asset in am.assets.items():
    for id, obj in asset.objects.items():
        data = obj.read()

Goals

near future

• adding a documentation

far future

• ability to edit assets (like in UABE)
• broader object type support
• code optimization
• multiprocessing

Motivation

I'm an active data-miner and noticed that unitypack has problems with new unity assets. The problem in unitypack isn't that easy to fix and the undocumented code is a bit hard to understand. That's why I tried other tools like UABE and AssetStudio. Sadly none of these tools can be used like unitypack. That's why I started this project.

License

UnityPy is licensed under the terms of the MIT license. The full license text is available in the LICENSE file.

Community

Discord