Scale Of Tools

A small client-side mod: warns you when your tool is about to break.

You're digging, building, fighting—and suddenly your shovel, pickaxe, or sword breaks at the most inopportune moment. Scale of Tools monitors the durability of your tool and displays a notification in advance, so you can repair or replace it.

Works on a clean client: no server installation required. This mod is fair—no cheats, just convenience.

How it works

• When the durability of the tool in your active hand drops below a threshold (default 10), a message appears in the action bar:
• "Almost broken: Diamond Pickaxe - 10 remaining"
• Both your primary and secondary hands are checked—the tool won't break unnoticed.
• To prevent spamming notifications during long digging sessions, they are repeated no more than once every 3 seconds (the interval is configurable). - Tools with "infinite" durability (e.g., enchanted netherite) are now correctly ignored.
• Tool shrinks with wear — the closer to breaking, the smaller the tool in your hand (in both first- and third-person). You can see it "deflate."
• Sticks after breaking — if a tool does break, sticks remain near the player: they lie on the ground for 5 seconds and disappear with a faint cloud. The number of sticks and the time before despawn are configurable.

Compatibility

• This mod is client-side and loads only on Fabric.
• The Fabric API is not required — fabric-loader is sufficient.
• Java 17 (for 1.20.1) or 21 (for 1.21.4).
• Vanilla servers require no modification.

Installation

1. Install Fabric Loader (fabricmc.net) for your version of Minecraft.
2. Download the mod's .jar for your version of the game (see the table above).
3. Place the jar in the .minecraft/mods folder.
4. Launch the game — warnings are enabled immediately.

Configuration

After the first launch, the file config/scaleoftools.json will appear. Parameters:

• durabilityWarn — on/off (default: true).
• durabilityThreshold — the remaining durability at which a warning is triggered (default 10).
• durabilityWarnInterval — the notification repeat interval in ticks (60 = 3 seconds).
• toolShrink — the tool shrinks as it wears (default true).
• toolShrinkMinScale — the minimum size at 0 durability (default 0.55).
• breakSticks — sticks after breaking (default true).
• breakStickCount — the number of sticks spawned (default 2).
• breakStickLifetimeTicks — the number of ticks the stick remains on the ground (100 = 5 seconds).

Example:

{
"durabilityWarn": true,
"durabilityThreshold": 10,
"durabilityWarnInterval": 60,
"toolShrink": true,
"toolShrinkMinScale": 0.55,
"breakSticks": true,
"breakStickCount": 2,
"breakStickLifetimeTicks": 100
}

Why "Scale of Tools"

Translated from Dutch, it means "scale of tools." This mod monitors the durability of your tool to ensure it never breaks unexpectedly.

Permissions and Distribution

• The mod is free and distributed under the MIT license.
• Can be included in modpacks with attribution.
• Free to modify/modify the code (sources in the repository).
• Repost on other platforms - please provide a link to the CurseForge page.

Technical details

• One MinecraftClientMixin mixin per tick + ScaleOfToolsEngine engine.
• Doesn't corrupt worlds or saves, easy to remove.