![Tools Break Notifier ⛏️ [FREE]](https://www.spigotmc.org/data/resource_icons/107/107417.jpg?1673903668){kind=icon}
- Notify the player in a chat message, Title, Action Bar or Boss Bar (each can be turned on/off in config.yml)
- Two severity levels — WARN and CRITICAL thresholds with separate messages, titles and sounds per level
- Per-category thresholds — set different warn and critical percentages for Tools, Armor and Elytra independently
- Per-item overrides — set a custom threshold or completely disable notifications for any specific item
- Unbreaking-aware thresholds — when enabled, effective durability is scaled by enchantment level so enchanted tools notify much later
- Per-item cooldown — each item type has its own independent cooldown; using a pickaxe won't suppress your sword notifications
- Ignore list — block specific items or item types from ever triggering notifications
- Off-hand tracking — flint & steel and shears are tracked when used from the off-hand slot
- Permission support — restrict notifications to specific player groups (e.g. VIPs only)
- Customizable sound per severity level with volume and pitch
- Fully customizable messages with color codes and RGB hex
- Config validation — invalid percentage ranges or negative delay values are logged as warnings on reload
- PlaceholderAPI support — expose durability and notification state to other plugins
- /tn toggle — players can enable/disable their own notifications; persists through relogs
- /tn status — shows durability of every held and worn item, colour-coded by severity
- /tn reload — apply config changes without restarting the server
- /toolsnotifier — show plugin version and author
- /toolsnotifier reload — reload config.yml from disk
- /toolsnotifier toggle — toggle your own durability notifications on/off
- /toolsnotifier status — check durability of all held and worn items
Permissions:
- toolsnotifier.notify — receive low-durability notifications (default: true)
- toolsnotifier.reload — use /tn reload (default: op)
- toolsnotifier.toggle — use /tn toggle (default: true)
- toolsnotifier.status — use /tn status (default: true)
- %toolsnotifier_mainhand_durability% — remaining durability of main-hand item
- %toolsnotifier_mainhand_max% — max durability of main-hand item
- %toolsnotifier_mainhand_percent% — durability percentage of main-hand item
- %toolsnotifier_mainhand_level% — current severity: none, warn or critical
- %toolsnotifier_offhand_*% — same set for off-hand item
- %toolsnotifier_notifications_enabled% — true / false based on /tn toggle state
- To ignore all shovels, write "SHOVEL" into IgnoreItems
- To ignore a specific item, write its full name: GOLDEN_AXE, ELYTRA, ...
- To disable the ignore list, leave an empty line: - ''
Set different warn and critical thresholds per category — or override for any specific material:
Code (Text):
Settings:
Categories:
Tools:
Enabled: true
Percentage: 90 # warn when tool has ≤ 90% durability left
CriticalPercentage: 10 # critical when ≤ 10%
Armor:
Enabled: true
Percentage: 50
CriticalPercentage: 10
Elytra:
Enabled: true
Percentage: 20
CriticalPercentage: 5
ItemOverrides:
DIAMOND_PICKAXE:
Percentage: 50 # custom warn threshold for diamond pickaxe
CriticalPercentage: 5
ELYTRA:
Enabled: false # never notify about elytra
Message placeholders:
- {0} — item display name
- {1} — remaining durability
- {2} — max durability
- {3} — remaining durability as a percentage
Code (Text):
Settings:
NotifyInActionBar: true
NotifyInMessage: true
NotifyIfBelowPercentage: 90 # global warn fallback
CriticalIfBelowPercentage: 10 # global critical fallback
NotifyDelayInSeconds: 3
UnbreakingAware: true # scale threshold by Unbreaking enchant level
Categories:
Tools:
Enabled: true
Percentage: 90
CriticalPercentage: 10
Armor:
Enabled: true
Percentage: 50
CriticalPercentage: 10
Elytra:
Enabled: true
Percentage: 20
CriticalPercentage: 5
ItemOverrides:
DIAMOND_PICKAXE:
Enabled: true
Percentage: 50
ELYTRA:
Enabled: false
Title:
NotifyInTitle: true
FadeInTime: 5
StayOnScreenTime: 20
FadeOutTime: 10
BossBar:
NotifyInBossBar: false
DurationTicks: 60
IgnoreItems:
- ''
Messages:
ChatMessage:
- 'a271dToolNotifier &8&l» &cBe careful!'
- ' &7Your d7a25{0} &7is about to break (d7a25{1}&7/{2})!'
ActionBarMessage: '{0} &7is about to break (d7a25{1}&7/{2})!'
Title:
MainMessage: '4C1CDCareful {3}% to break!'
SubMessage: 'a271d{0} is about to break ({1}/{2})!'
BossBarMessage: '&e⚠ {0} is about to break! ({1}/{2})'
Critical:
ChatMessage:
- 'a271dToolNotifier &8&l» &4&lCRITICAL!'
- ' &7Your &#ff0000{0} &7is about to BREAK (&#ff0000{1}&7/{2})!'
ActionBarMessage: '&4&l{0} CRITICAL! ({1}/{2})'
Title:
MainMessage: '&4&l{0} BREAKING!'
SubMessage: '&#ff0000{1}/{2} durability left!'
BossBarMessage: '&4&l⚠ {0} about to break! ({1}/{2})'
Sounds:
Warn: ENTITY_CHICKEN_EGG/0.5/1.0
Critical: ENTITY_ITEM_BREAK/1.0/1.0
If you like this plugin, feel free to review and share it with your friends! I appreciate all kinds of support. Thank you!
If you find any bugs or errors, please send me a private message before leaving a review. I'll do my best to fix it fast!
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.16, 1.17, 1.18
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
Tools Break Notifier ⛏️ [FREE] is a free Minecraft Java mod. Compatible with Minecraft 1.16, 1.17, 1.18, 1.19 and newer. Downloaded 1,182 times (via Spigot). Download it and open it directly in the game.