BreakWarn

BreakWarn quietly watches every damageable item you’re carrying and warns you the moment one is about to snap. No HUD clutter when nothing’s wrong, no spam when something is — just one alert per item, exactly when you need it.

What it does

• Monitors the 9 hotbar slots, the off-hand, and all 4 armor slots every tick.
• When the remaining durability of any monitored item drops to <= 10%, it fires a one-shot warning:
• Sound — a sharp anvil-land thud, so you notice even when you’re not looking at the corner.
• Action-bar message above the hotbar: “Tool almost broken: (%)”.
• HUD banner in the top-left for ~3.5 s: “About to break: (%)”.
• Each item gets exactly one warning per damage cycle. Repair it (anvil, grindstone, Mending) and BreakWarn will warn you again if the same item dips back below the threshold. Swap to a different item and the new item starts fresh.
• Built-in hysteresis: the warning resets at 20% remaining, so a hovering 9-11% item won’t spam you.

Controls

• B — toggle BreakWarn on/off. Action-bar confirmation tells you the current state.

Why

Caving with one good pickaxe, you find the ore vein — but eight blocks in, the pickaxe snaps and the diamonds vanish into the void. BreakWarn is the smallest possible fix: one banner, one sound, one alert per item, no config screens, no setup.

Notes

• Pure client-side — install on your client only. Works on any Fabric server, fully vanilla compatible.
• Sound and action-bar messages are suppressed while you’re in an inventory/menu, so opening your chest doesn’t spam alerts.
• The HUD banner respects F1 (hide HUD) and disappears on its own after a few seconds.
• ~180 lines of code, no config files, only Fabric API as a dependency.

Compatibility

Minecraft 1.21.8, 1.21.9, 1.21.10, 1.21.11 — Fabric Loader 0.16+. One JAR covers all four. Drop into your mods/ folder alongside Fabric API.