DuraPing

DuraPing

Never break your favorite gear again. Timely durability alerts through chat, sound, screen flash, or hotbar toast, the moment a tool, weapon, or armor piece runs low.

DuraPing is a client-side quality-of-life mod that watches the durability of everything you have equipped and warns you before it breaks. Pick how you want to be told (chat, sound, a screen flash, or a hotbar toast), set the thresholds that matter to you, and stop losing enchanted gear to one swing too many. It runs on Fabric and NeoForge, needs nothing on the server, and stays out of your way until your gear is actually in danger.

At a glance

Every feature

Alerts

• Multi-tier thresholds: Warn (25%), Danger (10%), and Critical (5%) by default, each with its own color and cooldown.
• Emergency alert at 2 durability: ignores snooze, flashes the screen, repeats the critical sound, and prints a banner so you cannot miss it.
• Chat messages with the item name and exact uses remaining.
• Custom sounds for warn and critical, with subtitle support.
• Screen flash: a brief, low-opacity vignette for a glance-free heads-up.
• Hotbar toast messages for a quieter, text-only nudge.

Smart monitoring

• Watches the main hand, offhand, and all armor continuously.
• Fires once on a downward threshold crossing, then re-arms only after you recover, with configurable hysteresis for Mending or modded durability regen.
• Activity-aware mode stretches warn and danger cooldowns while you are continuously mining, so a long dig does not spam you.
• Optional quiet-below-warn: visual-only alerts in the warn tier, no sound or chat.

Customization

• Per-item overrides: different thresholds for an elytra, a netherite pickaxe, or anything else, keyed by item id.
• Tunable thresholds, per-tier cooldowns, and snooze duration.
• In-game config screen on Fabric via Mod Menu and Cloth Config. On NeoForge, edit the config file directly.

Controls

• Keybinds to toggle, snooze or cancel, and show main-hand durability on demand (defaults on the numpad, fully rebindable).

Auto-swap (off by default)

• Swaps a worn-down tool or armor piece for a more durable copy from your inventory, through server-synced inventory actions that hold up on real servers.

Configuration

The config lives at config/duraping.json and is created on first launch.

{
  "enabled": true,
  "chat": true,
  "sound": true,
  "flash": false,
  "toast": false,
  "warn": 25,
  "danger": 10,
  "critical": 5,
  "warnCooldownSec": 30,
  "dangerCooldownSec": 15,
  "criticalCooldownSec": 7,
  "overrides": {
    "minecraft:elytra": { "warn": 15, "danger": 7, "critical": 1 }
  }
}

On Fabric you can edit everything live from Escape, Mods, DuraPing, Config (requires Mod Menu and Cloth Config). Per-item overrides use the namespaced item id, for example minecraft:netherite_pickaxe.

Keybinds

Rebind any of these under Options, Controls, DuraPing.

Requirements

Optional (Fabric): Mod Menu and Cloth Config for the in-game settings screen. Everything works without them through the config file.

Multiplayer

DuraPing is fully client-side. It reads only your own inventory and never talks to the server, so it works on vanilla servers, modded servers that do not have it, and in singleplayer, with no permissions or server-side install required.

Found a bug? Have an idea?

Bug reports and feature ideas are welcome. Open a GitHub issue with your loader and Minecraft version, your DuraPing version, and any relevant console output. For quick questions or to help test, join the Discord.

Released under the MIT License.

DuraPing

Never break your favorite gear again. Timely durability alerts through chat, sound, screen flash, or hotbar toast, the moment a tool, weapon, or armor piece runs low.

DuraPing is a client-side quality-of-life mod that watches the durability of everything you have equipped and warns you before it breaks. Pick how you want to be told (chat, sound, a screen flash, or a hotbar toast), set the thresholds that matter to you, and stop losing enchanted gear to one swing too many. It runs on Fabric and NeoForge, needs nothing on the server, and stays out of your way until your gear is actually in danger.

At a glance

Every feature

Alerts

• Multi-tier thresholds: Warn (25%), Danger (10%), and Critical (5%) by default, each with its own color and cooldown.
• Emergency alert at 2 durability: ignores snooze and uses every alert type you have on: a banner in chat, a layered critical sound, and a strong flash and toast if you enabled them.
• Chat messages with the item name and exact uses remaining.
• Custom sounds for warn and critical.
• Screen flash: a brief, low-opacity white overlay across the whole screen for a glance-free heads-up.
• Hotbar toast messages for a quieter, text-only nudge.

Smart monitoring

• Watches the main hand, offhand, and all armor continuously.
• Warn and danger fire once on a downward threshold crossing, then re-arm only after you recover, with configurable hysteresis for Mending or modded durability regen. Critical keeps repeating on its cooldown (every 7 seconds by default) until you repair or swap the item, or snooze.
• While you are mining, warn and danger alert once as you cross them, so a long dig does not spam you. Danger also repeats on its cooldown while a single block takes 2 seconds or more to break, such as obsidian.
• Optional quiet-below-warn: each drop into the warn tier still alerts normally, and warn reminders after that are visual-only (flash or toast), no sound or chat.

