Tools Break Notifier ⛏️ [FREE]

Features:

• 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

Commands:

• /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

Aliases: /tn, /toolnotifier
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)

PlaceholderAPI placeholders:

• %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

Ignore List Usage:

• 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: - ''

Per-category & per-item configuration:
Set different warn and critical thresholds per category — or override for any specific material:

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

Resolution order: ItemOverrides > Categories > global
Message placeholders:

• {0} — item display name
• {1} — remaining durability
• {2} — max durability
• {3} — remaining durability as a percentage

Full config.yml:

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:
    - '&#7a271dToolNotifier &8&l» &cBe careful!'
    - '  &7Your &#1d7a25{0} &7is about to break (&#1d7a25{1}&7/{2})!'
  ActionBarMessage: '{0} &7is about to break (&#1d7a25{1}&7/{2})!'
  Title:
    MainMessage: '&#52C1CDCareful {3}% to break!'
    SubMessage: '&#7a271d{0} is about to break ({1}/{2})!'
  BossBarMessage: '&e⚠ {0} is about to break! ({1}/{2})'
  Critical:
    ChatMessage:
      - '&#7a271dToolNotifier &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!