mcpField
L
live2d-from-art

live2d-from-art

github.com/fifteen42Creative & media1363 installsUpdated 6w ago
Repository

About live2d-from-art

live2d-from-art is a skill for turning character artwork into an interactive Live2D model for web, VTube Studio, or an editable Cubism project. It guides asset inspection, model construction, visual checks, motion refinement, and delivery, distinguishing technical loading from visual acceptance.

Key features

  1. 01Choose a workflow based on available art assets
  2. 02Reassemble and inspect character parts
  3. 03Build models incrementally with rollback points
  4. 04Validate MOC3 rendering in a web viewer
  5. 05Refine motion and check visual artifacts
  6. 06Check deliverables and target-platform acceptance

Use cases

  1. 01Preparing a model from a layered PNG or PSD
  2. 02Separating and reconstructing parts from a single image
  3. 03Checking a model's neutral pose and facial alignment
  4. 04Verifying a VTube Studio delivery

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/fifteen42/live2d-from-art --skill live2d-from-art

After installing, type/live2d-from-artin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.gitignore
README.md
README.zh-CN.md
agents/
openai.yaml
assets/worked-example/character/
extract_reference.py
export_psd.py
index.html
build_moc.py
compare_neutral.py
package.py
prepare_expression_hair.py
preview.js
prepare_eyes.py
validate_native.py
prepare_mouth.py
rebuild.py
validate.cjs
assets/worked-example/tooling/py-moc3/
LICENSE
assets/worked-example/tooling/py-moc3/src/moc3/
__main__.py
__init__.py
_core.py
references/
worked-example.md
validation.md
artwork.md
direct-moc3.md
motion-and-preview.md
scripts/
check_runtime.py

Details

From the project README

从原画制作可交互 Live2D

目标是保留角色辨识度并让动作可信。可加载、会动、好看是三个不同验收层级,分别报告。过去案例曾通过结构检查但因歪眼、拼接和持续摇晃被用户否定;不能用技术测试替代画面判断。

选择路径

先检查用户已有素材和项目,确定目标是网页、VTube Studio(VTS)、还是可继续编辑的 Cubism 工程。复用已有原图、授权素材和项目约定,不自行换脸或扩大到 TTS/Agent 平台。

  • 有成熟模型:先修现有资源和参数映射,不重做拆图。
  • 有 PSD/分层 PNG:检查默认拼合,再做网格与形变。
  • 单张图片:先保真拆件和遮挡补绘。生图工具可辅助局部补绘,不能把一张“部件展示图”直接当作已对齐的建模素材。
  • 用户要求不用 Cubism Editor:可采用本 Skill 的实验性 MOC3 代码路线。其局限及格式细节见 直接建模。不要把它描述成官方编译器或通用一键转换器。

工作顺序

  1. 建立基准:保存不可覆盖的原图、画布、透明通道、部件清单和检查点。先读 素材处理。明确正脸、转脸范围与可见动作,分辨率沿用真实素材质量,放大不等于新增细节。
  2. 静态重组:将部件按坐标和层级拼回原图,解决眼形、眉形、脸宽、发际线、领口及接缝。默认姿态像原图后再加动作。
  3. 模型构造:先静态 MOC3 加载,再逐个增加眼、嘴、眉、头、身体和发丝参数;各阶段保留可回退版本。读 直接建模。
  4. 网页验证:用实际 Cubism Core 渲染目标 MOC3,原图并排、同尺度、支持脸部放大、参数滑块和复位。读 动作与网页。
  5. 动作润色:先单参数,后组合;检查遮挡、拉伸、图层贯穿及姿态停顿。待机不能用持续摆动掩盖模型问题。用户说“像鬼”“纸片”“歪眼”时,先停自动动作、回到中性姿态,定位后再演示。
  6. 交付:按 验收与交付 检查运行包、分层源文件、制作代码与预览。区分已测平台与未测平台;用户要求 VTS 时实际加载验收,网页通过不能冒充 VTS 通过。

可复用资源

  • 本次案例与代码导航:原项目位置、复建顺序、已验证环境、哪些常量必须按新角色改写。
  • assets/worked-example/:实际使用的制作脚本、网页和 MIT 序列化库快照。是需要适配的案例,不含原画、生成补绘、专有 Core 或其他 vendor 库,不是开箱即用工程。
  • scripts/check_runtime.py MODEL.model3.json:检查模型清单引用、纹理/MOC 文件存在性和 JSON 可解析性。不会证明 MOC 二进制有效或画面好看。

不要覆盖唯一原图;无需为每个可逆调整重复询问用户。涉及生成图片时使用当前环境可用的图像工具及其规范;没有图像工具时说明所缺补绘,继续能独立完成的代码和结构工作。

Comments

Markdown supported