防具の追加

防具は通常のブロックやアイテムより実装が少し複雑ですが、一度理解すれば簡単に実装できます。防具を追加するには、まず CustomArmorMaterial 〔カスタム防具材料〕クラスを作成してから、アイテムを登録します。また、それらをテクスチャリングする方法も見ていきます。このドキュメントの最後に、防具にノックバックを追加する方法を説明する特別な章があります。これは、メソッドがミックスイン（現在 1.16.3）を介してのみアクセスできるためです。

このドキュメントの例は、 この Mod （GitHub リポジトリ） にあります。

新しい防具には新しい名前（および防御点や耐久度などの追加要素）を設定する必要があるため、 CustomArmorMaterial の新しいクラスを作成する必要があります。

このクラスは ArmorMaterial を実装し、防御点（PROTECTION_VALUES と呼ばれる）に値を割り当てることから始めます。以降の引数はすべて @Override を使用します。

public class CustomArmorMaterial implements ArmorMaterial {
	private static final int[] BASE_DURABILITY = new int[] {13, 15, 16, 11};
	private static final int[] PROTECTION_VALUES = new int[] {A, B, C, D}; 
 
	// A がブーツ、 B がレギンス、 C がチェストプレート、 D がヘルメットです。
	// 参考までに、革の防具は {1, 2, 3, 1}、 ダイヤモンドとネザライトの防具は {3, 6, 8, 3} を使用しています
}

次の引数は次のように定義されます（名前は気にしないでください。以下にどのように実装するかが表示されます）：

1. method_7696: 防具が壊れるまでに何回ヒットできるか。 'BASE_DURABILITY' に書いた int 〔32 ビット整数型〕を使って計算します。革は 5、ダイヤモンドは 33、ネザライトは 37 です。
2. method_7697: すでに上で書いた 'PROTECTION_VALUES' を呼び出します。
3. getEnchantability: 防具がエンチャントの本で高レベルまたは複数のエンチャントを取得できる可能性です。
4. SoundEvent getEquipSound: バニラの防具で使用される標準は SoundEvents.ITEM_ARMOR_EQUIP_X で、X は防具の種類です。
5. Ingredient getRepairIngredient: 金床で防具を修理するために使用するアイテムが返されます。バニラのアイテムまたは独自のアイテムのいずれかです。
6. String getName: 防具の親アイテムが返されます。ダイヤモンドの防具なら “ダイヤモンド” ですね。
7. getToughness: これは、価値の高い攻撃に対して鎧がより耐久性を持つ 2 番目の保護値です。 値は 'X.0F' になります

そして、1.16 で導入された新しい値があります

1. getKnockbackResistance: この値は 0 のままにしておきます。実装したい場合は、「0.XF」と書きます（X は、必要なノックバック保護の量です）。後でそれを機能させる方法を教えます。

すべての変数を X または A、 B、 C、 D として記述したままにします。これらの引数を使用すると、次のようになります：

public class CustomArmorMaterial implements ArmorMaterial {
	private static final int[] BASE_DURABILITY = new int[] {13, 15, 16, 11};
	private static final int[] PROTECTION_VALUES = new int[] {A, B, C, D};
 
	@Override
	public int method_7696(EquipmentSlot slot) {
		return BASE_DURABILITY[slot.getEntitySlotId()] * X;
	}
 
	@Override
	public int method_7697(EquipmentSlot slot) {
		return PROTECTION_VALUES[slot.getEntitySlotId()];
	}
 
	@Override
	public int getEnchantability() {
		return X;
	}
 
	@Override
	public SoundEvent getEquipSound() {
		return SoundEvents.ITEM_ARMOR_EQUIP_X;
	}
 
	@Override
	public Ingredient getRepairIngredient() {
		return Ingredient.ofItems(RegisterItems.X);
	}
 
	@Override
	public String getName() {
		// すべて小文字にする必要があります
		return "name";
	}
 
	@Override
	public float getToughness() {
		return X.0F;
	}
 
	@Override
	public float getKnockbackResistance() {
		return 0.XF;
	}
}

防具材料クラスの基本が理解できたので、防具アイテムを新しいクラスに登録しましょう。

新しい防具を実装するために、 RegisterItems という新しいクラスを作成します。これは、たとえば、インゴットのような新しいアイテムを作成する場合にツールを登録する場所にもなります（これを “Custom_Material” と呼びます）。この設定により、アイテムは新しいクリエイティブタブにも配置されますが、その部分は自由に削除できます。

