AssetStudio/README.md

75 lines
2.9 KiB
Markdown
Raw Permalink Normal View History

2018-04-02 22:51:22 +00:00
# AssetStudio
2018-12-17 18:08:55 +00:00
[![Build status](https://ci.appveyor.com/api/projects/status/rnu7l90422pdewx4?svg=true)](https://ci.appveyor.com/project/Perfare/assetstudio/branch/master/artifacts)
2015-11-02 23:16:29 +00:00
**None of the repo, the tool, nor the repo owner is affiliated with, or sponsored or authorized by, Unity Technologies or its affiliates.**
2018-12-17 18:08:55 +00:00
AssetStudio is a tool for exploring, extracting and exporting assets and assetbundles.
2015-11-02 23:16:29 +00:00
2018-01-18 01:56:19 +00:00
## Features
2018-12-17 18:08:55 +00:00
* Support version:
2020-08-14 07:50:45 +00:00
* 2.5 - 2020.1
2018-12-17 18:08:55 +00:00
* Support asset types:
2020-03-24 00:52:30 +00:00
* **Texture2D** : convert to png, tga, jpeg, bmp
* **Sprite** : crop Texture2D to png, tga, jpeg, bmp
2018-12-17 18:08:55 +00:00
* **AudioClip** : mp3, ogg, wav, m4a, fsb. support convert FSB file to WAV(PCM)
2020-03-24 00:52:30 +00:00
* **Font** : ttf, otf
2018-12-17 18:08:55 +00:00
* **Mesh** : obj
* **TextAsset**
2017-01-16 16:30:07 +00:00
* **Shader**
2018-12-17 18:08:55 +00:00
* **MovieTexture**
2018-01-15 02:08:02 +00:00
* **VideoClip**
2020-08-14 07:50:45 +00:00
* **MonoBehaviour** : json
2018-12-17 18:08:55 +00:00
* **Animator** : export to FBX file with bound AnimationClip
2015-11-02 23:16:29 +00:00
2020-08-16 10:53:55 +00:00
## Requirements
2017-01-16 16:30:07 +00:00
2020-03-28 07:52:15 +00:00
- [.NET Framework 4.7.2](https://dotnet.microsoft.com/download/dotnet-framework/net472)
2017-01-16 16:30:07 +00:00
2020-08-16 10:53:55 +00:00
## 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 other program [Il2CppDumper](https://github.com/Perfare/Il2CppDumper) to generate dummy dll, then when using AssetStudio to select the assembly directory, select the dummy dll folder.
2018-01-18 01:56:19 +00:00
## Build
2018-04-07 21:39:36 +00:00
2020-03-28 07:52:15 +00:00
* Visual Studio 2019 or newer
2020-08-16 10:53:55 +00:00
* **AssetStudioFBXNative** uses FBX SDK 2020.0.1 VS2017, 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
2020-03-24 00:52:30 +00:00
## Open source libraries used
### Texture2DDecoder
* [Ishotihadus/mikunyan](https://github.com/Ishotihadus/mikunyan)
* [BinomialLLC/crunch](https://github.com/BinomialLLC/crunch)
* [Unity-Technologies/crunch](https://github.com/Unity-Technologies/crunch/tree/unity)