自定义盔甲

盔甲增强玩家的防御，抵御来自生物和其他玩家的攻击。

创建盔甲材质类

从技术上讲，你不需要为你的盔甲材质设立专门的类别，但无论如何，对于你需要的静态场数量来说，这都是很好的做法。

对于本例，我们将创建一个 GuiditeArmorMaterial 类来存储我们的静态字段。

基础耐久度

在创建我们的盔甲物品时，这个常量将在 Item.Properties#maxDamage(int damageValue) 方法中使用，当我们稍后创建 ArmorMaterial 对象时，它也是 ArmorMaterial 构造函数中的参数。

public static final int BASE_DURABILITY = 15;

如果你难以确定平衡的基础耐久度，你可以参考 ArmorMaterials 界面中的原始盔甲材质实例。

装备资产注册表项

尽管我们不必将我们的 ArmorMaterial 注册到任何注册表中，但将任何注册表项存储为常量通常是一种很好的做法，因为游戏将使用它来找到我们盔甲的相关纹理。

public static final ResourceKey<EquipmentAsset> GUIDITE_ARMOR_MATERIAL_KEY = ResourceKey.create(EquipmentAssets.ROOT_ID, Identifier.fromNamespaceAndPath(ExampleMod.MOD_ID, "guidite"));

我们稍后会将其传递给 ArmorMaterial 构造函数。

ArmorMaterial 实例

为了创建我们的材质，我们需要创建一个新的 ArmorMaterial 记录实例，这里将使用基础耐久度和材质注册表项常量。

public static final ArmorMaterial INSTANCE = new ArmorMaterial(
		BASE_DURABILITY,
		Map.of(
				ArmorType.HELMET, 3,
				ArmorType.CHESTPLATE, 8,
				ArmorType.LEGGINGS, 6,
				ArmorType.BOOTS, 3
		),
		5,
		SoundEvents.ARMOR_EQUIP_IRON,
		0.0F,
		0.0F,
		REPAIRS_GUIDITE_ARMOR,
		GUIDITE_ARMOR_MATERIAL_KEY
);

ArmorMaterial 构造函数按照特定顺序接受以下参数：

参数	描述
durability	所有盔甲的基础耐久度，用于计算使用该材质的每个盔甲的总耐久度。 这应该是你之前创建的基础耐久度常量。
defense	EquipmentType（代表每个护甲槽位的枚举）到整数值的映射，表示材质在相应护甲槽位中使用时的防御值。
enchantmentValue	使用此材料制作的盔甲的“可附魔性”。
equipSound	当你装备使用该材质的盔甲时播放的声音事件的注册表项。 有关声音的更多信息，请参阅自定义声音页面。
toughness	一个浮点值，代表盔甲材质的“韧性”属性——本质上代表盔甲吸收伤害的能力。
knockbackResistance	一个浮点值，代表盔甲材质赋予穿戴者的击退抗性。
repairIngredient	一个物品标签，代表所有能够用在铁砧中修复此材质的盔甲物品的物品。
assetId	一个 EquipmentAsset 注册表项，这应该是你之前创建的设备资产注册表项常量。

我们对修复原材料标签引用定义如下：

public static final TagKey<Item> REPAIRS_GUIDITE_ARMOR = TagKey.create(BuiltInRegistries.ITEM.key(), Identifier.fromNamespaceAndPath(ExampleMod.MOD_ID, "repairs_guidite_armor"));

如果你难以确定任何参数的值，你可以查阅在 ArmorMaterials 界面中可以找到的原始 ArmorMaterial 实例。

创建盔甲物品

现在材料已经注册了，就可以在你的 ModItems 类中创建盔甲物品。

显然，盔甲集并不需要满足每种类型，可以让你的集只有靴或护腿等——原版的海龟壳头盔就是个例子，盔甲集缺了部分槽位。

不像 ToolMaterial，ArmorMaterial 并不储存物品的耐久度信息。 因此，在注册盔甲物品时需要手动将基础耐久度添加到盔甲物品的 Item.Properties 中。