グループの構文は .method_7892(YourModName.YOUR_MOD_NAME_BUT_IN_CAPS_GROUP) です。これを ExampleMod と呼びます：

public class RegisterItems {
 
    public static final ArmorMaterial CUSTOM_ARMOR_MATERIAL = new CustomArmorMaterial();
    public static final Item CUSTOM_MATERIAL = new CustomMaterialItem(new Item.Settings().method_7892(ExampleMod.EXAMPLE_MOD_GROUP));
    // 新しい素材を作成した場合は、ここに注意してください。
    public static final Item CUSTOM_MATERIAL_HELMET = new ArmorItem(CUSTOM_ARMOR_MATERIAL, EquipmentSlot.HEAD, new Item.Settings().method_7892(ExampleMod.EXAMPLE_MOD_GROUP));
    public static final Item CUSTOM_MATERIAL_CHESTPLATE = new ArmorItem(CUSTOM_ARMOR_MATERIAL, EquipmentSlot.CHEST, new Item.Settings().method_7892(ExampleMod.EXAMPLE_MOD_GROUP));
    public static final Item CUSTOM_MATERIAL_LEGGINGS = new ArmorItem(CUSTOM_ARMOR_MATERIAL, EquipmentSlot.LEGS, new Item.Settings().method_7892(ExampleMod.EXAMPLE_MOD_GROUP));
    public static final Item CUSTOM_MATERIAL_BOOTS = new ArmorItem(CUSTOM_ARMOR_MATERIAL, EquipmentSlot.FEET, new Item.Settings().method_7892(ExampleMod.EXAMPLE_MOD_GROUP));
 
}

アイテムが適切に作成されたので、アイテムを登録して適切な名前を付けましょう。最初のパラメーターは名前空間であり、これは Mod ID であり、次にアイテムに付けたい名前です。

最後の ArmorItem のすぐ下にこれを書き込みます。

public static void register() {
    Registry.register(Registry.field_11142, new Identifier("examplemod", "custom_material"), CUSTOM_MATERIAL);
    Registry.register(Registry.field_11142, new Identifier("examplemod", "custom_material_helmet"), CUSTOM_MATERIAL_HELMET);
    Registry.register(Registry.field_11142, new Identifier("examplemod", "custom_material_chestplate"), CUSTOM_MATERIAL_CHESTPLATE);
    Registry.register(Registry.field_11142, new Identifier("examplemod", "custom_material_leggings"), CUSTOM_MATERIAL_LEGGINGS);
    Registry.register(Registry.field_11142, new Identifier("examplemod", "custom_material_boots"), CUSTOM_MATERIAL_BOOTS);
}

防具アイテムが完成しました。次に、メインクラスでレジストリを呼び出します（そして、新しいグループに注釈を付けます）。

public static final ItemGroup EXAMPLE_MOD_GROUP = FabricItemGroupBuilder.create(
    new Identifier("examplemod", "example_mod_group"))
    .icon(() -> new ItemStack(RegisterItems.CUSTOM_MATERIAL)) // これは作成した新素材のモデルをアイコンとして使っていますが、好きなように参照できます
    .build();
 
@Override
public void onInitialize() {
    RegisterItems.register();
}

それでおしまい！アーマーはゲーム内に存在し、まだテクスチャはありませんが、存在し、 /give コマンドで与えることができます。

次に、各ピースにテクスチャを割り当てます。

以下のことを行っていると仮定します

• 各防具アイテムのテクスチャを用意している（x_helmet.png、x_chestplate.png など）
• 防具のテクスチャを用意している（x_layer_1.png と x_layer_2.png）

そして、それらを各防具アイテムに割り当てます。

以下は、すべての防具アイテムで同じである必要があります。使用するパーツを変更するだけです。この例ではヘルメットを使用します。

resources/assets/examplemod/models/item/custom_material_helmet.json

{
	"parent": "item/generated",
	"textures": {
		"layer0": "examplemod:item/custom_material_helmet"
	}
}

すべての防具アイテムで繰り返します。

通常、 Mod のテクスチャは resources/assets/<modid> の下にありますが、防具のテクスチャは具体的には minecraft ディレクトリにあります： 装着している防具にテクスチャを与えるには、X_layer_1.png と X_layer_2.png （X は防具材料クラスで選択した引数 getName）を 'resources/assets/minecraft/textures/models/armor' に配置します。

すべてに従えば、完全な防具セットを手に入れることができるはずです！