Skip to content
ItemsAdder
⌘ K

Armors

Wear texture configuration

yaml
equipments:
  my_armor_1:
    type: armor
    layer_1: armor/my_armor_1/layer_1
    layer_2: armor/my_armor_1/layer_2

The equipment is a property which contains the information how to show the armor in-game on the player body.

Create the layers files inside the folder: contents/my_armor_tutorial/textures/armor/my_armor_1 .

Item configuration

In this example I will show how to create a chestplate, the same can be done to create other armor pieces.

yaml
  my_armor_1_chestplate:
    name: My Armor 1 Chestplate
    material: IRON_CHESTPLATE
    graphics:
      texture: item/my_armor_1_chestplate
    durability:
      max_durability: 165
    equipment:
      id: my_armor_tutorial:my_armor_1
      slot_attribute_modifiers:
        armor: 1

As you can see I set the material to IRON_CHESTPLATE.

I also set the equipment.id property to my_armor_tutorial:my_armor_1.
This loads our previously created equipment settings.

Inventory item textures

Create the item texture and put it inside the folder:
contents/my_armor_tutorial/textures/item.

Extra: Custom 3D helmet

Currently only helmets support 3D models due to a Minecraft limitation I cannot fix.

yaml
  my_armor_1_helmet_3d:
    name: My Armor 1 Helmet 3D
    material: IRON_HELMET
    graphics:
      model: armor/my_armor_1_helmet_3d
    durability:
      max_durability: 165
    equipment:
      slot_attribute_modifiers:
        armor: 2.5

Full configuration from the previous example

Click here to read the configuration file
yaml
info:
  namespace: my_armor_tutorial
equipments:
  my_armor_1:
    type: armor
    layer_1: armor/my_armor_1/layer_1
    layer_2: armor/my_armor_1/layer_2
items:
  my_armor_1_helmet:
    name: My Armor 1 Helmet
    material: IRON_HELMET
    graphics:
      texture: item/my_armor_1_helmet
    durability:
      max_durability: 165
    equipment:
      id: my_armor_tutorial:my_armor_1
      slot_attribute_modifiers:
        armor: 2.5
  my_armor_1_chestplate:
    name: My Armor 1 Chestplate
    material: IRON_CHESTPLATE
    graphics:
      texture: item/my_armor_1_chestplate
    durability:
      max_durability: 165
    equipment:
      id: my_armor_tutorial:my_armor_1
      slot_attribute_modifiers:
        armor: 1
  my_armor_1_leggings:
    name: My Armor 1 Leggings
    material: IRON_LEGGINGS
    graphics:
      texture: item/my_armor_1_leggings
    durability:
      max_durability: 165
    equipment:
      id: my_armor_tutorial:my_armor_1
      slot_attribute_modifiers:
        armor: 2.5
  my_armor_1_boots:
    name: My Armor 1 Boots
    material: IRON_BOOTS
    graphics:
      texture: item/my_armor_1_boots
    durability:
      max_durability: 165
    equipment:
      id: my_armor_tutorial:my_armor_1
      slot_attribute_modifiers:
        armor: 2.5

Animated/emissive armors

The current custom armors method doesn't support animated and emissive textures.
To create animated or/and emissive textures you have to use the Old Textured method (uses shaders).

HD armor textures

I do not advice to use HD textures since this is a blocky game, but can create HD high resolution, but make sure they have the same proportions of the original vanilla armors layers textures.

Size must be a power of 2, for example: 64x32, 128x64, 256x128, 512x256.

Converting old armors to the new equipment tag

This option will convert the armors completely to use the new equipment tag. Note that old clients won't see the armor anymore (older than 1.21.2).

config.yml
yaml
advanced:
    completely_convert_to_new_equipment_tag:
      enabled: true
      new_armor_material: IRON