AssetRipper is a tool for extracting assets from serialized files (CAB-*, *.assets, *.sharedAssets, etc.) and assets bundles (*.unity3d, *.assetbundle, etc.) and converting them into the native Unity engine format.
Important note: This project is currently in an experimental state. Expect bugs and many changes.
Current supported versions: 1.x to 2019.x (support for later versions is in progress)
- Scenes
- Prefabs (GameObjects with transform components)
- AnimationClips (legacy, generic, humanoid)
- Meshes
- Shaders (native listing)
- Textures
- Audio
- Fonts
- Movie textures
- Materials
- AnimatorControllers
- Avatars
- Terrains
- TextAssets
- Components:
- MeshRenderer
- SkinnedMeshRenderer
- Animation
- Animator
- Canvas
- Light
- ParticleSystem
- Colliders
- Rigidbody
- AudioSource
- Camera
- MonoBehaviour (Mono and Il2Cpp)
- MonoScript (Mono and Il2Cpp)
Download links can be found on the latest release page.
-
AssetAnalyzer (Cross-Platform)
Simple program to investigate file header information.
-
AssetRipperCore (Cross-Platform)
Core library. It's designed as an single module without any third party dependencies.
-
AssetRipperLibrary (Cross-Platform)
This is an expansion library for AssetRipperCore. It includes some third party dependencies and has some extra converters, so on Windows it additionally exports:
- AudioClip .wav export
- Texture2D .png export (with Sprites)
- Shader DirectX blob export
-
AssetRipperGUI (Windows-only)
Basic graphic interface application utilizing the AssetRipperLibrary.
-
AssetRipperConsole (Cross-Platform)
Command line equivalent of AssetRipperGUI. Since it has no GUI, it can be cross-platform compatible.
-
UnitTester (Cross-Platform)
Automated tester to verify project integrity while making changes.
If you want to build a solution, you'll need:
-
Compiler with C# 9 syntax support, such as Visual Studio 2019
If you want to run binary files, you need to install:
- Unity 2017.3.0f3 or greater (NOTE: your editor version must be no less than the game's version)
The development of this project has a dedicated Discord server. Feel free to come say hi. This is also an alternative location for people to post issues.
For advanced users, every commit is automatically built into an alpha build with Github Actions. You can obtain these builds on the actions page if you're logged in with a github account. Note that these builds are framework dependent, i.e. you need .NET 5 installed to run them.
- Unity 2020 and 2021 support
- Predetermined GUID support
- Better shader implementation
- NAudio implementation for exporting other audio formats
- More Unity Component Exporters
- Option to reference assemblies instead of scripts
- Better platform support
- Port C++ dependencies to C# where possible
AssetRipper is licensed under the GNU General Public License v3.0
Please be aware that distributing the output from this software may be against copyright legislation in your jurisdiction. You are responsible for ensuring that you're not breaking any laws.
This began as a fork of mafaca's uTinyRipper project licensed under the MIT license.
It has borrowed code from Perfare's AssetStudio project licensed under the MIT license.
It has borrowed code from spacehamster's uTinyRipperExporter project licensed under the MIT license.
Brotli is licensed under the MIT license.
CommandLineParser is licensed under the MIT license.
Cpp2IL is licensed under the MIT license.
FMOD is licensed under a non-commercial license.
HLSLcc is licensed under the MIT license.
LibOgg and LibVorbis are licensed from Xiph under the BSD 3-Clause License.
Lz4 is licensed under the MIT license and the BSD 2-Clause license.
Mono.Cecil is licensed under the MIT license.
SharpZipLib is licensed under the MIT license.
Smolv is licensed under the MIT license.
SpirV is licensed under the BSD 2-Clause license.
texgenpack is licensed under a permissive license.
This software is not sponsored by or affiliated with Unity Technologies or its affiliates. "Unity" is a registered trademark of Unity Technologies or its affiliates in the U.S. and elsewhere.