連載 アドオン制作入門 第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— パック全体の情報。名前・説明・パック自体のUUIDmodules— パックの中身の種類。"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 の重複をまず疑う
次はリソースパックだけで完結する、バニラアイテムの見た目を差し替える所をやります。