✨ RepairTokens ✨HIGHLY CONFIGURABLE | PERMISSIONS | EASY SETUP

RepairTokens lets you create unlimited, fully customizable Repair Tokens — items players drag onto a damaged tool or piece of armor to restore its durability. Every token is config-driven: material, icon, name, lore, repair amount (flat or percentage), sound, particles, permission, cooldown, and even which items it's allowed to repair. Works in Survival, SkyBlock, Factions, Prison — any gamemode.

• Unlimited configurable tokens — define as many tiers as you want in config.yml: material, repair amount (flat number or a percentage of max durability), display name, lore, glow, particles, sound.
  
• Drag-and-drop repair — the classic mechanic: hold the token on your cursor and drag it onto a damaged tool or armor piece to repair it, right in your inventory.
  
• Repair-All tokens — flag a token as repairAll and it repairs every valid item in the player's inventory, armor, and offhand at once with Shift + Right-Click, instead of one item at a time.
  
• Multi-charge tokens — a single item can hold its own charge counter (e.g. "10 uses"), showing "Uses: 7/10" live in its lore as it's spent, instead of being a stack of one-shot items.
  
• Dynamic give amounts — /rt give <player> <token> <uses> [repairAmount] lets you mint a custom token on the spot: 10 charges at 100% repair each, or any combination you want, without touching config.
  
• Per-token restrictions — permission, cooldown, and an optional override of which materials that specific token can repair (independent of the global list).
  
• Global valid-items whitelist — control exactly which tools, weapons, and armor pieces are repairable at all.
  
• Vault economy support — price a token and let players buy it themselves with /rt buy.
  
• PlaceholderAPI support — expose token counts, names, durability values, and prices to scoreboards, GUIs, and other plugins.
  
• CombatLogX integration — optionally block repairing while a player is tagged in combat, fully toggleable in config.
  
• Offline-safe giving — /rt give an offline player and the token is queued and delivered automatically on their next login.
  
• Quick-give GUI — /rt gui opens a menu for admins to hand out tokens with a click, shift-click, or right-click for different quantities.
  
• MiniMessage + legacy support — every message and item name/lore accepts MiniMessage (gradients, hex colors) as well as classic & codes, auto-detected per line.
  
• English & Spanish out of the box — switch languages with one config line; drop in your own lang/<code>.yml to add more.
  
• Crash-proof config loading — a bad entry in config.yml is skipped with a clear console warning; it never takes down the rest of the plugin.
  
• Tested with MockBukkit — token creation, config parsing, and multi-charge logic are covered by an automated test suite.

Main command: /repairtoken — alias: /rt

• /rt — shows the command reference.
  
• /rt give <player> <token> <amount> [repairAmount] — give a token to a player (online or offline). For multi-charge tokens, amount is the number of charges on that item; repairAmount optionally overrides the repair-per-use amount (e.g. "100%").
  
• /rt giveall <token> <amount> [repairAmount] — same as give, to every online player.
  
• /rt buy <token> [amount] — purchase a priced token with Vault.
  
• /rt gui [player] — open the quick-give menu.
  
• /rt reload — safely reload the configuration.
  
• /rt list — list every configured token.
  
• /rt about — plugin info and current language.

Every command shows a bordered usage screen when run with the wrong arguments — no need to memorize syntax.

• repairtokens.admin.* (default: OP) — grants every admin permission below.
  
• repairtokens.admin.give (default: OP) — use /rt give.
  
• repairtokens.admin.giveall (default: OP) — use /rt giveall.
  
• repairtokens.admin.gui (default: OP) — use /rt gui.
  
• repairtokens.admin.reload (default: OP) — use /rt reload.
  
• repairtokens.admin.list (default: OP) — use /rt list.
  
• repairtokens.admin.about (default: true) — use /rt about.
  
• repairtokens.buy (default: true) — use /rt buy.
  
• Each token can also require its own custom permission (set per-token in config.yml) to actually be used.

Everything lives under plugins/RepairTokens/ and reloads live with /rt reload:

• config.yml — prefix, language selection, stackability, metrics toggle, combat-block toggle, every repair token definition, and the global valid-items whitelist.
  
• lang/en.yml + lang/es.yml — every player-facing message, fully translatable and MiniMessage-capable.

• Paper (or a Paper-based fork) 1.21.x, Java 21.
  
• Optional: Vault for /rt buy.
  
• Optional: PlaceholderAPI for placeholder support.
  
• Optional: CombatLogX to block repairing in combat.