This Plugin allows you to repair armour/weapons/tools with the base item needed to craft the item and keep the enchantments. Repair costs depend on damage of the item, amount of base items needed to craft the item and the level of the enchantments. To repair an item, drop the item and the base item into the workbench. The result is the repaired item with enchantments. And almost everything is configurable!

No special block or construction needed. Just use the workbench to repair items.

Latest Dev Version: only Bukkit 1.7.9-R0.2 (beta)
Development builds of this project can be acquired at the provided continuous integration server. These builds have not been approved by the BukkitDev staff. Use them at your own risk.

Version 0.4.9 - Source - Download - only Bukkit 1.6.4-R2.0

Version 0.4.8-beta - Download - only Bukkit 1.6.1-R0.1

Version 0.4.7 - Source - Download - only Bukkit 1.5.2-R0.1, 1.5.2-R1.0

Version 0.4.6-beta - Download - only Bukkit 1.5.1-R0.1

Version 0.4.5-beta - Download - only Bukkit 1.4.7-R1.0

Version 0.4.4 - Download - only Bukkit 1.4.7-R1.0


  • One iron ingot repairs 1/3 of an iron pickaxe without enchantments.
  • One iron ingot repairs 1/9 of an iron pickaxe with a level 3 enchantment.

Usage explained by spitfire25565:


  • Repair items with base item and keep enchantments
  • Configure base item and amount needed for a item to repair **new**
  • Set a chance to randomly remove enchantments on repair (configurable globally and per group)
  • Configure the costs for enchantment repair (configurable global and per group)
  • Configure extra costs for special enchantments (configurable per enchant) **new**
  • Over-Repair - waste no base item and allow to get items repaired over 100% durability
  • Discounts for Groups - set a discount for your sponsors (configurable global and per group)

For every "per group" setting Vault is needed.

Default base items

  • iron ingot for all iron tools, weapons, armour and shears
  • iron ingot for chainmail armour (but cheaper than iron armour)
  • leather for leather armour
  • cobblestone for stone tools
  • wooden planks for wood tools
  • gold ingots for gold tools, weapons and armour
  • diamond for diamond tools, weapons and armour
  • string for bow and fishing rod


Put the RepairRecipe.jar into bukkits plugins folder. Configurations are setup automaticlly.

Standard Config is created automatically.



To allow Over-Repair set this to true (Default false)

allow_over_repair: false #or true


If you do not want to keep enchantments, set this to 0, if you want to keep them set to 100. (formerly as keep_enchantments: true/false)

Any value between is the chance you will keep the enchantments. But keep in mind, the dice can roll up to three times for each enchant. If you are lucky enough to keep the enchant, there will be another roll with the dice. If it hits you there, the enchant gets an random lower level. And don't trust the result view of the workbench. You can't forecast the roll!

keep_enchantments_chance: 100 #value between 0 (remove enchants) to 100 (keep enchants)
keep_enchantments_chance_groups: {} #set it to different values foreach group

You can set this chance for each permission group, if you are using Vault. For non defined groups the global default is used.

keep_enchantments_chance: 10 # be a lucky bastard to keep any enchantment
  Sponsor: 100 # but don't mess with sponsors!


Repairing items with enchantments is expensive. With this multiplier you can make it cheaper or make it even more expensive. If you set this to 0 there will be no extra costs to repair enchanted items.

enchant_multiplier: 100 #value between 0 (no extra costs for enchantments) and 200 (around 30 diamonds for a pick axe with a level 4 enchantment)
enchant_multiplier_groups: {}

Its now possible to set this enchantment multiplier per group if Vault is enabled. Is this option is used, enchant_multiplier is the fallback if the user has no group or if the group is not listed.

enchant_multiplier: 100 # around 15 diamonds for a pick axe with a level 4 enchantment
  Sponsor: 20 # around 5 diamonds for a pick axe with a level 4 enchantment


You think some enchantments should cost more than other? Or some enchants should be free? Then this option is for you!

special_enchant_multiplier: {} # default - all enchants have the same multiplier (100)

