Live2D Cubism 模型导出 — AssetStudioMod 独有、从 MonoBehaviour 还原完整模型目录

Live2D 是什么

Live2D Cubism 是一种 2D 立绘动画技术——一张平面的立绘图被切分成几十个部件（眼睛、嘴巴、头发、衣服），每个部件可以独立变形、旋转、透明，组合起来实现"会动"的立绘效果。很多二次元游戏的角色立绘和 Live2D 交互都是用这套技术做的。

Unity 里的 Live2D 资源

Live2D 模型在 Unity 里以 MonoBehaviour（类型名 CubismMoc） 形式挂载到 GameObject 上。AssetBundle 里包含：

.moc3 文件：Live2D Cubism 模型核心（网格 + 变形参数 + DrawOrder）；
.model3.json：模型配置（引用的 moc3、贴图路径、参数映射）；
若干 Texture2D：模型用的贴图（立绘底图、alpha mask）；
AnimationClip：Live2D 的 Motion 动画（挥手、说话表情等）。

原版 AssetStudio 看不到这些文件的关联关系——它只把 CubismMoc 当作普通 MonoBehaviour，Dump 出来是一堆二进制。AssetStudioMod 专门实现了 Live2D 提取逻辑，能把这些碎片拼成完整的 Live2D 模型目录。

GUI 方式导出 Live2D

Asset List 里 Filter Type 找到 CubismMoc（它显示为 MonoBehaviour 类型）；
选中一个 CubismMoc → 右键 → Export as Live2D Model；
弹窗里可以选择：

导出完整模型（默认）；
只导出模型 + 选中的 Motion 动画；
模型 + 选中的 Fade 动画（过渡动画）；
模型 + 选中的 Fade Motion List（批量导出多个 Fade 动画）；

导出结果是标准的 Live2D 模型目录，可以直接用 Live2D Cubism Editor 打开、或者喂给 Live2D Viewer / VTube Studio / OBS Live2D 插件等工具。

CLI 方式导出 Live2D

AssetStudioMod CLI 的 -m live2d 模式专门用于批量导出 Live2D 模型：

AssetStudioModCLI <asset folder path> -m live2d -o <output folder>

Live2D 模式只支持 --filter-by-name 和 --filter-by-container 两种筛选。例如：

AssetStudioModCLI <path> -m live2d --filter-by-name live2d -o <output>

导出后的验证

导出来的 Live2D 模型目录应该包含：

模型名/
├── xxx.moc3              ← Live2D 模型核心
├── xxx.model3.json       ← 模型配置（引用贴图、参数表）
├── texture_xxx.png       ← 贴图（可能多张）
└── motions/
    ├── xxx_motion1.model3.json
    └── xxx_motion2.model3.json

用 Live2D Cubism Editor 或 Live2D Viewer 打开，确认模型能正常显示、动画能播放。

常见问题

导出的 Live2D 模型打不开

排查方向：

Unity 版本 → AssetStudioMod 的 Unity 版本支持 1.7 – 6000.2，超出范围可能解析失败；
Live2D Cubism SDK 版本 → 模型文件格式可能跟你本地的 Cubism Editor 版本不兼容（Live2D 也在迭代）；
贴图丢失 → 确认 Load folder 加载了完整项目（贴图可能散在别的 AssetBundle 里）。

只导出了部分部件

部分 Live2D 模型把不同部件的贴图拆散在多个 AssetBundle 里，AssetStudioMod 可能只拿到了当前 CubismMoc 引用的那部分贴图。解决方法是用 Load folder 加载完整游戏数据目录。

导出没有 Live2D 选项

确认你用的是 AssetStudioMod，原版 AssetStudio 没有 Live2D 导出功能。另外检查 Asset List 里有没有 CubismMoc 条目——如果列表里没有，说明这个游戏没用 Live2D 或 CubismMoc 类名不一样。