連載 アドオン制作入門 第4回
④独自アイテムを追加する(ビヘイビアパック入門)
ビヘイビアパックで新しいアイテムを1つ定義して、/give で出せるようにするところまでをやります。
前回はバニラアイテムの見た目を差し替えるだけでしたが、今回は自分のアイテムそのものを追加します。ビヘイビアパックとリソースパックの両方に手を入れる、最初の「合わせ技」の記事です。
アイテムの識別子を決める
自作のアイテムには、自分の名前空間を付けた識別子を付けます。dynamic property の記事でも書きましたが、他のアドオンと衝突しないように aoki: で始めるようにしています。今回は aoki:ruby という識別子にします。
items/ruby.json を書く
ビヘイビアパックの items フォルダに、アイテムの定義ファイルを置きます。
behavior_pack/
items/
ruby.json
{
"format_version": "1.21.0",
"minecraft:item": {
"description": {
"identifier": "aoki:ruby",
"menu_category": {
"category": "items"
}
},
"components": {
"minecraft:max_stack_size": 64,
"minecraft:icon": {
"texture": "aoki_ruby"
},
"minecraft:display_name": {
"value": "item.aoki:ruby"
}
}
}
}
description.identifier— アイテムの識別子。/giveで使う名前になりますminecraft:iconのtexture— リソースパック側の短い名前(後述)minecraft:display_nameのvalue— 言語ファイルのキー(後述)。直接日本語を書くこともできますが、翻訳ファイル経由にしておくと後で多言語対応しやすくなります
コンポーネント周りの仕様は Minecraft のバージョンごとに追加・変更されるので、書く時点の format_version に対応した最新の書き方を確認しておくと安全です。
リソースパック側も必要
アイテムを定義しただけでは、見た目と表示名がありません。リソースパック側に、新しいテクスチャと言語ファイルを用意します。
item_texture.json に短い名前を追加します。
{
"resource_pack_name": "aoki_ruby_pack",
"texture_name": "atlas.items",
"texture_data": {
"aoki_ruby": {
"textures": "textures/items/aoki_ruby"
}
}
}
前回は既存の名前(diamond_sword)に上書きしましたが、今回は aoki_ruby という新しい名前を追加している点が違いです。
言語ファイル(texts/ja_JP.lang)に表示名を書きます。
item.aoki:ruby=ルビー
確認する
両方のパックをワールドに適用してから、コマンドで出してみます。
/give @s aoki:ruby
インベントリに「ルビー」という名前のアイテムが、用意したテクスチャ付きで出てくれば成功です。
つまずきやすい所
- リソースパックの適用忘れ — ビヘイビアパックだけ有効にしても、見た目は紫と黒のチェック柄になり、名前も識別子のまま表示されます。両方を有効にする必要があります
minecraft:iconの texture 名とitem_texture.jsonのキーが一致していない — スペルミスがあると見た目が反映されません- 言語ファイルのキーがずれている —
minecraft:display_nameのvalueと.langファイルの左辺を完全に一致させる必要があります format_versionが古い — 使いたいコンポーネントがそのバージョンにまだ無い、または廃止されている場合があります
まとめ
- 自作アイテムは
items/*.jsonにminecraft:itemとして定義する - 識別子には自分の名前空間(
aoki:など)を付けて衝突を避ける - 見た目と表示名は、リソースパック側の
item_texture.jsonと言語ファイルで別途用意する - ビヘイビアパックとリソースパックは両方揃って初めて完成する
ここまでで JSON だけのアドオンは一通り作れるようになりました。次はいよいよ Script API を有効にして、実際に動く処理を書きます。