Customization

• Per-item overrides: different thresholds for an elytra, a netherite pickaxe, or anything else, keyed by item id.
• Tunable thresholds, per-tier cooldowns, and snooze duration.
• In-game config screen on both loaders via Cloth Config: Fabric through Mod Menu, NeoForge through the Mods list (Mods → DuraPing → Config). The JSON config file still works everywhere.

Controls

• Keybinds to toggle, snooze or cancel, and show main-hand durability on demand (defaults on the numpad, fully rebindable).

Auto-swap (off by default)

• Swaps a worn-down tool for a more durable copy of the same item when you hit or use a block, and worn-down armor for a more durable piece that fits the slot. That piece can be a lower tier unless you turn off Allow Lower Quality, and a worn elytra can be replaced by a chestplate, never another elytra. Uses server-synced inventory actions that hold up on real servers.

Configuration

The config lives at config/duraping.json and is created on first launch with every setting. This excerpt shows the main keys at their defaults, plus an example elytra override (overrides is empty by default). Edit the file with the game closed: it is read once at startup, and toggling DuraPing or saving the config screen overwrites it.

{
  "enabled": true,
  "chat": true,
  "sound": true,
  "flash": false,
  "toast": false,
  "warn": 25,
  "danger": 10,
  "critical": 5,
  "warnCooldownSec": 30,
  "dangerCooldownSec": 15,
  "criticalCooldownSec": 7,
  "overrides": {
    "minecraft:elytra": { "warn": 15, "danger": 7, "critical": 1 }
  }
}

You can change every setting except per-item overrides live from the in-game config screen: Escape → Mods → DuraPing, then Config on NeoForge or the sliders icon on Fabric (Fabric also needs Mod Menu; both need Cloth Config). On 26.2 and 26.3, Mods is an icon in the pause menu. Per-item overrides go in the JSON file, keyed by the namespaced item id, for example minecraft:netherite_pickaxe.

Keybinds

Rebind any of these under Options, Controls, Key Binds, Miscellaneous.

Requirements

Files are split by Minecraft version and loader, so pick the one that matches your game on Modrinth or CurseForge. On NeoForge, the 26.1 line needs 26.1.2. On Fabric, 26.3 needs Fabric Loader 0.19.3 or newer.

On NeoForge, two builds crash when you click Mods, with or without DuraPing installed: 21.9.16-beta (Minecraft 1.21.9) and 21.10.0-beta (Minecraft 1.21.10). This is a NeoForge bug. Use 21.9.15-beta on 1.21.9, and 21.10.1-beta or newer on 1.21.10. DuraPing still runs on the affected builds, but its config screen can't be opened there, so change settings in config/duraping.json and restart the game.

Optional: Cloth Config for the in-game settings screen (plus Mod Menu on Fabric). Everything works without them through the config file.

Multiplayer

DuraPing is fully client-side. Its alerts read only your own inventory, so it works on vanilla servers, modded servers that do not have it, and in singleplayer, with no permissions or server-side install required. The 26.x builds also send the usage metrics described below.

Usage metrics

The 26.x builds report pseudonymous usage statistics to FastStats: a random id, the game, mod and loader versions, the loader name, the Java version and vendor, the operating system name, version and architecture, the CPU core count, the number of players on the current server or world, whether the launcher reports a signed-in online account, DuraPing's mod id, and that this is a client. The id is stored in config/faststats/config.properties, stays the same until that file is deleted, and is shared by every FastStats mod in the instance. FastStats also records an approximate country for each install, inferred by Cloudflare, and says it does not store your IP address. The totals are public on the DuraPing dashboard.

The 1.21.x builds do not include FastStats, and DuraPing's copy does not load on Fabric 26.1 or 26.1.1.

In an instance without that file, nothing is sent on the first launch unless you open the FastStats screen and press Done with metrics still on. The first report then goes out at the next scheduled send, normally 30 minutes after launch, or when the game closes on Fabric. Otherwise a report is sent about 30 seconds after launch and every 30 minutes after that. On Fabric, another report is sent when the game closes.

To opt out, open Options, Telemetry Data, FastStats, untick the boxes, and press Done, or set enabled=false in config/faststats/config.properties and restart. If Telemetry Data is greyed out, which happens on offline accounts and accounts with telemetry turned off, use the config file. Either one applies to every FastStats mod in the instance.

Found a bug? Have an idea?

Bug reports and feature ideas are welcome. Post them in the Discord with your loader and Minecraft version, your DuraPing version, and any relevant console output. It is also the place for quick questions and helping test.