What is BotchedDurability?
BotchedDurability lets you decide how long every tool, weapon, and piece of armor lasts. Set custom durability for vanilla items and your own registered items, show it in lore and on the durability bar, and let players repair for a price you choose.
Two enchantments, Reinforced and Fortified, give players a way to protect their favorite gear, the damage editor changes the attack damage and speed of any item, and rank-based bonuses reward your supporters. Durability and enchantments survive restarts, relogs, chests, and item drops.
What you can do
Custom durability
Set durability for vanilla items and registered custom items, or make items unbreakable. Tools lose exactly 1 durability per block or hit.
Damage editor
Change the attack damage and attack speed of any item, or set defaults for every item of a type.
Repairs your way
Repair and Repair All with per-item costs, paid with BotchedEconomy, any Vault economy, or emeralds.
Reinforced and Fortified
Two enchantments with levels I–V, applied with enchant books that players can buy.
Features
- Custom durability values for vanilla items and registered custom items
- Durability shown in item lore and on the durability bar
- Damage editor: set the attack damage and attack speed of any item, with per-material and per-custom-item defaults
- Repair and Repair All, with per-item repair costs
- Payments through BotchedEconomy, any Vault economy (EssentialsX, CMI and others), or emeralds when no economy is installed
- Armor only wears down from attacks, not from falls, fire, poison or drowning
- Mending, anvils and Self Repair restore durability too
- Unbreakable item support
- Rank-based durability bonuses with any permissions plugin
- Reinforced I–V and Fortified I–V enchantments
- Enchant books, including books players can buy
- Player and staff guide books with
/guideor/bdguide - PlaceholderAPI placeholders: %botcheddurability_<slot>_<value>%
- Nexo custom item compatibility
- Durability and enchantments persist through restarts, relogs, chest storage, and item drops
Commands
| Command | What it does |
|---|---|
/bd info | Show durability details for the held item |
/bd repair | Repair the held item |
/bd repairall | Repair all of your items |
/bd buybook | Buy an enchant book |
/guide, /bd guide [give] | Read the guide book, or get a physical copy |
| Command | What it does |
|---|---|
/bd register | Register a custom item |
/bd unregister | Remove a registered item |
/bd list | List registered items |
/bd give | Give a registered item |
/bd enchant | Apply a durability enchantment |
/bd givebook | Give an enchant book |
/bd guide staff | Read the staff guide |
/bd reload | Reload the configuration |
| Command | What it does |
|---|---|
/bd damage info | Show the held item’s damage and speed |
/bd damage set | add | multiply <amount> | Change attack damage |
/bd damage speed <value> | Set attack speed |
/bd damage setdefault <damage> [speed] | Apply to every item of that type |
/bd damage reset, /bd damage cleardefault | Undo an edit or a default |
Placeholders
With PlaceholderAPI installed, use %botcheddurability_<slot>_<value>% in scoreboards, tab lists and holograms. Example: %botcheddurability_held_percent%.
| Part | Options |
|---|---|
| Slot | held, offhand, helmet, chestplate, leggings, boots |
| Value | tracked, current, max, percent, reinforced, fortified, repair_cost |
Install in five steps
- Place BotchedDurability-1.4.3.jar in your server’s plugins folder.
- Start the server.
- Configure the plugin in config.yml.
- Reload or restart the server.
- Start registering your custom items.
The download includes README, COMMANDS, PERMISSIONS, CONFIG-GUIDE, and CHANGELOG guides, refreshed every time the server starts.
Requirements
| Area | Support |
|---|---|
| Server software | Paper 1.21.8 through 26.3, one jar (Paper forks such as Purpur work too) |
| Java | 21 or newer |
| Economy | BotchedEconomy or any Vault economy (optional, emeralds otherwise) |
| Items | Vanilla items and Nexo custom items |
| Placeholders | PlaceholderAPI (optional) |
Latest version
Download the latest jar right here, or grab it from Spigot. Both are the same file.
Cleaner help for players
Works with Paper 1.21.8 – 26.3
/bdon its own only lists the commands you can use. Players no longer see the staff commands
Earlier versions (4)
Guide book redesign
Works with Paper 1.21.8 – 26.3
- The guide book was redesigned to match the other Botched plugins
Documentation refresh
Works with Paper 1.21.8 – 26.3
- README, CONFIG-GUIDE and CHANGELOG now cover Vault economies, PlaceholderAPI placeholders and the guide books
- CONFIG-GUIDE explains
damage.vanilla, thecompatsection,use-vaultand the payment item names - The changelog now includes the 1.3.0 and 1.3.1 notes
- No gameplay changes. The files refresh in your plugin folder the next time the server starts
Guide books and worn-item fix
Works with Paper 1.21.8 – 26.3
- Player and staff guide books: read them with
/guideor/bd guide, addgivefor a physical copy. Books are never handed out automatically - The staff book needs
botcheddurability.guide.staff, andguide.ymlupdates live when edited - From 1.3.2: items that were already worn before tracking started keep their wear, so worn swords can’t be repaired for free
- From 1.3.1: PlaceholderAPI placeholders, left-clicking with a book breaks blocks again and right-click applies it to your offhand item
- From 1.3.0: Vault economies work again, and bought books drop at your feet when your inventory is full
Damage Editor + Paper 26.x support
Works with Paper 1.21.8 – 26.3
- New Damage Editor: change the attack damage and attack speed of any item
/bd damage set <amount>,/bd damage add, and/bd damage multiplyadjust damage/bd damage speed <value>sets attack speed/bd damage setdefault <damage> [speed]applies to every item of that type/bd damage reset,/bd damage cleardefault, and/bd damage info- Per-material and per-custom-item damage in
config.yml - Fresh installs now include default book prices, so
/bd buybookworks out of the box - Tested on Paper 1.21.8, 1.21.10, and 26.3
Screens









