Repair

Repair lets you fix damaged tools, weapons, and armor at an mcMMO repair anvil using the right raw material. No enchanting table or anvil XP cost required. As you level, each repair patches up more durability (Repair Mastery), sometimes repairs twice as much for free (Super Repair), and learns to protect the enchantments on your gear (Arcane Forging).

You train Repair simply by repairing items. The more valuable the material and the more durability you restore, the more XP you earn.

How repairing works

1. Place down the repair anvil (an Iron Block by default, configurable via config.yml).
2. Hold the damaged item in your hand.
3. Make sure you're carrying the correct repair material (e.g. iron ingots for iron gear, diamonds for diamond gear).
4. Right-click the anvil. mcMMO consumes one repair material and restores durability.

A few rules enforced by the code:

• You can only repair an item if your Repair level meets that item's minimum level requirement.
• Items must be un-stacked (a single item, not a stack).
• Unbreakable items can't be repaired.
• Each repair consumes exactly one unit of the repair material.
• By default a confirmation click is required: the first right-click warns you, the second within ~3 seconds actually repairs (Repair_Confirm_Required in config.yml).

Repair Mastery: patch more per repair

Repair Mastery increases how much durability each repair restores. Without it, an item gets back its base repair amount; with it, that amount is multiplied up as you level.

The bonus scales linearly with level up to its cap:

bonus % = min( 2 × (level ÷ 100) , 2.0 )   →  expressed as a fraction
repair restored = base amount × (1 + bonus)

With the defaults (MaxBonusPercentage: 200), the bonus is level ÷ 50 percent-as-a-fraction, capping at 2.0 (i.e. +200%) at level 100 Standard. So:

Repair:
    RepairMastery:
        MaxBonusPercentage: 200.0
        MaxBonusLevel:
            Standard: 100
            RetroMode: 1000

Repair Mastery is unlocked from level 1.

Super Repair: a chance to repair double

Super Repair gives a chance, on each repair, to double the durability restored for that single repair: same material cost, twice the patch. It's a per-repair proc, not a timed ability.

The chance ramps from 0% at unlock up to 100% at the cap, so a maxed-out Repair player gets the Super Repair bonus on every repair. When it fires you'll see a "felt easy" message.

Repair:
    SuperRepair:
        ChanceMax: 100.0
        MaxBonusLevel:
            Standard: 100
            RetroMode: 1000

Arcane Forging: keep your enchantments

Normally, repairing an enchanted item on an mcMMO anvil risks the enchantments. Arcane Forging is what gives you a chance to keep them, and, failing that, a chance to merely downgrade them by one level instead of losing them outright.

Without any Arcane Forging rank (or with the sub-skill disabled), repairing an enchanted item strips all enchantments. Arcane Forging changes that.

Arcane Forging ranks unlock at these Repair levels:

How each enchantment on the item is resolved when you repair it:

1. Roll the keep-enchant chance for that rank.
   • Fail → the enchantment is removed.
   • Succeed → the enchantment stays, but then a downgrade check runs (if downgrades are enabled and the enchant is level 2+). The downgrade chance is the complement of the "Downgrades_Chance" value, so the table above shows the effective chance the kept enchant drops by one level.

Repair:
    ArcaneForging:
        May_Lose_Enchants: true
        MaxEnchantLevel: 5          # caps kept/downgraded enchants at vanilla max by default
        Keep_Enchants_Chance:
            Rank_1: 10.0
            # ... up to Rank_8: 60.0
        Downgrades_Enabled: true
        Downgrades_Chance:
            Rank_1: 75.0
            # ... down to Rank_8: 10.0

By default Arcane Forging caps any kept or downgraded enchantment at level 5 (MaxEnchantLevel: 5), matching vanilla limits. This can be overridden by ExploitFix.UnsafeEnchantments in experience.yml.

Earning XP

Repair XP is paid out based on how much of the item's total durability you restored and what material it's made of. The formula in the source is:

XP = percentage of max durability repaired
     × item's XP multiplier
     × Repair XP base (1000)
     × material XP multiplier

The base is 1000.0, and each material has its own multiplier from experience.yml:

So repairing a heavily damaged diamond or netherite item gives far more XP than topping up a wooden tool. Because XP is proportional to the fraction of durability restored, fully repairing a nearly-broken item pays the most.

Experience_Values:
    Repair:
        Base: 1000.0
        Diamond: 5.0
        Netherite: 6.0
        # ...

Commands & permissions

Repair has fine-grained per-material and per-item-type nodes (e.g. mcmmo.ability.repair.diamondrepair, mcmmo.ability.repair.armorrepair), so server owners can restrict what a player is allowed to repair. See Permissions for the full list.

Quick reference