FAQ & Troubleshooting
My enchanted tools warn too early/late
Section titled “My enchanted tools warn too early/late”Check Settings.UnbreakingAware. When true (default), thresholds account for Unbreaking so a heavily-enchanted tool warns at the right real-world point. Turn it off to compare against the raw durability bar instead. See How Notifications Work.
Armor spams notifications at full durability
Section titled “Armor spams notifications at full durability”That was a bug fixed in v1.4 — update to the latest version. Notifications now only fire when a piece is genuinely below its threshold.
One item should have a different threshold
Section titled “One item should have a different threshold”Add an entry under Settings.ItemOverrides with that item’s uppercase material name. Overrides beat categories. See Thresholds & Categories.
How do I stop notifications for a specific item completely?
Section titled “How do I stop notifications for a specific item completely?”Either set Enabled: false in an ItemOverrides.<MATERIAL> block, or add the material to IgnoreItems.
Boss bar colour won’t change to my hex code
Section titled “Boss bar colour won’t change to my hex code”Minecraft only supports seven boss-bar colours (PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE) — hex isn’t possible for the bar graphic. The bar text does support hex. See Notification Channels.
A player doesn’t want notifications
Section titled “A player doesn’t want notifications”They can run /tn toggle (all off), or on PRO use /tn settings to mute individual channels. To exclude a whole group, revoke toolsnotifier.notify.
Do config changes need a restart?
Section titled “Do config changes need a restart?”No — run /tn reload. See Reloading.
What’s the difference between free and PRO?
Section titled “What’s the difference between free and PRO?”PRO adds the per-player preferences GUI, the periodic inventory scan, and the admin monitor. Everything else is in both. See Free vs PRO.
Does it work below 1.21?
Section titled “Does it work below 1.21?”api-version is 1.17, so it loads on 1.17+, but durability handling is tuned and tested for 1.21.