PSD2Live

オープンソースの 2D キャラクターリギング・アニメーションエディタ

レイヤー分けした PSD から動く初版を自動で組み立て、1 つのワークスペースで形の調整、ボーン、物理とシミュレーション、アニメーションまで行い、
Cubism、VTube Studio、独自ランタイム、Web、ゲームエンジン、動画へ書き出せます。

中文 · English · 한국어

ダウンロード · はじめに · ドキュメント · 更新履歴 · ロードマップ

PSD2Live は 2D キャラクターリギングの一貫したツールチェーンです。レイヤー分けした PSD からメッシュ、デフォーマ、パラメータ、モーション、物理を自動生成し、デスクトップエディタで編集を続け、Cubism、独自ランタイム p2lrt、各種汎用形式へコンパイルします。独自の評価エンジン、プロジェクト形式、分岐履歴を持ち、ワンクリック生成は出発点にすぎません。すべての編集は再生可能な記録として保存され、再生成後も有効です。

以下の画像はリポジトリ内の 2 つのサンプル PSD によるものです（膝のテストと体の動きのアニメーションは、別の脚の長いキャラクターのプロジェクトを使用）。どちらのサンプルも読み込み時に「フル」プリセットを選び、手作業の修正は加えていません。髪とスカートはベイク済みシミュレーションで動きます。テスト画像は開発ツールとコマンドラインの書き出し結果から、エディタの画面は実際のエディタウィンドウの描画フレームから作成しています。

アニメーション：モーション一覧、タイムラインとカーブ編集。プレビューとパラメータが再生位置に追従	ボーン：キャンバス上で関節を調整し、FK / IK でポーズを付ける
テクスチャ：アトラス上でタイルを配置し、レイヤーごとにテクスチャ密度を設定	スタート：プリセットを選んで PSD をドロップすればワンクリックで生成。レイアウトプロジェクトの作成や最近のプロジェクトもここから

体の角度を上下、左右、楕円の順に 1 周ずつ動かしています。髪、スカート、袖、リボンはベイク済みシミュレーションで追従し、上下動や向きの変化に遅れて揺れ、止まったあとに揺り戻します。左は各部位のピンウェイトで、1 は体に追従、0 は自由、中間値は比例して引き寄せます。

読み込むだけで頭部と顔のリグが揃います。顔の Warp、パーツの平面、髪と体の追従は、生成された 1 本のデフォーマチェーンで駆動されます。

メッシュはテクスチャの輪郭から生成され、穴、細いブリッジ、先端はそれぞれ独立した輪郭ループになります。設定は全体とレイヤー単位で調整できます。

実素材：サンプルキャラクターの長い巻き髪。輪郭が巻き毛 1 本ずつに沿う

頂点ウェイト：シミュレーションモードで同じメッシュ上に固定ウェイトを表示・ペイント（赤は固定、青は自由）

レイヤーのタグから胴体、手足、尻尾を推定し、ボーンをネイティブのデフォーマとキーフォームへベイクします。膝と肘は人の関節に沿って形づくられ、外側は膝頭が丸く出て内側は折りたたまれ、太ももの剛体部分はすねと一緒にずれません。同じプリセットモーションが異なる体型に合います。

Rust ランタイムでエディタの基準ポーズと軌跡を 1 つずつ再生しています。形状、物理、シミュレーションはすべて合格し、4 種類のファイルエンコードから同じ結果が得られます。

PSD2Live は Cubism Editor や SDK なしで動作し、Cubism の形式とは互換性を保ちます。各機能は Cubism に取り込めるかどうかで 3 段階に分かれます。

.moc3 / .cmo3 の書き出しでは、後ろの 2 区分は対象バージョン（Cubism 3.0 – 5.3）に合わせて変換され、損失レポートに記録されます。

最新版は Releases から入手できます。変更点は更新履歴（中国語）を参照してください。

1. PSD を読み込む：ファイル → 新規作成 → PSD から新規プロジェクト…（Ctrl+Shift+O）、またはウィンドウへドラッグします。読み込む前に「スタート」ページの「PSD から生成」でモデルプリセット（最小 / 標準 / フル）を選んでおくと、生成して編集を開きます。1 枚に描かれた左右のパーツ（左右の脚など）は「モデル → メッシュごとにレイヤーを分割…」で分けます。
2. 判定結果を確認：「レイヤー」表でパーツの種類、左右、差分設定を確認し、誤りはその場で修正します。
3. プレビューと調整：「プレビュー」ワークスペースで動きと物理を確認し、必要に応じて編集・リギング・アニメーション・物理演算・テクスチャの各ワークスペースで調整します。
4. 保存と書き出し：Ctrl+S で .psd2live を保存し、Ctrl+G で .moc3 / .cmo3 を書き出します。その他の形式は ファイル → 形式を指定して書き出し にあります。

自動生成の品質は主に PSD のレイヤー分けで決まります。

