How to add custom armor to Oraxen

Custom Armor is one of the many ways you can make your server more unique. In this tutorial, you will learn how to add your own armor sets to your server using the Oraxen plugin.

Example image from Toffy’s Custom Armor V.1

Step 1: Add your armor textures to the textures folder.

For this example, we will add them to the “pack/textures/armor” folder.

Double-check that your armor layer files have the correct names! For the layer files, they should be named “<armor_name>_layer_1” and “<armor_name>_layer_2”. 

For the sprite files (inventory icons), they should be named “<armor_name>_<armor_type>” (example “emerald_helmet”).

Step 2: Create your armor configuration

Next, you need to create your armor configuration. I’ve created a file called “armor.yml” in the “items” folder of Oraxen and added this:

emerald_helmet: # The armor name HAS to follow this format: "<armor_name>_<armor_type>"
  displayname: "<gradient:#89E59D:#37C6BA>Emerald Helmet"
  material: LEATHER_HELMET
  color: 3, 252, 136 # This can be any valid RGB color.
  lore:
    - "<gradient:#89E59D:#37C6BA>My custom helmet!"
  Pack:
    generate_model: true
    parent_model: "item/generated"
    textures: # duplicate because we use the overlay of the leather armor
      - default/armors/emerald_helmet
      - default/armors/emerald_helmet

Step 3: Reload Oraxen

You’re done! Run the command “/oraxen reload all”, make sure you have the new resource pack and then “/oraxen inventory” to open the GUI. Your item should appear in the “armor.yml” section of the inventory.

Step 4: Advanced Features

Oraxen is an extremely powerful plugin, in steps 1-3, we just added a simple armor item.

You can also customize your armor durability, change the player’s health, and much more!

Here’s a much more advanced armor configuration, which has increased durability, +2 Max Health, +2 Armor Toughness, and +3 Armor Points. 

emerald_helmet:
  displayname: "<gradient:#89E59D:#37C6BA>Emerald Helmet"
  material: LEATHER_HELMET
  color: 3, 252, 136 #rgb
  lore:
    - "<gradient:#89E59D:#37C6BA>My custom helmet!"
  Mechanics:
    durability:
      value: 635
  AttributeModifiers:
    # - name: You don't really care about the name but it can be useful for some developers
    # - attribute: Get the list here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/attribute/Attribute.html
    # - operations: 0 for ADD_NUMBER, 1 for ADD_SCALAR, 2 for MULTIPLY_SCALAR_1;
    # - uuid: put a random uuid, generate one here: https://www.uuidgenerator.net/
    # - slot: HAND, OFF_HAND, FEET, LEGS, CHEST or HEAD
    - { name: "oraxen", attribute: GENERIC_MAX_HEALTH, amount: 2, operation: 0,
        uuid: 3a25f0b5-dbda-4e38-b097-9e75e37ae464, slot: HEAD }
    - { name: "oraxen", attribute: GENERIC_ARMOR, amount: 3, operation: 0,
        uuid: 3a25f0b5-dbda-4e38-b097-9e75e37ae464, slot: HEAD }
    - { name: "oraxen", attribute: GENERIC_ARMOR_TOUGHNESS, amount: 2, operation: 0,
        uuid: 3a25f0b5-dbda-4e38-b097-9e75e37ae464, slot: HEAD }

Step 5: FAQ

My armor looks… glitchy when using Optifine or Iris Shaders. What should I do?

Unfortunately, Oraxen’s custom armor does not currently support the use of Optifine or Iris Shaders naturally.

You can manually create the optifine resource pack configs to make it work, we’re making another guide on that very soon. Join our Discord and enable tutorial & guide notifications so you don’t miss it.

How do I format the lore and item name?

Oraxen uses the MiniMessage format. You can read the documentation here

More Oraxen tutorials
Download premade Oraxen packs