AssetStudio
AssetStudio - Based on the archived Perfare's AssetStudio, I continue Perfare's work to keep AssetStudio up-to-date, with support for new Unity versions and additional improvements.
What This Fork Offers Over the Original Repository
- Support for New Unity Versions
- Added support for Unity 2021.3.10+, 2022.2, and 2022.3.
- Enhanced Shader Preview and Export
- Add pretty printing functionality to enhance shader information readability.
- Fix errors by implementing lazy generation for ShaderSubProgram as needed.
- Support for Lua bytecode assets
-
Decompile, preview and export LuaJIT, Lua 5.1, 5.2, and 5.3 bytecode assets.
-
None of the repo, the tool, nor the repo owner is affiliated with, or sponsored or authorized by, Unity Technologies or its affiliates.
AssetStudio is a tool for exploring, extracting and exporting assets and assetbundles.
Features
- Support version:
- 3.4 - 2022.3
- Support asset types:
- Texture2D : convert to png, tga, jpeg, bmp
- Sprite : crop Texture2D to png, tga, jpeg, bmp
- AudioClip : mp3, ogg, wav, m4a, fsb. support convert FSB file to WAV(PCM)
- Font : ttf, otf
- Mesh : obj
- TextAsset
- Shader
- MovieTexture
- VideoClip
- MonoBehaviour : json
- Animator : export to FBX file with bound AnimationClip
- Lua bytecode : decompile Lua bytecode back to Lua source code
Requirements
- AssetStudio.net472
- AssetStudio.net5
- AssetStudio.net6
Usage
Load Assets/AssetBundles
Use File-Load file or File-Load folder.
When AssetStudio loads AssetBundles, it decompresses and reads it directly in memory, which may cause a large amount of memory to be used. You can use File-Extract file or File-Extract folder to extract AssetBundles to another folder, and then read.
Extract/Decompress AssetBundles
Use File-Extract file or File-Extract folder.
Export Assets
use Export menu.
Export Model
Export model from "Scene Hierarchy" using the Model menu.
Export Animator from "Asset List" using the Export menu.
With AnimationClip
Select model from "Scene Hierarchy" then select the AnimationClip from "Asset List", using Model-Export selected objects with AnimationClip to export.
Export Animator will export bound AnimationClip or use Ctrl to select Animator and AnimationClip from "Asset List", using Export-Export Animator with selected AnimationClip to export.
Export MonoBehaviour
When you select an asset of the MonoBehaviour type for the first time, AssetStudio will ask you the directory where the assembly is located, please select the directory where the assembly is located, such as the Managed folder.
For Il2Cpp
First, use my another program Il2CppDumper to generate dummy dll, then when using AssetStudio to select the assembly directory, select the dummy dll folder.
Decompiling Lua Bytecode
By default, the feature to decompile Lua bytecode is not enabled. It can be activated via Options-Decompile Lua
Build
- Visual Studio 2022 or newer
- AssetStudioFBXNative uses FBX SDK 2020.2.1, before building, you need to install the FBX SDK and modify the project file, change include directory and library directory to point to the FBX SDK directory
Open source libraries used
Texture2DDecoder
Lua Bytecode Decompiler
- LuaJIT: zhangjiequan/ljd: LuaJIT raw-bytecode decompiler
- Lua 5.1, 5.2, and 5.3: zhangjiequan/luadec: Lua Decompiler for lua 5.1 , 5.2 and 5.3
Roadmap
Support for new Unity versions
Unity 2023.1, Unity 2023.2, Unity 6 (Unity 2023 LTS, Unity 2023.3), etc.
License
AssetStudio is licensed under the MIT license.
Credits
If you find this tool useful, please mention my name in your credits screen. Something like "AssetStudio by Perfare & zhangjiequan" or "Thanks to Perfare & zhangjiequan" would be very much appreciated.
Collaborate
Feel free to fork the project and make modifications for yourself or to share by creating pull requests. Also, create issues for feature requests or bug reports if you want to help improving this tool, thanks!
Contact
Contact me at zhangjiequan@qq.com
Donate
AssetStudio is a free and open-source software. If you like it and find it helpful, you can buy me a coffee!