This multiplier is multiplied by `enchant_multiplier`. If you set `enchant_multiplier` to 0, this setting has no influence at all. Set this to for a enchant to 0 and this enchant will be free to repair.


    DURABILITY: 200 # value between 0 (for free) and 200


With use highest enchant you have another option to regulate the price for enchanted items. If this is set to false the `enchant_multiplier` will be multiplied by the sum of all the levels of the enchants on the item. For a tool with Unbreaking II, Fortune III and Efficiency IV this would be nine times `enchant_multiplier`. If you set this option to true, only the highest enchant counts and it would only be four times `enchant_multiplier`

use_highest_enchant: false # or true


With this option you can set discounts for the repair price. Its like the 10% bonus repair with the Minecraft repair function. A discount of 100 means it only costs one base item whatever the durability of the item is. If you turned on over repair the item will have a durability of 200% with discount 100. Use something like 80 to avoid this most of the time.

discount: 10 # value between 0 (no discount) to 100 (one base item)
discount_groups: {}

Like most of the settings you can set this for each permission group, if vault is activated.

discount: 10 # around 14 diamonds for a pick axe with a level 4 enchantment (multiplier 100)
  Sponsor: 25 # around 5 diamonds for a pick axe with a level 4 enchantment (multiplier 20)

base item configuration

If you want, it is possible to change the the base item and amount needed to repair an item with no enchants from 0% to 100% durability. To this base costs the enchantment costs will be added and after all the discount subtracted.

The item configuration is in the `items.yml`. If you remove an item there, it is not possible to repair it, until you add it again. But you can also additional items. If anyone wants to add none standard minecraft items, i will try to add this. Maybe it even works already? I have no experience with such plugins.

diamond_axe:            # this is the item you want to repair (possible are names or ids)
    base_item: diamond  # this is the base item, which you should add to the grid (possible are names or ids)
    base_amount: 3      # this is the amount of the base_item you need to repair the item from 0% to 100% durability

Because I like overkill, there are more options. None of the default recipes have this, so you have to manually add these if you want these. With these additional configs you can overwrite the repair behaviour for some special items. Like change the `keep_enchantments_chance`, `enchant_multiplier`, `allow_over_repair` and `use_highest_enchant`. This overwrites the default and group values for this setting. If you want the default/group values, remove the option or set it to `default`.

diamond_sword:                         # see above
    base_item: diamond                 # see above
    base_amount: 2                     # see above
    keep_enchantments_chance: default  # use the default value set in congig.yml (global/group)
    enchant_multiplier: 200            # repair costs for weapon enchantments are more valuable
    allow_over_repair: false           # you are a PVP Server? Definitely set this to false for all armour and weapons.
    use_highest_enchant: true          # high multiplier but only for the highest enchant, sounds fair?
    # more are coming (exp costs for repair? exp get for repair? economy costs? ...?)


MCStats is free, open source and anonymous. All data is public and freely available for every plugin. (


You are free to opt-out of submitting data whenever you wish. This will immediately stop sending data for any plugins that supports MCStats / Plugin Metrics. Simply edit plugins/PluginMetrics/config.yml and change opt-out: false to true
If you have any questions at all about how this service operates or anything else, please do visit us in IRC or email me directly: hidendra [at]


Player is allowed to repair items. Default: true
Player is allowed to keep enchantments. Player without this permission, can repair their items, but will lose all enchantments. Default: true
Player is allowed to over repair items. Default: false
Player can use the commands /repairrecipe reload and /repairrecipe debug


/repairrecipe reload
Reload the `config.yml` file. To reload `items.yml` restart the server.
/repairrecipe debug [true|false]
Enable debug mode. Many debug messages will appear in the server log and some to the player. Do not enable this as long as you do not want to report a bug.

Know Issues

  • none yet

Please post bugs at - this way I get a email right away! I dont check the comments here regulary.


Don't know if this will happen, as there issn't much support for any of the features.

  • get Exp from repairing items
  • Exp costs to repair enchantments
  • possibility to unenchant an item
  • add economy support (suggested by OriginalMadman @ #2) - feedback needed


I want to thank everyone who gives me feedback and tests the plugin. If you help me, I will add you to this list ;)


Posts Quoted:
Clear All Quotes

About This Project



Recent Files