• 白目、虹彩、上まつげを分け、まぶたに隠れる部分の虹彩も残す。
• 口を開けた素材を用意する（または上の歯、下の歯、舌を分ける）。
• 前髪と後ろ髪を分け、隠れる部分に余白を残す。
• 体はおおむね直立させ、レイヤー効果と文字は事前にラスタライズする。

命名表の全体は PSD の準備と命名にあります。判定できなかったレイヤーも残り、画面で種類を指定できます。

Ctrl+G で Cubism 形式を書き出し、対象バージョンは 3.0 – 5.3（既定 5.0）から選べます。その他は ファイル → 形式を指定して書き出し にあります。書き出しターゲット（中国語）を参照してください。

内蔵レンダラーは公式 SDK なしで動作します。Cubism ネイティブプレビューは任意で、公式ランタイムの描画と物理との比較に使えます。

runtime/ は書き出した .p2lrt モデルを再生するオープンソース（MIT）の Rust ランタイムです。エディタのソフトウェアプレビューも同じライブラリで評価しています。

Web プレイヤー（WebAssembly + WebGL）

Godot 4 ノード

形式と評価規則はランタイムと .p2lrt 2.0 形式（中国語）を参照してください。

1. MCP サーバーは既定で有効で、PSD2Live の起動とともに http://127.0.0.1:23871/mcp で待ち受けます。設定 → MCP（タイトルバー右端の歯車）で無効にしたり、ポート、アクセストークン、公開するツールセット（既定はコンパクト）を設定したりできます。アクセストークンはローカルのユーザー設定（Java Preferences）に平文で保存されます。
2. 使用するホストに合ったコマンドまたは設定（Claude Code、Codex、汎用 JSON）をコピーします。Stdio のみのホストはリポジトリ直下の mcp_proxy.py を使います。
3. Agent にはまず workspace_overview でプロジェクトの概要を、workspace_inspect で個々のオブジェクトを読ませてください。ツールとして公開されていない操作は workspace_list_operations で探し、workspace_call で呼び出します。

workspace_apply_edits は複数の編集をアトミックに（すべて成功するか、何も変えないか）確定し、workspace_preview_edits で事前に試行実行できます。リクエストと例は MCP リファレンス（中国語）にあります。

JDK 21 が必要で、Gradle はリポジトリ同梱のラッパーを使います。Rust（cargo、rustc 1.87 以降）があれば Rust ランタイムも同時にビルドします。cargo がない場合や rustc が古い場合はLinux ではまず、同じ runtime/ のソースから CI がビルドしたライブラリをダウンロードします（-Ppsd2live.prebuiltRuntime=false で無効化）。入手できなければ通知を出してスキップし、エディタは内蔵の評価器を使います（rustup update でビルドできるようになります）。macOS 13 以降では ./gradlew packageDmg でランタイム同梱の DMG を作れ、JBR を別途入れる必要はありません。詳しくは開発ガイドを参照してください。

# GUI を起動（Windows：.\gradlew.bat run または run-gui.bat）
./gradlew run

# コマンドラインで PSD からモデルを生成
python tools/examples/fetch.py --case tml
./gradlew run --args="--input examples/tml/psd-input/tml.psd --output build/example-output"

# プロジェクトを別の形式で書き出す（例：GIF）
./gradlew run --args="export model.psd2live --target gif --set clip=Nod"

# テスト / 現在のプラットフォーム向けパッケージ
./gradlew test
./gradlew packageDistributionForCurrentOS

ソースビルドは既定で内蔵レンダラーを使います。公式 Cubism SDK は各自で入手し、ブリッジライブラリを別途ビルドしてください。CLI の全オプション、パッケージング、ネイティブプレビューのビルドは開発とコマンドラインにあります。

キャンバス編集、ボーン、揺れ、物理、シミュレーション、テクスチャ高解像度化のガイドと、書き出し・ランタイムのリファレンスは現在中国語のみです。ドキュメント一覧から参照できます。サンプル PSD と出力は examples に、今後の予定はロードマップ（中国語）にあります。

Issue、再現できる PSD、ドキュメントの修正、コードの改善を歓迎します。

• 不具合報告：バージョン、OS、再現手順、期待する結果と実際の結果、ログパネルの関連記録を添えてください。
• コード：変更に関係するテスト（./gradlew test）を実行してください。新しい編集機能はプロジェクトに保存され、再度開いたときに再生できる必要があります。詳しくは開発を参照してください。
• Agent の事例：ホスト、モデル、やり直し回数、コストも記録してください。形式は実測記録に従います。

アプリケーション全体は GPL-3.0 で公開しています。各モジュールの LICENSE とモジュール一覧（中国語）を参照してください。サードパーティ製コンポーネントは THIRD_PARTY_NOTICES.md、サンプル素材の利用条件は各説明を参照してください。

_{PSD2Live は独立したプロジェクトであり、Live2D Inc. との提携や後援の関係はありません。本リポジトリは Live2D Cubism SDK の独自コンポーネントを含まず、配布もしません。Live2D および Cubism は Live2D Inc. の商標です。}