Skip to content

alazso/duraping

Repository files navigation

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.

Build Downloads Minecraft License

Modrinth CurseForge Source Discord


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

🔔 Multi-tier alerts Warn, Danger, and Critical thresholds, plus an emergency alert at 2 durability that bypasses snooze.
📺 Four alert channels Chat, custom sound, screen flash, and hotbar toast. Each one toggles independently.
🎒 Every slot watched Main hand, offhand, and all four armor pieces, every tick.
🤫 Smart anti-spam Per-tier cooldowns, hysteresis re-arming, and activity-aware quieting while you mine.
🎚️ Per-item thresholds Override warn, danger, and critical percentages for specific items by id.
⏱️ Snooze and toggle Keybinds to silence alerts for a few minutes or switch the mod off entirely.
🧩 In-game config A clean Mod Menu + Cloth Config screen on Fabric; a plain JSON file on both loaders.
🌍 Client-side only Works on vanilla servers, modded servers, and singleplayer. No server install.

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

Key Action
Numpad 7 Toggle DuraPing on or off
Numpad 8 Snooze for 5 minutes, or cancel an active snooze
Numpad 9 Show current main-hand durability
Numpad 0 Manual auto-swap trigger

Rebind any of these under Options, Controls, DuraPing.


Requirements

Loader Fabric or NeoForge
Minecraft 1.21.9, 1.21.10, or 1.21.11
Java 21

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.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages