bags432 / 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.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

AssetStudio

Last Commit Open Issues Contributors Contributions Welcome

GitHub watchers GitHub forks GitHub stars

Platform License

Github CI Status

Custom

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

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

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!

image.png

Star History

Star History Chart

About

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.

License:MIT License


Languages

Language:C# 71.7%Language:C++ 17.4%Language:Python 7.0%Language:C 2.6%Language:Lua 1.3%