Skip to main content

How to make a Tier

Creating a Tier​

Each tier is its own config file, placed in the /tiers/ folder, and you can add or remove them as you please. There's an example config called _example.yml to help you out!

The ID of the Tier is the file name. This is what you use in commands and the defaultTier section of the set configs. ID's must be lowercase letters, numbers, and underscores only.

Example Tier Config​

display: "&c&lNETHERITE" 
requiresTiers: 
  - diamond
crystal:
  item: end_crystal 
  name: "&cNetherite Upgrade Crystal" 
  lore: 
    - "&8Drop this onto an armor piece"
    - "&8to set its tier to:"
    - "&c&lNETHERITE"
    - ''
    - "&8&oRequires the armor to already have Diamond tier"
  craftable: true 
  recipe: 
    - air
    - netherite_ingot
    - air
    - netherite_ingot
    - ecoarmor:upgrade_crystal_diamond
    - netherite_ingot
    - air
    - netherite_ingot
    - air
  giveAmount: 1 
properties:
  helmet:
    armor: 3 
    toughness: 3 
    knockbackResistance: 1 
    speedPercentage: 0 
    attackSpeedPercentage: 0 
    attackDamagePercentage: 0 
    attackKnockbackPercentage: 0 
  chestplate:
    armor: 8
    toughness: 3
    knockbackResistance: 1
    speedPercentage: 0
    attackSpeedPercentage: 0
    attackDamagePercentage: 0
    attackKnockbackPercentage: 0
  elytra:
    armor: 3
    toughness: 0
    knockbackResistance: 1
    speedPercentage: 0
    attackSpeedPercentage: 0
    attackDamagePercentage: 0
    attackKnockbackPercentage: 0
  leggings:
    armor: 6
    toughness: 3
    knockbackResistance: 1
    speedPercentage: 0
    attackSpeedPercentage: 0
    attackDamagePercentage: 0
    attackKnockbackPercentage: 0
  boots:
    armor: 3
    toughness: 3
    knockbackResistance: 1
    speedPercentage: 0
    attackSpeedPercentage: 0
    attackDamagePercentage: 0
    attackKnockbackPercentage: 0

Understanding all the sections​

The Info Section​

display: "&c&lNETHERITE" # The display in-game
requiresTiers: # If this tier requires a prior tier to be applied
  - diamond # Tier ID

To explain the requiredTiers, here is an example progression:
The "Netherite" tier can only be applied to armor pieces that have the "Diamond" tier.

The default tier tree looks like this:

                                            /-> exotic
default --> iron --> diamond --> netherite --> manyullyn
         \-> cobalt --> osmium

ancient --> mythic

The Crystal Section​

This is the section for the upgrade crystal, which is used to apply the tier to the armor piece, which is the physical item in-game used to upgrade the stats of armor pieces.

crystal:
  # The crystal item, read more here: https://plugins.auxilor.io/the-item-lookup-system
  item: end_crystal
  name: "&cNetherite Upgrade Crystal" # The name shown in-game.
  lore: # The lore shown in-game. Set to `lore: []` to remove lore.
    - "&8Drop this onto an armor piece"
    - "&8to set its tier to:"
    - "&c&lNETHERITE"
    - ''
    - "&8&oRequires the armor to already have Diamond tier"
  craftable: true # If the armor piece is craftable
  recipe: # The recipe, read here for more: https://plugins.auxilor.io/the-item-lookup-system/recipes
    - air
    - netherite_ingot
    - air
    
    - netherite_ingot
    - ecoarmor:upgrade_crystal_diamond
    - netherite_ingot
    
    - air
    - netherite_ingot
    - air
  giveAmount: 1 # Optional, set the amount of items to give in the recipe

For more information on recipes, check out the Crafting Recipes documentation.

The Armor Properties Section​

The below is just the helmet attributes, this is replicated for the other armor pieces, including the Elytra.
You can find default attribute values on the Minecraft Wiki, where you can learn more about how they work.

properties:
  helmet:
    armor: 3 # Armor points (≈8 = netherite; >20 per piece has heavy diminishing returns)
    toughness: 3 # Armor toughness (≈3 = netherite; >12–15 per piece has little benefit)
    knockbackResistance: 1 # Knockback resist 0–100 (100 = immune; 40–60 ≈ netherite)
    speedPercentage: 0 # Move speed % (-50 to +50 recommended)
    attackSpeedPercentage: 0 # Attack speed % (-50 to +100; very high values can feel broken)
    attackDamagePercentage: 0 # Damage % (-50 to +100; high values trivialize combat)
    attackKnockbackPercentage: 0 # Knockback dealt % (-100 to +100; negative = less knockback)
    maxHealth: 0 # Extra max health (0–40 total across set; +20 = +10 hearts)
    attackDamageFlat: 0 # Flat damage bonus (0–6; +6 ≈ Sharp V extra)
    attackSpeedFlat: 0 # Flat attack speed (0–4; base is 4.0, +4 = double speed)
    jumpStrength: 0 # Jump strength % (0–100; +100 ≈ double jump height)
    gravityPercentage: 0 # Gravity % (-80 to +100; negative = floatier, positive = heavier)
    burningTimePercentage: 0 # Fire duration % (-100 to +100; -100 = fire immune)
    explosionKnockbackResistance: 0 # Explosion knockback resist 0–100
    oxygenBonus: 0 # Extra oxygen ticks (0–600; +300 ≈ +15s underwater)
    movementEfficiency: 0 # Slowdown resistance 0–100 (100 = ignore soul sand/webs)
    safeFallDistance: 0 # Extra safe fall blocks (0–20; +3 = vanilla, +10 ≈ 13 blocks)
    entityInteractionRangePercentage: 0 # Entity reach % (0–100; +50 = noticeably longer)
    blockInteractionRangePercentage: 0 # Block reach % (0–100; creative ≈ +50)

Default configs​

The default configs can be found here.