Tools Break Notifier PRO v1.6

---

What is ToolsNotifier PRO?
ToolsNotifier PRO watches every item your players use — tools, armor, elytra, bows, fishing rods, shears, and more — and sends a clear warning the moment durability gets dangerously low. Notifications arrive through up to four channels at once: chat, action bar, title, and boss bar with a live durability progress fill. The PRO edition adds a personal preferences GUI so players control exactly what they see, a background inventory scanner that catches gear even when it isn't held, and a live admin panel to monitor the entire server's gear health at a glance.

---

Features

• Four notification channels — Chat, Action Bar, Title, and Boss Bar can all be active simultaneously or mixed and matched in config
• Dual-level alert system — a configurable Warn threshold and a lower Critical threshold trigger distinct messages and sounds so players know exactly how urgent the situation is
• Per-category thresholds — Tools, Armor, and Elytra each have independent warn and critical percentage settings
• Per-item overrides — any Bukkit Material can have its own threshold or be excluded entirely via the ItemOverrides section
• Unbreaking-aware calculations — effective remaining durability is scaled by enchantment level so enchanted gear notifies at the right moment
• Boss Bar with live durability fill — the bar graphic fills proportionally to remaining durability; bar color is configurable (7 Minecraft colors) per alert level
• Full hex color support — all message fields accept &#RRGGBB hex codes alongside standard &k formatting codes
• Configurable sounds — separate sound, volume, and pitch for Warn and Critical events
• Broad event coverage — notifications fire on block breaking, combat hits, fire damage, fishing, flint-and-steel, shearing, and shooting
• PlaceholderAPI integration — exposes plugin placeholders for scoreboards, holograms, and other plugins
• Per-player preferences GUI PRO — /tn settings opens a 27-slot GUI to toggle Chat, Action Bar, Title, Boss Bar, Warn Sound, Critical Sound, and Inventory Scan per-player
• Admin-locked settings PRO — features disabled by the server admin in config show as locked in the player GUI and cannot be toggled on
• Inventory-wide scanner PRO — background task (default 30 s interval) scans every item in a player's full inventory, not just held or worn gear
• Admin gear monitor PRO — /tn admin opens a live 54-slot panel listing all online players with color-coded worst-gear status; click any player to inspect every damageable item they carry
• Live config reload — /tn reload applies all config changes instantly, no restart needed
• Ignore list — any material can be added to IgnoreItems to permanently silence it across all players

---

Commands
Aliases: /tn · /toolnotifier · /toolsnotifier

• /tn reload — Reload config.yml without restarting (toolsnotifier.reload — op)
• /tn toggle — Toggle all your own notifications on or off (toolsnotifier.toggle — default true)
• /tn status — Print durability of all held and worn items (toolsnotifier.status — default true)
• /tn settings — Open personal notification preferences GUI (toolsnotifier.pro.settings — default true) PRO
• /tn admin — Open live admin gear monitor for all online players (toolsnotifier.pro.admin — op) PRO

---

Permissions

• toolsnotifier.notify — Receive low-durability notifications (default: true)
• toolsnotifier.reload — Reload the plugin config (default: op)
• toolsnotifier.toggle — Toggle personal notifications on/off (default: true)
• toolsnotifier.status — Check durability status of gear (default: true)
• toolsnotifier.pro.settings — Open personal preferences GUI (default: true)
• toolsnotifier.pro.admin — Open admin gear monitoring GUI (default: op)

---

Requirements

• Paper 1.18-1.21.1 or newer (uses Adventure API — Spigot/Bukkit not supported)
• PlaceholderAPI — optional soft dependency

---

Setup

1. Drop ToolsNotifierPro-v1.6.jar into your plugins/ folder
2. Full server restart (not /reload)
3. Edit plugins/ToolsNotifierPro/config.yml — set thresholds, enable channels, customize messages
4. Enable Settings.BossBar.NotifyInBossBar: true if you want the boss bar channel
5. Run /tn reload after any config change to apply without restarting

---