RepairRecipe
RepairRecipe
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
Example
- 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:
Features
- 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
Installation
Put the RepairRecipe.jar into bukkits plugins folder. Configurations are setup automaticlly.
Standard Config is created automatically.
Configuration
allow_over_repair
To allow Over-Repair set this to true (Default false)
allow_over_repair: false #or true
keep_enchantments_chance
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 keep_enchantments_chance_groups: Sponsor: 100 # but don't mess with sponsors!
enchant_multiplier
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 enchant_multiplier_groups: Sponsor: 20 # around 5 diamonds for a pick axe with a level 4 enchantment
special_enchant_multiplier
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.
Possible values: PROTECTION_ENVIRONMENTAL, PROTECTION_FIRE, PROTECTION_FALL, PROTECTION_EXPLOSIONS, PROTECTION_PROJECTILE, OXYGEN, WATER_WORKER, DAMAGE_ALL, DAMAGE_UNDEAD, DAMAGE_ARTHROPODS, KNOCKBACK, FIRE_ASPECT, LOOT_BONUS_MOBS, DIG_SPEED, SILK_TOUCH, DURABILITY, LOOT_BONUS_BLOCKS
special_enchant_multiplier: DURABILITY: 200 # value between 0 (for free) and 200
use_highest_enchant
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
discount
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) discount: 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
MCStats is free, open source and anonymous. All data is public and freely available for every plugin. (http://mcstats.org/learn-more/)
Quote: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] mcstats.org
Permissions
- RepairRecipe.repair
- Player is allowed to repair items. Default: true
- RepairRecipe.repair.enchant
- Player is allowed to keep enchantments. Player without this permission, can repair their items, but will lose all enchantments. Default: true
- RepairRecipe.repair.overRepair
- Player is allowed to over repair items. Default: false
- RepairRecipe.admin
- Player can use the commands /repairrecipe reload and /repairrecipe debug
Commands
- /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 https://github.com/attrib/RepairRecipe/issues?state=open - this way I get a email right away! I dont check the comments here regulary.
TODO
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
Credits
I want to thank everyone who gives me feedback and tests the plugin. If you help me, I will add you to this list ;)
- Coding: attrib
- Tester: Cyprias, Maresi, TimeSpawning
- Video by spitfire25565
- Additional Feature Requests and Ideas: Maresi, OriginalMadman
hey, it didnt create the config files for me
We run cookbook & repairrecipe.
Before 1.5.1 they both worked together just fine, since 1.5.1 repairrecipe wont work with cookbook, any idea why or what needs to happen to make them work together?
Thanks!!!
I downloaded the latest dev Version (http://dl.bukkit.org/downloads/craftbukkit/view/02028_1.5.1-R0.1/) and used my last uploaded repairrecipe file and it works.
Can you please post further information - which dev version zou are using exaclty (eg. craftbukkit-1.5.1-R0.1-20130331.183223-29) and the full log? At best post it here: https://github.com/attrib/RepairRecipe/issues/25
@Mortalsinn
Just arrived back after some days holidays. Will check this tomorrow.
@OriginalMadman
Hey Originalmadman - by chance are you using spigot because that's what I am using, the latest dev version and I'm getting that error I posted below.
Hey, still love the plugin (at least my players do!) - but not even the dev version 0.4.6 works for latest 1.5.1 dev versions. Same error as guy below. Thanks for your efforts :)
any chance in updating this for the latest version? I think its because its R0.2 from the R0.1 even though they are both 1.5.1 that's messing it up - this is regards to my error below. My users are DYING for this back as we use Mythic Drops and this was the only repair plugin that worked well.
@attrib
The latest Development Version
@marubal21
You can try to add these in the config, but I never tried. You can give me a link to such a Plugin, maybe even a config (depends on how complicated the plugin is) and then I can try it, maybe on Monday.
@Mortalsinn
Which version/build of Bukkit? The 0.4.6 is for Bukkit 1.5.1-R0.1.
I've been getting this error on starup out of the blue. Any ideas??
Quick question, is it possible to add customs item such as weapons found in mods like Twilight Forest?
@Mortalsinn
Ups. Sorry forgot to remove the debug messages to check if the Event is now working. Removed it now and you can redownload the last version.
installed your plugin but getting weird log activity now - is this coming from your plugin???
Version 0.4.6-beta - Source - Download - only Bukkit 1.5.1-R0.1
@WickyServer
First release for 1.5.1-R0.1
@attrib
I reported the bug and it got fixed recently.
https://bukkit.atlassian.net/browse/BUKKIT-3849
https://github.com/Bukkit/Bukkit/commit/34648c5d00273058263f72eec250fe75ff11b154
Only bad part is.. gotta update to 1.5.1.
Heh, I love this plugin, and even if it isn't 1.5 yet, good things come to those who wait. Keep up the good work :D
I'm waiting the update for the 1.5.0, this plugin is so cool and very useful, rly good job!
@Varijon
Thanks for the commendation. I tried to update yesterday, after I finished the beta and came to the same conculsion like you did. Something with the crafting is currently broken in Bukkit. Couldn't figure you where the problem is as there aren't any API changes announced. Hopefully this is soon fixed by Bukkit, its still a dev-version.
Hey,
Just informing you this isn't working for the 1.5 dev builds, but pretty sure you know it breaks every minecraft version.
I tried simply updating the imports, it allowed the plugin to run, but the crafting didn't work ;/
We rely on this awesome plugin, because it allows people to keep their good tools and not worry about it eventually becoming too expensive too repair. It's also doing well in regard of balancing. As another bonus, not using the anvil means people can repair items with special formatting codes in the name, such as colours etc.
I hope you can update it soon, it's a very important plugin to us at the least.