アドオン制作

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

③既存アイテムの見た目を変える(リソースパック入門)

リソースパックだけで、バニラアイテムの見た目を差し替えます。ビヘイビアパックなしで完結する、一番身軽な入門です。

前回はビヘイビアパックの最小構成をやりました。今回はリソースパック単体で完結する内容にします。ビヘイビアパックもスクリプトも要らないので、見た目まわりの仕組みだけに集中できます。

差し替えるアイテムを決める

今回はダイヤの剣(diamond_sword)の見た目を差し替えてみます。バニラのアイテムには内部的な短い名前が付いていて、これを覚えておくと後述の紐付けで使います。

manifest.json(リソースパック版)

development_resource_packs に新しいフォルダを作り、manifest.json を置きます。ビヘイビアパックとの違いは modules の type だけです。

{
  "format_version": 2,
  "header": {
    "name": "Aoki Sword Retexture",
    "description": "ダイヤの剣の見た目を変える",
    "uuid": "ここにUUID",
    "version": [1, 0, 0],
    "min_engine_version": [1, 21, 120]
  },
  "modules": [
    {
      "type": "resources",
      "uuid": "ここにもう1つのUUID",
      "version": [1, 0, 0]
    }
  ]
}

テクスチャを用意する

差し替え用の PNG 画像を用意します。バニラのアイテムテクスチャは 16×16 が基本ですが、大きめの正方形サイズ(32×32 や 64×64 など、2のべき乗)でも動きます。透過が必要な部分はアルファチャンネルで抜いておきます。

resource_pack/
  textures/
    items/
      aoki_sword.png

item_texture.json で紐付ける

用意したテクスチャを、バニラの diamond_sword という短い名前に結びつけます。

{
  "resource_pack_name": "aoki_sword_retexture",
  "texture_name": "atlas.items",
  "texture_data": {
    "diamond_sword": {
      "textures": "textures/items/aoki_sword"
    }
  }
}

texture_data のキーが差し替え対象の短い名前、textures の値が拡張子なしのファイルパスです。ここを diamond_sword 以外の名前にすると、別のバニラアイテムの見た目を差し替えることになります。

確認する

リソースパックをワールドに適用して、/give @s diamond_sword を実行します。手に入れたダイヤの剣が、用意したテクスチャに差し変わっていれば成功です。

つまずきやすい所

  • textures のパスに拡張子を付けてしまう — .png は付けません。付けると読み込みに失敗します
  • 短い名前を間違える — diamond_sword のようなバニラの内部名を正確に書く必要があります。スペルミスがあると何も起きません
  • 前のテクスチャがキャッシュされて反映されない — Minecraft を完全に終了してから開き直すと直ることが多いです
  • pack_icon.png がない — 動作自体には影響しませんが、パック一覧の見た目が寂しくなるので、余裕があれば用意しておくといいです

まとめ

  • リソースパックだけで、ビヘイビアパックなしにバニラアイテムの見た目を変えられる
  • item_texture.json の texture_data で「短い名前 → テクスチャファイル」を紐付ける
  • 反映されない時は拡張子の付け忘れとキャッシュをまず疑う

次は逆に、ビヘイビアパック側で新しいアイテムそのものを追加します。今回はバニラの見た目を「差し替える」でしたが、次は自分のアイテムを「増やす」に進みます。