PSD2Live – オープンソース 2D キャラクター リギング & アニメーション スイート

機能概要（平易な言葉で）

• レイヤー化された Photoshop ファイル（PSD）をアニメーション 2D キャラクターに変換 – ツールはレイヤー階層を読み取り、メッシュを作成し、ボーン、物理、および一連のデフォルトモーション（アイドル、まばたき、うなずき、髪の揺れなど）を作成します。
• これらはすべてデスクトップエディター内で行われ、メッシュの微調整、ボーンの編集、ペイント、物理の設定、タイムラインでのアニメーションが可能です。
• 満足したら、プロジェクトをエクスポートできます。
  • Live2D Cubism ファイル（.moc3/.cmo3）– Cubism Editor、VTube Studio、ゲームなどで使用可能。
  • オープンソースの Rust ランタイム（p2lrt）– C/C++、.NET、Unity、Godot、Android から呼び出し可能。WebAssembly を介してブラウザーで直接実行も可能。
  • ビデオまたは画像シーケンス、Spine/DragonBones/glTF（実験的）、およびプレーンな PSD スナップショット。

対象ユーザー

ユーザータイプ	PSD2Live が提供するもの
完全な初心者	PSD レイヤーの命名規則に従い、インポート → プリセット をクリックすると、数分でアイドル、まばたき、うなずき、髪の物理を備えたキャラクターが完成 – VTube Studio や Web ページですぐに使用できます。
AI 支援ワークフローファン	ローカル MCP サービスは、AI エージェント（Claude、Codex など）がプロジェクトを読み取りまたは変更するために呼び出せる 180 以上のコマンドを公開し、完全な元に戻す履歴を備えています。
経験豊富なリガー	自動メッシュ、ボーンチェーン、顔のパラメータ、物理が生成され、手動で編集できます。すべての編集は再生可能なコマンドとして保存されるため、再生成しても作業が失われることはありません。
オープンソースのみを求める人	エディターと Rust ランタイムはどちらも GPL-3.0 / MIT ライセンスであり、編集やプレビューに Live2D の独自 SDK に依存しません。
Cubism を超えた機能が必要な人	組み込みの 2D 布＆髪シミュレーション、IK、自動スケルトン生成 – エクスポート時に Cubism 互換ファイルにベイクされます。
独自アプリへの統合	p2lrt ランタイム（C ABI、.NET、Android、WebAssembly、Godot 4 ノード）を使用して、エクスポートされた .p2lrt モデルを直接ロードします。

主要コンポーネント

モジュール	主な機能
自動生成	中国語/英語/日本語/韓国語のレイヤー名を検出し、アダプティブメッシュ、頭部-身体変形チェーン、顔のパラメータ、デフォルトアクション、髪/布の物理を作成します。
キャンバスエディター	7 つのインタラクションモード（選択、変形、編集、シミュレート、ボーン、ペイント、プレビュー）。ツールには、ワープ/回転ブラシ、メッシュトポロジ編集、レイヤー分割/結合、接着が含まれます。
スケルトン＆シミュレーション	FK/IK を備えた自動生成スケルトン、XPBD 布＆髪シミュレーション。エクスポート時にすべてネイティブ Cubism 構造にベイクされます。
アニメーション＆物理	タイムライン、キーフレーム、カーブ、ビジュアル振り子エディター。評価は Cubism Native Framework と一致します。
テクスチャ処理	テクスチャアトラスパッキング、レイヤーごとの密度、オプションの 2×/4× アップスケーリング。
コンパイル＆エクスポート	1 つの中立 IR がすべてのターゲットにコンパイルされます。損失レポートは、何をベイクまたはドロップする必要があったかを示します。
p2lrt ランタイム	オープンソース Rust エンジン：C ABI、ソフトウェアレンダラー、WebAssembly プレーヤー、Godot 4 ノード、.NET/Android バインディング。エディターと同一のポーズごとの評価を保証します。
エージェント（MCP）サービス	ローカル HTTP サービス（http://127.0.0.1:23871/mcp）は、エージェントがワークスペースを照会し、操作を一覧表示し、アトミック編集を適用するための豊富な API を公開します。

Live2D Cubism との互換性

• 依存関係なし – エディターは Cubism SDK なしで動作します。
• 互換性レベル：
  1. ロスレス – Cubism がすでにサポートしている機能（メッシュ、パラメータ、物理、アクション）。
  2. ベイク – Cubism にない機能（IK、布シミュレーション、スイング生成）は、キーシェイプまたはパラメータにベイクされます。
  3. ランタイムのみ – 将来の機能（ダイナミックライティング、スタイライズドレンダリング）は、オープンソースランタイムのみが使用できます。
• エクスポートされた .moc3/.cmo3 ファイルにはベイクされたデータが含まれているため、結果のモデルは Cubism Editor、VTube Studio などで動作します。

クイックスタート（簡単な手順）

1. インポート PSD を ファイル → インポート → PSD から（またはドラッグ＆ドロップ）でインポートします。プリセット（最小 / デフォルト / フル）を選択し、必要に応じてグリッドを共有するレイヤーを分割します。
2. 確認 テーブルで自動検出されたレイヤータイプを確認し、間違いを修正します。
3. プレビュー 生成されたアクションと物理をプレビューします。他のワークスペースに切り替えて、メッシュ、ボーン、アニメーション、テクスチャを微調整します。
4. 保存 プロジェクトを .psd2live として保存します（元の PSD、設定、完全な編集履歴をキャプチャ）。
5. エクスポート Ctrl+G で Cubism（.moc3/.cmo3）にエクスポートするか、ファイル → エクスポート で他の形式（Web、Godot、ビデオなど）にエクスポートします。

プラットフォームとインストール

• Windows 10/11（x64 および ARM64） – ポータブル ZIP またはインストーラー。Java ランタイムとオプションの ffmpeg をバンドル。
• Linux（x86_64 および arm64） – .deb または tar.gz。X11/GLX が必要（XWayland は動作します）。macOS 用のネイティブパッケージはまだありません – JDK 21 をインストールした後、ソースから実行します。
• ランタイム – 最新の Rust ツールチェーンが存在する場合、Rust p2lrt ライブラリが自動的にビルドされます。それ以外の場合は、プリビルドバイナリがダウンロードされます。

ソースからのビルド

# GUI を実行（Gradle wrapper）
./gradlew run
# CLI：PSD から直接モデルを生成
./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

JDK 21 が必要です。Rust はオプションですが、ネイティブランタイムをビルドするために必要です。

ライセンス

• アプリケーションおよび Cubism 関連のエクスポートコード – GPL-3.0。
• ニュートラル IR、コンパイルフレームワーク、Rust ランタイム – MIT。独立して再利用できます。

---

PSD2Live は独立したプロジェクトであり、Live2D Inc. とは提携していません。