Configurable Blacksmith GUI to repair your main-hand item or every repairable item in your inventory. Costs can mix Vault money, XP, and tier-matching materials. Optional rules remove or restrict Mending and vanilla anvil use so players rely on your menu. Paper and Folia 1.21 - 26.x
Support
Report bugs and get support here: https://discord.gg/VvM6k2eBDa
Features
• Folia support – safe scheduling for inventory and GUI actions on regionised servers.
• Repair GUI – repair the item in your main hand or all damaged or “shattered” (PDC) items in inventory and armor slots; live cost preview in the menu (MiniMessage,
gui/blacksmith-main.yml).• Economy costs – optional Vault flat fee plus cost scaled by missing durability percent; toggles per cost type.
• XP costs – optional flat XP per item plus XP per damage point repaired.
• Material costs – optional flat list per repair plus tier-based materials (wood, stone, gold, iron, diamond, netherite, leather, chainmail, tools, elytra, shield, etc.) with per-tier overrides in config.
• Repair cooldown – configurable millis between repairs to limit spam.
• Shattered items – persistent marker on items for a “broken until repaired” style; cleared when repaired through the plugin; admin commands to set or clear the marker on the held item.
• Vanilla controls (optional) – remove Mending from the game (loot, trades, enchanting, anvil preview, pickups, join strip), block only XP-Mending, redirect opening an anvil to the Blacksmith GUI, or block anvil repair, books, same-item merge, new enchants, or all operations; optional notify message; bypass permission for staff.
• Sounds – configurable success sound, volume, and pitch.
• Messages – MiniMessage in
messages.yml; reload without restart via admin command.Commands
/blacksmith – Open the Blacksmith repair menu (perfblacksmith.use)
/repair – Open the Blacksmith repair menu (perfblacksmith.use)
/perfblacksmith help – Show admin help (perfblacksmith.admin)
/perfblacksmith reload – Reload config, messages, and GUI files (perfblacksmith.admin)
/perfblacksmith setshattered – Mark the held item as shattered (PDC) (perfblacksmith.admin)
/perfblacksmith clearshattered – Remove shattered marker from the held item (perfblacksmith.admin)
