modelAPI / modelDir の書き方
WordPress 管理画面 → Live2D 設定 → 「ワークショップ API タイプ」で カスタム を選ぶと、2 つの入力欄が現れます：
- modelAPI — URL または URL プレフィックス
- modelDir — リスト。1 行 1 サブディレクトリ名
組み合わせ方は modelAPI の 末尾文字 によって決まり、書き方は 2 通りしかありません。
書き方 ①：単一モデル直リンク（modelAPI が .json で終わる）
modelAPI に完全な *.model3.json URL を入れます。下方の modelDir は 無視 されます。
例
modelAPI: https://cdn.example.com/live2d/haru/haru.model3.json
modelDir: （空欄でよい。無視される）
ロード時、ブラウザはこの JSON を直接リクエストします。フロントの「前へ / 次へ」ボタンはこのモードでは意味がないため、管理画面で無効にすることをおすすめします。
書き方 ②：ディレクトリルート + 複数モデル（modelAPI が / で終わる）
modelAPI はルートディレクトリ URL、modelDir は複数のサブディレクトリ名のリストです。プラグインは {modelAPI}{名前}/{名前}.model3.json の形式で完全な URL を組み立てます。
重要な制約：各サブディレクトリ内の *.model3.json の ファイル名はサブディレクトリ名と完全に一致 する必要があります。
例
modelAPI: https://cdn.example.com/live2d/
modelDir:
- haru
- mao
- shizuku
実際のロード時、プラグインは次のように組み立てます：
https://cdn.example.com/live2d/haru/haru.model3.json
https://cdn.example.com/live2d/mao/mao.model3.json
https://cdn.example.com/live2d/shizuku/shizuku.model3.json
フロントの「まばたき / 切り替えボタン」はこれらのモデル間で循環します。
どちらを選ぶ？
| シーン | 推奨 |
|---|---|
| 固定 1 体だけ表示し切り替えしない | ① 直リンク |
| 訪問者が複数モデルを切り替えられるようにしたい | ② ディレクトリルート + 複数 modelDir |
| 「本サイトにホスト」を使いたい | ② —— このとき modelAPI は非表示になり、modelDir のみを入力 |
パス / プロトコル要件
- パスに 非 ASCII / 中国語などの文字を含めない こと。
- サイトが
httpsの場合、modelAPI およびそれが参照するすべてのファイル（.moc3、テクスチャ、motion3.json、physics3.json、cdi3.jsonなど）もhttpsでなければなりません。さもないと混合コンテンツでエラーになります。 - クロスオリジン：OSS / COS / 自前の CDN にモデルを置く場合は、CORS を正しく有効にしてください（通常はサイトのドメインを許可された Origin に追加するだけで OK）。
ブラウザ拡張機能での違いは？
ブラウザ拡張機能の「カスタム URL（有料）」モードは modelAPI / modelDir の書き方が WordPress プラグインと完全に同じ で、「本サイトにホスト」オプションがないだけです。ソース URL が chrome-extension://... または * を Origin として許可していることを確認してください。