mirror of
https://github.com/aelurum/AssetStudio.git
synced 2025-11-12 23:32:42 -05:00
201 lines
12 KiB
Markdown
201 lines
12 KiB
Markdown
## AssetStudioModCLI
|
|
CLI version of AssetStudioMod.
|
|
- Supported asset types for export: `Texture2D`, `Texture2DArray`, `Sprite`, `TextAsset`, `MonoBehaviour`, `Font`, `Shader`, `MovieTexture`, `AudioClip`, `VideoClip`, `Mesh`, `Animator`.
|
|
|
|
### Usage
|
|
```
|
|
AssetStudioModCLI <input path to asset file(s)/folder> [-m, --mode <value>]
|
|
[-t, --asset-type <value(s)>] [-g, --group-option <value>]
|
|
[-f, --filename-format <value>] [-o, --output <path>]
|
|
[-r, --overwrite-existing] [-h, --help]
|
|
[--log-level <value>] [--log-output <value>]
|
|
[--image-format <value>] [--audio-format <value>]
|
|
[--l2d-group-option <value>] [--l2d-motion-mode <value>]
|
|
[--l2d-search-by-filename] [--l2d-force-bezier]
|
|
[--fbx-scale-factor <value>] [--fbx-bone-size <value>]
|
|
[--fbx-animation] [--fbx-uvs-as-diffuse]
|
|
[--filter-by-name <text>] [--filter-by-container <text>]
|
|
[--filter-by-pathid <text>] [--filter-by-text <text>]
|
|
[--filter-with-regex] [--blockinfo-comp <value>]
|
|
[--block-comp <value>] [--max-export-tasks <value>]
|
|
[--export-asset-list <value>] [--assembly-folder <path>]
|
|
[--unity-version <text>] [--decompress-to-disk]
|
|
[--not-restore-extension] [--ignore-typetree]
|
|
[--load-all]
|
|
|
|
General Options:
|
|
-m, --mode <value> Specify working mode
|
|
<Value: extract | export(default) | exportRaw | dump | info | live2d |
|
|
splitObjects | animator>
|
|
Extract - Extract(Decompress) asset bundles
|
|
Export - Convert and export assets
|
|
ExportRaw - Export raw assets
|
|
Dump - Generate json dumps of loaded asset
|
|
Info - Load file(s) and show the number of available for export assets
|
|
Live2D - Export Live2D Cubism models
|
|
SplitObjects - Export all model objects (split) (fbx)
|
|
Animator - Export Animator assets (fbx)
|
|
Example: "-m info"
|
|
|
|
-t, --asset-type <value(s)> Specify asset type(s) to export
|
|
<Value(s): tex2d, tex2dArray, sprite, textAsset, monoBehaviour, font, shader
|
|
movieTexture, audio, video, mesh | all(default)>
|
|
All - Export all asset types listed in the values
|
|
*To specify multiple asset types, write them separated by ',' or ';' without spaces
|
|
Examples: "-t sprite" or "-t tex2d,sprite,audio" or "-t tex2d;sprite;font"
|
|
|
|
-g, --group-option <value> Specify the way in which exported assets should be grouped
|
|
<Value: none | type | container(default) | containerFull | fileName | sceneHierarchy>
|
|
None - Do not group exported assets
|
|
Type - Group exported assets by type name
|
|
Container - Group exported assets by container path
|
|
ContainerFull - Group exported assets by full container path (e.g. with prefab name)
|
|
SceneHierarchy - Group exported assets by their node path in scene hierarchy
|
|
FileName - Group exported assets by source file name
|
|
Example: "-g containerFull"
|
|
|
|
-f, --filename-format <value> Specify the file name format for exported assets
|
|
<Value: assetName(default) | assetName_pathID | pathID>
|
|
AssetName - Asset file names will look like "assetName.extension"
|
|
AssetName_pathID - Asset file names will look like "assetName @pathID.extension"
|
|
PathID - Asset file names will look like "pathID.extension"
|
|
Example: "-f assetName_pathID"
|
|
|
|
-o, --output <path> Specify path to the output folder
|
|
If path isn't specified, 'ASExport' folder will be created in the program's work folder
|
|
|
|
-r, --overwrite-existing (Flag) If specified, Studio will overwrite existing files during asset export/dump
|
|
|
|
-h, --help Display help and exit
|
|
|
|
Logger Options:
|
|
--log-level <value> Specify the log level
|
|
<Value: verbose | debug | info(default) | warning | error>
|
|
Example: "--log-level warning"
|
|
|
|
--log-output <value> Specify the log output
|
|
<Value: console(default) | file | both>
|
|
Example: "--log-output both"
|
|
|
|
Convert Options:
|
|
--image-format <value> Specify the format for converting image assets
|
|
<Value: none | jpg | png(default) | bmp | tga | webp>
|
|
None - Do not convert images and export them as texture data (.tex)
|
|
Example: "--image-format jpg"
|
|
|
|
--audio-format <value> Specify the format for converting FMOD audio assets
|
|
<Value: none | wav(default)>
|
|
None - Do not convert FMOD audios and export them in their own format
|
|
Example: "--audio-format wav"
|
|
|
|
Live2D Options:
|
|
--l2d-group-option <value> Specify the way in which exported models should be grouped
|
|
<Value: container(default) | fileName | modelName>
|
|
Container - Group exported models by container path
|
|
FileName - Group exported models by source file name
|
|
ModelName - Group exported models by model name
|
|
Example: "--l2d-group-option modelName"
|
|
|
|
--l2d-motion-mode <value> Specify Live2D motion export mode
|
|
<Value: monoBehaviour(default) | animationClip>
|
|
MonoBehaviour - Try to export motions from MonoBehaviour Fade motions
|
|
If no Fade motions are found, the AnimationClip method will be used
|
|
AnimationClip - Try to export motions using AnimationClip assets
|
|
Example: "--l2d-motion-mode animationClip"
|
|
|
|
--l2d-search-by-filename (Flag) If specified, Studio will search for model-related Live2D assets by file name
|
|
rather than by container
|
|
(Preferred option if all l2d assets of a single model are stored in a single file
|
|
or containers are obfuscated)
|
|
|
|
--l2d-force-bezier (Flag) If specified, Linear motion segments will be calculated as Bezier segments
|
|
(May help if the exported motions look jerky/not smooth enough)
|
|
|
|
FBX Options:
|
|
--fbx-scale-factor <value> Specify the FBX Scale Factor
|
|
<Value: float number from 0 to 100 (default=1)>
|
|
Example: "--fbx-scale-factor 50"
|
|
|
|
--fbx-bone-size <value> Specify the FBX Bone Size
|
|
<Value: integer number from 0 to 100 (default=10)>
|
|
Example: "--fbx-bone-size 10"
|
|
|
|
--fbx-animation Specify the FBX animation export mode
|
|
<Value: auto(default) | skip | all>
|
|
Auto - Search for model-related animations and export model with them
|
|
Skip - Don't export animations
|
|
All - Try to bind all loaded animations to each loaded model
|
|
Example: "--fbx-animation skip"
|
|
|
|
--fbx-uvs-as-diffuse (Flag) If specified, Studio will export all UVs as Diffuse maps.
|
|
Can be useful if you cannot find some UVs after exporting (e.g. in Blender)
|
|
(But can also cause some bugs with UVs)
|
|
|
|
Filter Options:
|
|
--filter-by-name <text> Specify the name or regexp by which assets should be filtered
|
|
*To specify multiple names write them separated by ',' or ';' without spaces
|
|
Example: "--filter-by-name char" or "--filter-by-name char,bg"
|
|
|
|
--filter-by-container <text> Specify the container or regexp by which assets should be filtered
|
|
*To specify multiple containers write them separated by ',' or ';' without spaces
|
|
Example: "--filter-by-container arts" or "--filter-by-container arts,icons"
|
|
|
|
--filter-by-pathid <text> Specify the PathID by which assets should be filtered
|
|
*To specify multiple PathIDs write them separated by ',' or ';' without spaces
|
|
Example: "--filter-by-pathid 7238605633795851352,-2430306240205277265"
|
|
|
|
--filter-by-text <text> Specify the text or regexp by which assets should be filtered
|
|
Looks for assets that contain the specified text in their names or containers
|
|
*To specify multiple values write them separated by ',' or ';' without spaces
|
|
Example: "--filter-by-text portrait" or "--filter-by-text portrait,art"
|
|
|
|
--filter-with-regex (Flag) If specified, the filter options will handle the specified text
|
|
as a regular expression (doesn't apply to --filter-by-pathid)
|
|
|
|
Advanced Options:
|
|
--blockinfo-comp <value> Specify the compression type of bundle's blockInfo data
|
|
<Value: auto(default) | zstd | oodle | lz4 | lzma>
|
|
Auto - Use compression type specified in an asset bundle
|
|
Zstd - Try to decompress as zstd archive
|
|
Oodle - Try to decompress as oodle archive
|
|
Lz4 - Try to decompress as lz4/lz4hc archive
|
|
Lzma - Try to decompress as lzma archive
|
|
Example: "--blockinfo-comp lz4"
|
|
|
|
--block-comp <value> Specify the compression type of bundle's block data
|
|
<Value: auto(default) | zstd | oodle | lz4 | lzma>
|
|
Auto - Use compression type specified in an asset bundle
|
|
Zstd - Try to decompress as zstd archive
|
|
Oodle - Try to decompress as oodle archive
|
|
Lz4 - Try to decompress as lz4/lz4hc archive
|
|
Lzma - Try to decompress as lzma archive
|
|
Example: "--block-comp zstd"
|
|
|
|
--max-export-tasks <value> Specify the number of parallel tasks for asset export
|
|
<Value: integer number from 1 to max number of cores (default=max)>
|
|
Max - Number of cores in your CPU
|
|
Example: "--max-export-tasks 8"
|
|
|
|
--export-asset-list <value> Specify the format in which you want to export asset list
|
|
<Value: none(default) | xml>
|
|
None - Do not export asset list
|
|
Example: "--export-asset-list xml"
|
|
|
|
--assembly-folder <path> Specify the path to the assembly folder
|
|
|
|
--unity-version <text> Specify Unity version
|
|
Example: "--unity-version 2017.4.39f1"
|
|
|
|
--decompress-to-disk (Flag) If not specified, only bundles larger than 2GB will be decompressed to disk
|
|
instead of RAM
|
|
|
|
--not-restore-extension (Flag) If specified, Studio will not try to use/restore original TextAsset extension,
|
|
and will just export all TextAssets with the ".txt" extension
|
|
|
|
--ignore-typetree (Flag) If specified, Studio will not try to parse assets at load time
|
|
using their type tree
|
|
|
|
--load-all (Flag) If specified, Studio will load assets of all types
|
|
(Only for Dump, Info and ExportRaw modes)
|
|
```
|