Minecraft Plugin · Available on Spigot

BotchedDurability

Take full control of durability and attack damage for vanilla and custom items, with fair wear, configurable repairs and two protective enchantments.

Spigot downloads
32
Website downloads
13
BotchedDurability artwork
Version
1.4.3
Platform
Paper 1.21.8 – 26.3
Price
Free
Works with
BotchedEconomy · Vault · PlaceholderAPI
Overview

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.

Highlights

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.

Everything included

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 /guide or /bd guide
  • PlaceholderAPI placeholders: %botcheddurability_<slot>_<value>%
  • Nexo custom item compatibility
  • Durability and enchantments persist through restarts, relogs, chest storage, and item drops
Reference

Commands

Player commands
CommandWhat it does
/bd infoShow durability details for the held item
/bd repairRepair the held item
/bd repairallRepair all of your items
/bd buybookBuy an enchant book
/guide, /bd guide [give]Read the guide book, or get a physical copy
Admin commands
CommandWhat it does
/bd registerRegister a custom item
/bd unregisterRemove a registered item
/bd listList registered items
/bd giveGive a registered item
/bd enchantApply a durability enchantment
/bd givebookGive an enchant book
/bd guide staffRead the staff guide
/bd reloadReload the configuration
Damage editor
CommandWhat it does
/bd damage infoShow 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 cleardefaultUndo an edit or a default
PlaceholderAPI

Placeholders

With PlaceholderAPI installed, use %botcheddurability_<slot>_<value>% in scoreboards, tab lists and holograms. Example: %botcheddurability_held_percent%.

PartOptions
Slotheld, offhand, helmet, chestplate, leggings, boots
Valuetracked, current, max, percent, reinforced, fortified, repair_cost
Setup

Install in five steps

  1. Place BotchedDurability-1.4.3.jar in your server’s plugins folder.
  2. Start the server.
  3. Configure the plugin in config.yml.
  4. Reload or restart the server.
  5. Start registering your custom items.

The download includes README, COMMANDS, PERMISSIONS, CONFIG-GUIDE, and CHANGELOG guides, refreshed every time the server starts.

Compatibility

Requirements

AreaSupport
Server softwarePaper 1.21.8 through 26.3, one jar (Paper forks such as Purpur work too)
Java21 or newer
EconomyBotchedEconomy or any Vault economy (optional, emeralds otherwise)
ItemsVanilla items and Nexo custom items
PlaceholdersPlaceholderAPI (optional)
Updates

Latest version

Download the latest jar right here, or grab it from Spigot. Both are the same file.

v1.4.3Latest

Cleaner help for players

Works with Paper 1.21.8 – 26.3

  • /bd on its own only lists the commands you can use. Players no longer see the staff commands
  • BotchedDurability-1.4.3.jarUniversal build · Java 21 · 117.3 KB Download
Earlier versions (4)
v1.4.2

Guide book redesign

Works with Paper 1.21.8 – 26.3

  • The guide book was redesigned to match the other Botched plugins
v1.4.1

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, the compat section, use-vault and 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
  • BotchedDurability-1.4.1.jarUniversal build · Java 21 · 108.7 KB Download
v1.4.0

Guide books and worn-item fix

Works with Paper 1.21.8 – 26.3

  • Player and staff guide books: read them with /guide or /bd guide, add give for a physical copy. Books are never handed out automatically
  • The staff book needs botcheddurability.guide.staff, and guide.yml updates 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
  • BotchedDurability-1.4.0.jarUniversal build · Java 21 · 107.3 KB Download
v1.1.1

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 multiply adjust 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 buybook works out of the box
  • Tested on Paper 1.21.8, 1.21.10, and 26.3
  • BotchedDurability-1.1.1.jarUniversal build · Java 21 · 51.6 KB Download