mcpField
L
live2d-from-art

live2d-from-art

github.com/fifteen42クリエイティブ・メディア1363 回インストール6 週間前に更新
リポジトリ

live2d-from-art について

live2d-from-artは、キャラクター原画からインタラクティブなLive2Dモデルを作るスキルです。Web、VTube Studio、編集可能なCubismプロジェクトに対応し、素材確認から動作調整までを案内します。読み込み確認と見た目の評価を分けて扱います。

主な機能

  1. 01素材に応じた制作手順の選択
  2. 02パーツの再構成と外観の確認
  3. 03段階的なモデル構築と復元ポイント
  4. 04WebビューアでのMOC3描画検証
  5. 05動作の調整と表示上の問題確認
  6. 06成果物と対象環境での受け入れ確認

活用シーン

  1. 01レイヤー付きPNGやPSDからのモデル制作
  2. 02単一画像からのパーツ分割と再構成
  3. 03モデルの標準姿勢と顔の位置合わせ確認
  4. 04VTube Studio向け成果物の検証

インストール

コマンドをコピーしてターミナルで実行します。

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

インストール後、Claude Code で/live2d-from-artを入力して読み込まれたか確認します。

同梱ファイル

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

詳細

プロジェクトの 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 二进制有效或画面好看。

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

コメント