アドオン制作

連載 アドオン制作入門 第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 を有効にして、実際に動く処理を書きます。