AssetStudio/AssetStudioCLI
2023-09-24 15:41:21 +03:00
..
Components Merge branch 'AssetStudioMod' into ArknightsStudio 2023-09-24 15:40:23 +03:00
Libraries [CLI] Add FBX native libs (Linux, Mac) 2023-09-05 00:48:44 +03:00
Options Merge branch 'AssetStudioMod' into ArknightsStudio 2023-09-24 15:40:23 +03:00
AssetStudioCLI.csproj Merge branch 'AssetStudioMod' into ArknightsStudio 2023-09-24 15:40:23 +03:00
CLILogger.cs Minor fixes 2023-08-26 03:22:19 +03:00
Exporter.cs Merge branch 'AssetStudioMod' into ArknightsStudio 2023-09-24 15:40:23 +03:00
Program.cs [CLI] Add --filter-by-name support for fbx export mode 2023-09-08 01:45:25 +03:00
ReadMe.md Update readme files 2023-09-24 15:41:21 +03:00
Studio.cs Merge branch 'AssetStudioMod' into ArknightsStudio 2023-09-24 15:40:23 +03:00

ArknightsStudioCLI

CLI version of ArknightsStudio.

  • Supported asset types for export: Texture2D, Sprite, AkPortraitSprite, TextAsset, MonoBehaviour, Font, Shader, MovieTexture, AudioClip, VideoClip, Mesh.
  • There are no plans to add support for AnimationClip, Animator for now.

Usage

ArknightsStudioCLI <input path to asset file/folder> [-m, --mode <value>]
                      [-t, --asset-type <value(s)>] [-g, --group-option <value>]
                      [-o, --output <path>] [-h, --help]
                      [--log-level <value>] [--log-output <value>]
                      [--image-format <value>] [--audio-format <value>]
                      [--fbx-scale-factor <value>] [--fbx-bone-size <value>]
                      [--filter-by-name <text>] [--filter-by-container <text>]
                      [--filter-by-pathid <text>] [--filter-by-text <text>]
                      [--spritealpha-mode <value>] [--alphatex-resampler <value>]
                      [--shadow-gamma <value>] [--original-avg-names]
                      [--add-aliases] [--export-asset-list <value>]
                      [--assembly-folder <path>] [--unity-version <text>]
                      [--not-restore-extension] [--load-all]


General Options:
  -m, --mode <value>            Specify working mode
                                <Value: export(default) | exportRaw | dump | info | live2d | splitObjects>
                                Export - Exports converted assets
                                ExportRaw - Exports raw data
                                Dump - Makes asset dumps
                                Info - Loads file(s), shows the number of available for export assets and exits
                                Live2D - Exports Live2D Cubism 3 models
                                SplitObjects - Exports split objects (fbx)
                                Example: "-m info"

  -t, --asset-type <value(s)>   Specify asset type(s) to export
                                <Value(s): tex2d, sprite, akPortrait, textAsset, monoBehaviour, font, shader,
                                movieTexture, audio, video, mesh | all(default)>
                                All - export all asset types, which are 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>
                                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)
                                Filename - Group exported assets by source file name
                                Example: "-g container"

  -o, --output <path>           Specify path to the output folder
                                If path isn't specifyed, 'ASExport' folder will be created in the program's work folder

  -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 audio assets
                                <Value: none | wav(default)>
                                None - Do not convert audios and export them in their own format
                                Example: "--audio-format wav"

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"

Filter Options:
  --filter-by-name <text>       Specify the name 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 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 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"


Arknights Options:
  --spritealpha-mode <value>    Specify the mode in which you want to export sprites with alpha texture
                                <Value: none | internalOnly | searchExternal(default)>
                                None - Export sprites without alpha texture applied
                                InternalOnly - Export sprites with internal alpha texture applied (if exist)
                                SearchExternal - Export sprites with internal alpha texture applied,
                                and in case it doesn't exist, Studio will try to find an external alpha texture
                                Example: "--spritealpha-mode internalOnly"

  --alphatex-resampler <value>  Specify the alpha texture upscale algorithm for 2048x2048 sprites
                                <Value: nearest | bilinear | bicubic | mitchell(default) | spline | welch>
                                Mitchell - Mitchell Netravali algorithm. Yields good equilibrium between
                                sharpness and smoothness (produces less artifacts than bicubic in the current use case)
                                Spline - Similar to Mitchell Netravali but yielding smoother results
                                Welch - A high speed algorithm that delivers very sharpened results
                                Example: "--alphatex-resampler bicubic"

  --shadow-gamma <value>        Specify the gamma correction of semi-transparent shadow for 2048x2048 sprites
                                <Value: integer number from -5 to 5 (default=2)>
                                <0 - Make the shadow darker
                                0 - Do not change the brightness of the shadow
                                >0 - Make the shadow lighter
                                Example: "--shadow-gamma 0"

  --original-avg-names          (Flag) If specified, names of avg character sprites will not be fixed

  --add-aliases                 (Flag) If specified, aliases will be added to avg character sprite names (if exist)

Advanced Options:
  --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"

  --not-restore-extension       (Flag) If specified, Studio will not try to use/restore original TextAsset
                                extension name, and will just export all TextAssets with the ".txt" extension

  --load-all                    (Flag) If specified, Studio will load assets of all types
                                (Only for Dump, Info and ExportRaw modes)