メインコンテンツまでスキップ

V2 カスタムモデル（Cubism 4+）の使い方

このページは V2（Cubism 4+ / 5）モデル専用です。 22 / 33 / Pio / Tia などの古いモデルは V1 で動き、課金は不要です。V1 モデルの 2 通りの使い方 を参照してください。

1. まず課金​

V2 は Live2D Cubism 4+ Web SDK のローダーを使います。Live2D 株式会社はサードパーティの拡張性アプリが Cubism 4+ を使う際に商業契約の締結を求めており、本プロジェクトの作者は長期契約を結び、その要件に従って正規版の Cubism Core を配布しています。そのためこのパイプラインはサイト単位の一回払いライセンス料がかかります。

  1. www.live2dweb.com でアカウント登録と支払いを完了します。
  2. WordPress 管理画面でログイン状態を維持 します（プラグインが live2dweb.com に対してライセンス検証できるように）。

未課金 / 未ログインの状態では、「ワークショップ API タイプ」の カスタム オプションは無効化されます。

2. V2 モデルファイルを準備​

V2 モデルは Cubism 4+ がエクスポートしたものです。マニフェストは *.model3.json、本体は *.moc3 で、テクスチャ・モーション・表情などが含まれます。

マニフェスト要件​

  • マニフェスト名は通常 {モデル名}.model3.json です。
  • パスに 非 ASCII / 中国語などの文字を含めない こと。
  • サイトが https の場合、マニフェスト およびそれが参照するすべてのファイル（.moc3、テクスチャ、motion3.json、physics3.json、cdi3.json など）も https でなければなりません。さもないと混合コンテンツでエラーになります。
  • クロスオリジン：OSS / COS / 自前の CDN にモデルを置く場合は CORS を正しく有効にしてください（通常はサイトのドメインを許可された Origin に追加するだけ）。

モデルをどこに置く？（推奨度の高い順）​

  1. オブジェクトストレージ + ホットリンク防止（推奨、著作権保護を内蔵）：阿里云 OSS、腾讯云 COS、又拍、七牛 など。Referer ホワイトリストを有効にし、自サイトのみ許可。CDN を前段に挟む場合はホットリンク防止ルールを引き継ぐようにします。
  2. 「本サイトにホスト」をプラグインに任せる：modelAPI を入れた後、「API タイプ」で「カスタム新版モデル · 本サイトにホスト」を選択。プラグインが対応ファイルを wp-content/plugins/live-2d/model/ に全ダウンロードし、フロントには一時的な署名 URL のみを公開します。詳細は V2 ホットリンク防止 を参照。
  3. プラグイン直下の model フォルダ：wp-content/plugins/live-2d/model/{モデル名}/{モデル名}.model3.json に置きます。最も簡単ですが帯域は自分で管理します。
  4. GitHub Pages / jsDelivr などの公開静的ホスティング：動作はしますが、中国本土では非推奨 で、速度が安定せずホットリンク防止もできません。

3. 管理画面で modelAPI を入力​

WordPress 管理画面 → Live2D 設定 → ワークショップ API タイプで「カスタム」を選択。下に modelAPI / modelDir の 2 つの入力欄が現れます。書き方の詳細は modelAPI / modelDir の書き方 を参照してください。

4. モデルテクスチャ（マテリアル）サイズ​

各テクスチャは 2048×2048 以下に抑えてください。Cubism 4+ のテクスチャはもともと大きめで、過大な PNG を重ねると初回描画が 5～10 秒以上に伸びることがよくあります。モデル側の出力時に解像度が大きすぎる場合は、Cubism Editor で「テクスチャアトラスを埋め込み → サイズ再割り当て」を使ってください。

5. 応用：スーパーサンプリング（V2 限定）​

プラグイン 2.1.3 で スーパーサンプリング 機能が追加され、高 DPI ディスプレイでテクスチャをより鮮明にできます。V2（model3.json）モデルにのみ有効 で、V1 パイプラインはこのスイッチを無視します。

6. セキュリティ / 著作権の要点​

  1. 自分のモデルの著作権は自分で保証してください。ベストプラクティス：ホットリンク防止付きのオブジェクトストレージにアップロード + CORS で Origin を限定。
  2. ワークショップは現状アップロードを許可していません — アップロード者の著作権をすべて守る術がないためです。
  3. OSS の SecretKey を WordPress 設定欄に書き込まないでください。どうしてもプライベート読み + 署名 URL を使いたい場合は、wp-config.php の環境変数を経由してください。ホットリンク防止ページ末尾の説明 を参照。