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
MaterialType: 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, ARMOR, or OTHER; selects which repair permission node is checked (toolrepair, armorrepair, or otherrepair). |
MaterialType |
Material tier: WOOD, STONE, COPPER, LEATHER, IRON, GOLD, DIAMOND, NETHERITE, PRISMARINE, STRING, OTHER. Determines base XP. The legacy name ItemMaterialCategory is still accepted. |
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 |
| Copper | Copper tools and armour | COPPER_INGOT |
| 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_SCRAP |
Other repairable items include the Elytra, Shield, Mace, Bow, Crossbow, Trident, Carrot on a Stick, Warped Fungus on a Stick, 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 compared directly against the player's Repair level, using the same number in both Standard and Retro mode.MinimumLevel: 75requires Repair level 75 either way.
By default any player can repair an Elytra. To require Repair level 75:
Repairables:
ELYTRA:
MinimumLevel: 75
XpMultiplier: 3
ItemType: OTHER
MaterialType: 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
MaterialType: OTHER
RepairMaterial: NAUTILUS_SHELL
MinimumQuantity: 16
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
MaterialType: OTHER
RepairMaterial: AMETHYST_SHARD
MinimumQuantity: 2
MaximumDurability: 2000
See Mods Support for the full custom item workflow.