カスタム防具装飾

この記事では、防具装飾をカスタマイズする方法について解説する。

概説[]

Minecraftでは、データパックとリソースパックを用いて任意の模様や色の防具装飾を追加することができる。防具装飾の模様はデータパック内のdata/<名前空間>/trim_patternに、色はdata/<名前空間>/trim_materialに、それぞれJSONファイルとして保存されている。ここで定義された防具装飾は、リソースパックのassets/texture/trim下のフォルダのテクスチャファイルを参照して実装される。

このままでも防具装飾のNBTタグを編集したアイテムを/giveなどのコマンドで与えることでその防具装飾を利用することはできるが、さらに鍛冶から作成できるようにするにはレシピの定義が必要となる。

模様[]

防具装飾の模様は、data/<名前空間>/trim_pattern内のJSONファイルによって以下のフォーマットに従って定義されている。

: ルートタグ。
- asset_id: この模様に対して参照するテクスチャファイルなどのファイル名に使用する文字列。後項「テクスチャ」も参照。
- template: この模様を施すために必要なアイテムのID。「レシピ」の記事も参照。レシピを追加しない場合も必須である。
- description: 防具装飾された防具アイテムにカーソルを翳した際に表示される使用素材名のテキストを定義するRaw JSONテキスト。バニラではtrim.pattern.<名前空間>.<asset_id>の形式のキーで定義された被翻訳テキストが使用されている。
- decal: trueに設定すると元々の防具のテクスチャが透明な部分にも防具装飾の模様を適用する。デフォルトはfalseである。

色[]

防具装飾の模様は、data/<名前空間>/trim_material内のJSONファイルによって以下のフォーマットに従って定義されている。

: ルートタグ。
- asset_name: この色に対して参照するカラーマップのファイル名に使用する文字列。後項「テクスチャ」も参照。
- ingredient: この色の装飾を施すに必要なアイテムのID。「レシピ」も参照。レシピを追加しない場合も必須である。
- description: 防具装飾された防具アイテムにカーソルを翳した際に表示される使用素材名のテキストを定義するRaw JSONテキスト。バニラではtrim_material.<名前空間>.<asset_name>の形式のキーで定義された被翻訳テキストが使用されている。
- override_armor_materials: 特定の素材の防具に対して使用するカラーマップを変更するためのフィールド。防具の素材名（leather、chainmail、iron、gold、diamond、netheriteおよびturtleの何れか）と使用するカラーマップの名前の組を列挙する。
  - <防具の素材名>: カラーマップの名前。これをもとに asset_nameと同様の仕組みで参照するカラーマップを決定する。

テクスチャ[]

防具装飾には模様のテクスチャ、パレットのキー、カラーパレットの3種類のテクスチャとテクスチャアトラスの設定ファイルが必要である。

模様[]

模様のテクスチャはassets/<名前空間>/textures/trim/model/armorに保存する。模様一種類につき、テクスチャファイルは<asset_id>.pngと<asset_id>_leggings.pngの2つが必要である。前者は最外層に位置するヘルメット、チェストプレート、ブーツの模様、後者はその一つ内側に位置するレギンスの模様を指定するテクスチャである。

これらの模様テクスチャは後述のパレットのキーに使用されている色を用いて描く。

テクスチャファイルの雛形。
雛形の説明画像。

パレットのキー[]

パレットのキーは、模様テクスチャに使用されている色とカラーマップの色を結び付けるための画像である。

模様テクスチャはパレットのキー上に存在する色を用いて描く。カラーマップはパレットのキーと同じ形の画像である。模様テクスチャを色ごとに染色する際には、模様テクスチャの各ピクセルが、パレットのキー上の同じ色のピクセルと同じ位置にあるカラーパレット上のピクセルの色で彩色される。

デフォルトで使用されているtrim_pallete.pngは縦1、横8ピクセルの画像であり、色は左から#E0E0E0、#C0C0C0、#A0A0A0、#808080、#606060、#404040、#202020、#000000である。

カラーマップ[]

カラーマップのテクスチャはassets/<名前空間>/textures/trim/colormapに<asset_name>.pngという名前で保存する。上述の通りパレットのキーと同型の画像でなければならない。

テクスチャアトラス[]

新しい防具装飾を追加した場合は本来バニラで使用しないテクスチャファイルを使用することになるので、テクスチャアトラスを編集して必要な画像を追加するよう設定しなければならない。テクスチャアトラスの仔細な仕様はこちらを参照。防具装飾の際に必要なファイルとその内容は以下の通り。

assets/<名前空間>/atlases/armor_trims.json

{
    "sources": [
        {
            "type": "paletted_permutations",
            "textures": [
                "<名前空間>:trims/models/armor/<assets_id>",
                "<名前空間>:trims/models/armor/<assets_id>_leggings"
            ],
            "palette_key": "<使用するパレットのキーのパス>",
            "permutations": {
                "<assets_name>": "<名前空間>:trims/color_palettes/<assets_name>"
            }
        }
    ]
}

このJSONファイルは追加された色・模様に対応する染色後のテクスチャを生成するのに必要。

模様のみを追加した場合は texturesには追加した模様分を、 permutationsにはデフォルト含めたすべての色の分を入力する。色　のみを追加した場合は texturesにはデフォルト含めたすべての模様分、 permutationsには追加した色分を入力する。模様と色の両方を追加した場合は全ての模様、色分を入力する必要がある。

assets/<名前空間>/atlases/blocks.json

{
    "sources": [
        {
            "type": "paletted_permutations",
            "textures": [
                "trims/items/leggings_trim",
                "trims/items/chestplate_trim",
                "trims/items/helmet_trim",
                "trims/items/boots_trim"
            ],
            "palette_key": "trims/color_palettes/trim_palette",
            "permutations": {
                "<assets_name>": "trims/color_palettes/<assets_name>"
            }
        }
    ]
}

このJSONファイルは、色を追加した場合に対応する防具のアイテムアイコンを生成するために必要である。模様のみを追加した場合は必要ない。 permutationsには追加した色分を全て入力する。

歴史[]

Java Edition
1.19.4	23w04a	データパックにディレクトリ`trim_material`と`trim_pattern`が追加された。
	23w05a	この素材で防具装飾を施すことが出来ない防具の素材（例：鉄製装飾なら鉄の防具など）を定義していた incompatible_armor_materialが`trim_material`から削除された。
	23w05a	代わりに、防具が特定の素材である際に別のカラーパレットを使用するよう指定するためのフィールド override_armor_materialsが`trim_material`に追加された。
1.20.2	23w33a	元々の防具のテクスチャが透明な部分にも防具装飾の模様を適用するかどうかを設定するフィールド decalが`trim_pattern`に追加された。

カスタム防具装飾

目次

概説[]

模様[]

色[]

テクスチャ[]

模様[]

パレットのキー[]

カラーマップ[]

テクスチャアトラス[]

歴史[]

脚注[]