A Live2D Cubism model conversion toolbox: convert runtime models (.moc3) to Adobe Photoshop (PSD) files, or restore them to editable Cubism Editor projects (.cmo3).
PSD export renders every drawable (art mesh) individually into its own layer, preserving the original Part group hierarchy and names. cmo3 generation restores all geometry, deformers, parameters and physics from the moc3 binary — for cases where the source project is lost and only runtime files remain.
- Open
.model3.jsonor.moc3files (drag & drop or file dialog; opening a moc3 directly auto-generates the config) - Live preview with sliders for all model parameters
- Play motions, switch expressions, toggle auto eye-blink / breathing, Pose switching
- Model structure tree (Part / ArtMesh / Deformer hierarchy) with click-to-highlight
- Texture atlas viewer: zoom/pan, UV wireframe overlay, click the atlas to locate an ArtMesh (three-way linkage with the tree and main view), PNG export
- Two layer modes:
- All layers — every drawable flattened in render order
- Grouped — Part hierarchy preserved as PSD layer groups
- Parameter snapshot export — export the pose currently set via sliders, with automatic effects disabled
- Texture extraction mode — extract original textures without deformation, for high-quality asset ripping
- Cubism-importable mode — embeds an sRGB ICC profile, Unicode layer names (luni) and deduplicated layer names, so the exported PSD can be imported back into Cubism Editor
- Batch export: pick a folder, all models are converted automatically; failed files are listed individually
The "Export cmo3 project" toolbar action (Ctrl+E) restores the current model as a Cubism Editor 5.0 project:
- Recoverable: mesh geometry (vertices/UVs/triangles), keyform deformations, Warp/Rotation deformers, Part hierarchy, parameter definitions and bindings, clipping masks, blend modes, Glue, physics (physics3.json), display names (cdi3.json)
- Not recoverable (absent from moc3): original PSD association, deformer path organization, artist notes and other editor metadata
- Textures are rebuilt in "single PSD document + one layer per mesh" mode (MODEL_IMAGE); artwork can be replaced directly in the Editor and re-exported to moc3
Input: model.moc3 + textures/*.png [+ physics3.json + cdi3.json]
Output: model.cmo3 (CAFF container: main.xml + one PNG per mesh)
Requirements:
- Windows x64
- Qt 6.x (modules: core gui opengl openglwidgets core5compat widgets gui-private network)
- MSVC compiler
- C++17
Compile:
.\build.ps1 # Release build
.\build.ps1 -Clean # Clean rebuild
.\build.ps1 -Configuration DebugIf Qt is not in the default location, specify qmake:
.\build.ps1 -QMakePath "C:\Qt\6.10.0\msvc2022_64\bin\qmake.exe" -MakeTool nmake -CleanOutput: softwareEnv/physicsV1/live2d2psd.exe
| Library | Purpose |
|---|---|
| Live2D Cubism SDK | Model loading, parameter control, rendering |
| Qt 6 | GUI framework |
| OpenCV 4.10 | Image processing |
| psd_sdk | PSD file I/O (extended with luni/ICC support) |
| miniz | ZIP compression for the cmo3 CAFF container |
| stb_image | Image loading |
ui/ UI layer (main window, panels, dialogs)
opengl/ OpenGL offscreen rendering + PSD export pipeline + texture extraction
live2d/ Live2D SDK application layer
framework/ Live2D Cubism Native Framework (modified)
live2dstruct/ MOC3 binary parser + hierarchy tree builder
psd/ PSD file writer
cmo3/ moc3 → cmo3 project generator (CAFF container + xs XML serialization)
edit/ Editing/drawing tools
std/ Common utilities
- Code under
framework/is based on a modified Live2D Cubism Native Framework;DrawModel()inCubismRenderer_OpenGLES2.cppis heavily changed to support per-layer PSD export. Merge manually when upgrading the SDK. - Use of the Live2D Cubism SDK is subject to its license agreement.
This project's code is released under CC BY-NC-SA 4.0.
This project is for personal research and study purposes only.
Third-party dependencies remain under their original licenses (Live2D SDK, OpenCV, Qt, etc.).
Live2D Cubism 模型转换工具箱：将运行时模型（.moc3）转换为 Adobe Photoshop（PSD）文件，或恢复为 Cubism Editor 可编辑工程（.cmo3）。
PSD 导出逐个渲染模型中的每个 drawable（art mesh），写入独立图层，保留原始 Part 分组层级结构和名称。cmo3 生成从 moc3 二进制还原全部几何、变形器、参数与物理数据，适用于丢失源工程只剩运行时文件的场景。
- 打开
.model3.json或.moc3文件（拖拽或文件对话框；moc3 直开自动生成配置） - 实时预览模型，通过滑条调整所有参数
- 播放动作、切换表情，支持自动眨眼和呼吸开关，Pose 切换
- 模型结构树查看（Part / ArtMesh / Deformer 层级），点击高亮对应网格
- 纹理图集查看：缩放/平移、UV 线框叠加、点击图集反查 ArtMesh（与结构树/主视图三方联动）、导出 PNG
- 两种图层模式：
- 全部图层 — 按渲染顺序平铺所有 drawable
- 按分组导出 — 保留 Part 层级结构为 PSD 图层组
- 参数快照导出 — 用当前滑条调整的姿态导出，禁用自动效果
- 纹理提取模式 — 直接提取原始纹理，无变形，适合高质量素材提取
- Cubism 可导入模式 — 嵌入 sRGB ICC 配置、Unicode 图层名（luni）、图层名去重，保证导出的 PSD 能再导回 Cubism Editor
- 批量导出：选择文件夹，自动遍历所有模型生成 PSD，失败文件逐个列出
工具栏"导出cmo3工程"（Ctrl+E）将当前模型恢复为 Cubism Editor 5.0 工程：
- 可恢复：网格几何（顶点/UV/三角形）、关键帧变形、Warp/Rotation 变形器、Part 层级、参数定义与绑定、裁剪蒙版、混合模式、Glue、物理设置（physics3.json）、显示名汉化（cdi3.json）
- 不可恢复（moc3 中不存在）：原始 PSD 关联、变形器路径整理、画师备注等编辑器元数据
- 贴图以"单 PSD 文档 + 每网格一图层"模式重建（MODEL_IMAGE），在 Editor 中可直接换皮再导出 moc3
输入: model.moc3 + textures/*.png [+ physics3.json + cdi3.json]
输出: model.cmo3（CAFF 容器：main.xml + 每网格 PNG）
环境要求：
- Windows x64
- Qt 6.x（需要模块：core gui opengl openglwidgets core5compat widgets gui-private network）
- MSVC 编译器
- C++17
编译：
.\build.ps1 # Release 构建
.\build.ps1 -Clean # 清理后重新构建
.\build.ps1 -Configuration Debug如果 Qt 不在默认路径，指定 qmake：
.\build.ps1 -QMakePath "C:\Qt\6.10.0\msvc2022_64\bin\qmake.exe" -MakeTool nmake -Clean输出位置：softwareEnv/physicsV1/live2d2psd.exe
| 库 | 用途 |
|---|---|
| Live2D Cubism SDK | 模型加载、参数控制、渲染 |
| Qt 6 | GUI 框架 |
| OpenCV 4.10 | 图像处理 |
| psd_sdk | PSD 文件读写（已扩展 luni/ICC 支持） |
| miniz | cmo3 CAFF 容器的 ZIP 压缩 |
| stb_image | 图像加载 |
ui/ UI 层（主窗口、面板、对话框）
opengl/ OpenGL 离屏渲染 + PSD 导出管线 + 纹理提取
live2d/ Live2D SDK 应用层封装
framework/ Live2D Cubism Native Framework（已修改）
live2dstruct/ MOC3 二进制解析器 + 层级树构建
psd/ PSD 文件写入
cmo3/ moc3 → cmo3 工程生成器（CAFF 容器 + xs XML 序列化）
edit/ 编辑/绘制工具
std/ 通用工具
framework/目录下的代码基于 Live2D Cubism Native Framework 修改，CubismRenderer_OpenGLES2.cpp中的DrawModel()有大幅改动以支持 PSD 逐层导出。升级 SDK 时需要手动合并。- Live2D Cubism SDK 使用需遵守其许可协议。
本项目代码以 CC BY-NC-SA 4.0 许可证发布。
本项目仅用于个人研究和学习目的。
第三方依赖各自遵循其原始许可证（Live2D SDK、OpenCV、Qt 等）。