アドオン制作

連載 アドオン制作入門 第2回

②manifest.json を書いて、何もしないアドオンを認識させる

ビヘイビアパックの manifest.json を書いて、Minecraft に「何もしないアドオン」として認識させるところまでをやります。

前回、開発用フォルダの場所を確認しました。今回はその中に、中身が空の「何もしないアドオン」を作って、Minecraft に認識させるところまでをやります。いきなり機能を詰め込む前に、一番小さい単位で「認識される」を体験しておくと、後で何かが動かなくなった時に切り分けがしやすくなります。

フォルダを作る

development_behavior_packs の中に、アドオン名のフォルダを作ります。

development_behavior_packs/
  AokiFirstAddon/
    manifest.json

フォルダ名は好きに付けて構いませんが、後々 Git リポジトリ名や namespace と揃えておくと迷わなくなります。

UUID を用意する

manifest.json には UUID(一意な識別子)が最低2つ必要です。PowerShell から生成できます。

[guid]::NewGuid()

実行するたびに違う UUID が出てくるので、必要な数だけ繰り返し実行してメモしておきます。UUID はパックそのものと、パック内の「モジュール」それぞれに必要で、この2つは必ず別の値にします。同じ値を使い回すと Minecraft がパックを正しく区別できなくなります。

manifest.json の中身

一番小さい構成はこうなります。

{
  "format_version": 2,
  "header": {
    "name": "Aoki First Addon",
    "description": "何もしないアドオン",
    "uuid": "ここに1つ目のUUID",
    "version": [1, 0, 0],
    "min_engine_version": [1, 21, 120]
  },
  "modules": [
    {
      "type": "data",
      "uuid": "ここに2つ目のUUID",
      "version": [1, 0, 0]
    }
  ]
}
  • header — パック全体の情報。名前・説明・パック自体のUUID
  • modules — パックの中身の種類。"type": "data" はビヘイビアパック用の基本形
  • min_engine_version — 動作対象の Minecraft バージョン。古すぎると新しい機能が使えず、新しすぎると古いバージョンで読み込めません

min_engine_version はバージョンによって適切な値が変わるので、書く時点の最新の統合版バージョンに合わせて確認してください。

何もしない、を確認する

これだけで有効なアドオンとして認識されます。Minecraft を起動して、ワールド作成画面の「ビヘイビアパック」タブを開くと、一覧に「Aoki First Addon」が出てくるはずです。選択してワールドに追加すれば、中身が空でもエラーにはなりません。

新しく置いたパックがすぐに一覧へ出てこない時は、Minecraft を完全に再起動すると反映されます。

つまずきやすい所

  • JSON の末尾カンマ — 最後の要素の後ろに , を残すと丸ごと読み込み失敗します。エディタの構文チェックで気づけます
  • UUID の重複 — header と modules で同じ UUID を使うと正しく認識されません
  • min_engine_version が古すぎる/新しすぎる — パックが一覧に出てこない、または出てくるのに有効化できない原因になります
  • 一覧に出てこない — 大抵は JSON が壊れているか、Minecraft を再起動していないかのどちらかです

まとめ

  • development_behavior_packs の中にフォルダを作り、manifest.json を置く
  • header と modules それぞれに別々の UUID が要る
  • type: "data" だけの最小構成でも、有効なアドオンとして認識される
  • 動かない時は JSON の構文と UUID の重複をまず疑う

次はリソースパックだけで完結する、バニラアイテムの見た目を差し替える所をやります。