repair.vanilla.yml defines which items can be repaired via the Repair skill anvil, what material is used to repair them, and the level/XP modifiers that apply. Default values can be viewed on GitHub.
Changes require a full server restart. For adding repairs for custom/modded items, see Mods Support.
Each entry under Repairables: follows this format:
Repairables:
SHIELD:
MinimumLevel: 0
XpMultiplier: .25
ItemType: OTHER
ItemMaterialCategory: WOOD
RepairMaterial: OAK_PLANKS
MinimumQuantity: 6
MaximumDurability: 336
For standard vanilla items (e.g.
DIAMOND_SWORD) mcMMO auto-detects the repair material, item type, and durability from the material name. Those entries only needMinimumLevelandXpMultiplier. The full set of fields shown above is required for non-standard items such as the Shield, Elytra, and any custom/modded items.
| Field | Description |
|---|---|
MinimumLevel |
Minimum Repair skill level required to repair this item. |
XpMultiplier |
Multiplier applied to base Repair XP gained for this item. Higher = more XP per repair. |
ItemType |
TOOL or ARMOR — affects how Repair Mastery bonus is calculated. |
ItemMaterialCategory |
Material tier: WOOD, STONE, LEATHER, IRON, GOLD, DIAMOND, NETHERITE, STRING, OTHER. Determines base XP. |
RepairMaterial |
The Bukkit Material name of the item used on the anvil to repair it. |
MinimumQuantity |
Minimum number of repair materials consumed per repair attempt. |
MaximumDurability |
The item's maximum durability. Must match the actual Minecraft value. |
By default the file includes every repairable vanilla item grouped by material tier:
| Tier | Sample Items | Repair Material |
|---|---|---|
| Wood | Wooden sword, pickaxe, axe, shovel, hoe | OAK_PLANKS |
| Stone | Stone tools | COBBLESTONE |
| Leather | Leather helmet, chestplate, leggings, boots | LEATHER |
| Iron | Iron tools and armour | IRON_INGOT |
| Gold | Golden tools and armour | GOLD_INGOT |
| Diamond | Diamond tools and armour | DIAMOND |
| Netherite | Netherite tools and armour | NETHERITE_INGOT |
Other repairable items include the Elytra, Shield, Bow, Crossbow, Trident, and Fishing Rod.
RepairMaterial to any Bukkit Material name. For example, make DIAMOND_SWORD repairable with EMERALD.MinimumLevel to the desired Standard mode level.XpMultiplier (e.g. 2.0 for netherite items).Repairables: and fill in all required fields.
MinimumLevelis always specified in Standard mode units regardless of your server's level mode. Retro mode players see 10× this value in-game (e.g.MinimumLevel: 75= level 750 in Retro mode).
By default any player can repair an Elytra. To require Repair level 750 (Retro):
Repairables:
ELYTRA:
MinimumLevel: 75
XpMultiplier: 3
ItemType: OTHER
ItemMaterialCategory: OTHER
RepairMaterial: PHANTOM_MEMBRANE
MinimumQuantity: 8
MaximumDurability: 432
By default Tridents are repaired with Prismarine Crystals. To change this to Nautilus Shells:
Repairables:
TRIDENT:
MinimumLevel: 0
XpMultiplier: 3
ItemType: TOOL
ItemMaterialCategory: OTHER
RepairMaterial: NAUTILUS_SHELL
MinimumQuantity: 1
MaximumDurability: 250
Trident is not auto-detected from the material name, so all seven fields must be present in the entry. Change only the fields you want, keeping the rest at their defaults.
To make repairing Netherite Swords award twice as much XP as the default (default is 0.6), raise XpMultiplier:
Repairables:
NETHERITE_SWORD:
MinimumLevel: 0
XpMultiplier: 1.2
The two-field short form works for any standard vanilla item where mcMMO can auto-detect the repair material and durability.
For a hypothetical mod item MYTHRIL_SWORD with 2000 durability, repairable with Amethyst Shards:
Repairables:
MYTHRIL_SWORD:
MinimumLevel: 0
XpMultiplier: 2.0
ItemType: TOOL
ItemMaterialCategory: OTHER
RepairMaterial: AMETHYST_SHARD
MinimumQuantity: 2
MaximumDurability: 2000
See Mods Support for the full custom item workflow.