这是通过将我们之前创建的 BASE_DURABILITY 常量传递到 Item.Properties 类中的 maxDamage 方法来实现的。

public static final Item GUIDITE_HELMET = register(
		"guidite_helmet",
		Item::new,
		new Item.Properties().humanoidArmor(GuiditeArmorMaterial.INSTANCE, ArmorType.HELMET)
				.durability(ArmorType.HELMET.getDurability(GuiditeArmorMaterial.BASE_DURABILITY))
);
public static final Item GUIDITE_CHESTPLATE = register("guidite_chestplate",
		Item::new,
		new Item.Properties().humanoidArmor(GuiditeArmorMaterial.INSTANCE, ArmorType.CHESTPLATE)
				.durability(ArmorType.CHESTPLATE.getDurability(GuiditeArmorMaterial.BASE_DURABILITY))
);

public static final Item GUIDITE_LEGGINGS = register(
		"guidite_leggings",
		Item::new,
		new Item.Properties().humanoidArmor(GuiditeArmorMaterial.INSTANCE, ArmorType.LEGGINGS)
				.durability(ArmorType.LEGGINGS.getDurability(GuiditeArmorMaterial.BASE_DURABILITY))
);

public static final Item GUIDITE_BOOTS = register(
		"guidite_boots",
		Item::new,
		new Item.Properties().humanoidArmor(GuiditeArmorMaterial.INSTANCE, ArmorType.BOOTS)
				.durability(ArmorType.BOOTS.getDurability(GuiditeArmorMaterial.BASE_DURABILITY))
);

如果需要让物品能从创造模式物品栏获取的话，还需要给将物品添加到创造模式标签页。

就像所有物品一样，要为这些物品创建翻译键。

纹理与模型

你需要为物品创建一组纹理，并为“人形/humanoid”实体（玩家、僵尸、骷髅等）穿戴的实际盔甲创建一组纹理。

物品纹理和模型

这些纹理和其他物品没有区别——必须创建纹理、创建一般的 generated 的物品模型，这在创建你的第一个物品指南中有讲到。

例如，你可以使用下面的纹理和模型 JSON 作为参考。

下载 物品纹理

INFO

你需要所有物品的模型 JSON 文件，不只是头盔，这原则和其他物品模型一样。

{
  "parent": "minecraft:item/generated",
  "textures": {
    "layer0": "example-mod:item/guidite_helmet"
  }
}

可以看到，游戏内的盔甲物品应该有合适的模型：

盔甲纹理

当某个实体穿上您的盔甲时，不会显示任何东西。 这是因为您丢失了一些纹理和设备模型定义。

盔甲纹理有两层，都要有。

之前，我们创建了一个名为 GUIDITE_ARMOR_MATERIAL_KEY 的 ResourceKey<EquipmentAsset> 常量，并将其传递给我们的 ArmorMaterial 构造函数。 建议以相似方法命名纹理文件，在我们的例子中，是 guidite.png

• assets/example-mod/textures/entity/equipment/humanoid/guidite.png — 包含了上身和靴子纹理。
• assets/example-mod/textures/entity/equipment/humanoid_leggings/guidite.png — 包含了护腿纹理。

下载 Guidite盔甲模型纹理

TIP

如果你从旧版本的游戏更新到 1.21.11，则 layer0.png 盔甲纹理所在的位置是 humanoid 文件夹，layer1.png 盔甲纹理所在的位置是 humanoid_leggings 文件夹。

然后，你需要创建一个关联的装备模型定义。 这些会保存在 /assets/example-mod/equipment/ 文件夹。

我们之前创建的 ResourceKey<EquipmentAsset> 常量将决定 JSON 文件的名称。 在这种情况下，它的文件名会是 guidite.json

由于我们只计划加入“humanoid” （头盔、胸甲、护腿、靴子等等） 盔甲部件，我们的装备模型定义如下所示：

{
  "layers": {
    "humanoid": [
      {
        "texture": "example-mod:guidite"
      }
    ],
    "humanoid_leggings": [
      {
        "texture": "example-mod:guidite"
      }
    ]
  }
}

这些纹理存在时，你应该能够看到实体穿着的盔甲了：