CLI 实战示例 — 8 条高频命令速查

示例一：批量导出所有贴图为 WebP

AssetStudioModCLI D:\game\unpacked -t tex2d,sprite --image-format webp -g type -o D:\game\exports\textures

• -t tex2d,sprite：贴图和精灵都导；
• --image-format webp：WebP 格式；
• -g type：按类型分目录；
• -o：输出目录。

示例二：正则筛出所有角色立绘

假设角色立绘命名规则是 char_01_001_front.png 这样的格式：

AssetStudioModCLI D:\game\unpacked -t sprite --filter-by-name "~char_\d{2}_\d{3}" --image-format png -o D:\game\exports\characters

~ 前缀表示正则，\d{2} 匹配两位数字。

示例三：批量导出 Live2D 立绘

AssetStudioModCLI D:\game\unpacked -m live2d -o D:\game\exports\live2d

如果只想导包含特定关键词的角色：

AssetStudioModCLI D:\game\unpacked -m live2d --filter-by-name "miku,saber" -o D:\game\exports\live2d

示例四：splitObjects 全拆带缩放因子 10

AssetStudioModCLI D:\game\unpacked -m splitObjects --fbx-scale-factor 10 -o D:\game\exports\models

Unity 模型默认比例经常不对，试 0.01、10、100 这些值。

示例五：指定 Unity 版本 + MonoBehaviour 导出

Unity 版本字段不准时手动指定，同时喂 dummy dll：

AssetStudioModCLI D:\game\unpacked -t monobehaviour --unity-version 2022.3.20f1 --assembly-folder D:\game\il2cpp\dummy_dll --log-output both -o D:\game\exports\mono

• --unity-version：强制 Unity 版本；
• --assembly-folder：MonoBehaviour 程序集目录（Mono 后端是 Managed/，Il2Cpp 是 dummy_dll/）；
• --log-output both：同时写控制台和日志文件。

示例六：先统计再决定导什么

AssetStudioModCLI D:\game\unpacked -m info
AssetStudioModCLI D:\game\unpacked -m info -t audio --filter-by-name bgm

info 模式不导，只打印数量，适合先摸清楚资源分布。

示例七：先解压再导出（大包）

AssetStudioModCLI D:\game\obb -m extract -o D:\game\extracted
AssetStudioModCLI D:\game\extracted -t tex2d,audio -o D:\game\exports

第一步把大 AssetBundle 解压到磁盘，第二步从解压目录导——避免内存爆掉。

示例八：容器路径正则精确筛选

很多游戏的 AudioClip 名称是 hash（比如 a1b2c3d4），但容器路径是语义化的：

AssetStudioModCLI D:\game\unpacked -t audio --filter-by-container "~assets/audio/(bgm|voice)" -o D:\game\exports\audio

这条正则只导容器路径匹配 assets/audio/bgm/ 或 assets/audio/voice/ 的音频。

常见坑

• 路径有空格：把路径用双引号包起来，比如 "D:\game folder\unpacked"；
• 中文路径：AssetStudioMod CLI 支持中文路径，没问题；
• Linux/macOS：用 dotnet AssetStudioModCLI.dll 跑，不是直接执行 exe；
• 内存不够：先 extract 再 load（示例七）。