DurabilityInfo

Welcome to DurabilityInfo — the mod that shows your item durability exactly where you need it.

Simply put your cursor over any tool, weapon, or piece of armor and you will instantly see exactly how much life it has left. In numbers, percentage, or a color-coded bar — you decide which parts to see.

---

Features

📊 Tooltip Display

Every damageable item gets extra information added directly to its tooltip:

• Durability Numbers — shows the exact remaining durability (e.g. Durability: 235 / 500)
• Percentage — displays a clean percentage (e.g. Durability: 47%)
• Color Bar — a visual bar that changes from green → yellow → red as durability decreases

Each of these three elements can be turned on or off independently. You can show just the numbers, just the percentage, just the bar, or any combination.

🖥️ Heads-Up Display (HUD)

An always-visible durability display on your screen that tracks everything you are wearing and holding:

Position	Item	What It Shows
1	Helmet	Durability bar + icon
2	Chestplate	Durability bar + icon
3	Leggings	Durability bar + icon
4	Boots	Durability bar + icon
5	Main Hand	Durability bar + icon
6	Offhand	Durability bar + icon

Each item is shown as a small icon with a colored bar underneath. The bar shrinks as durability drops and changes color — green when healthy, yellow when worn, red when almost broken.

Customize the HUD:
• Move it to any corner (Top-Left, Top-Right, Bottom-Left, Bottom-Right)
• Adjust its position with X and Y pixel offsets
• Switch between Bar mode or Percentage text mode
• A semi-transparent background keeps it readable on any terrain

⚠️ Low Durability Warning

No more sudden breakage. When any equipped item falls below your chosen durability threshold:

• The bar starts flashing bright red to catch your attention immediately
• A warning sound plays (the item break sound) so you hear it even while fighting or mining
• The sound has a 2-second cooldown — it warns you without becoming annoying
• The threshold is fully adjustable — set it to 5% for a late warning, 20% for early notice, or whatever feels right to you

🔧 Damage-Dealt Mode

Prefer to see how much you have used an item instead of how much is left? Toggle showDamageDealt on, and the HUD will display the amount of damage your item has taken. This is especially useful for players who think in terms of "this pickaxe has 500 uses left" versus "this pickaxe has been used 150 times."

---

Configuration

In-Game (Recommended)

If you have Mod Menu and Cloth Config installed, just open the Mods menu, find DurabilityInfo, and click the gear icon. All settings can be changed from there.

Config File

Located at .minecraft/config/durabilityinfo.json. You can edit it manually.

Tooltip Settings:

Setting	Default	Description
showDurabilityNumbers	true	Shows remaining durability as a fraction
showPercentage	true	Shows durability as a percentage
showBar	true	Shows a colored bar
showOnUnbreakable	false	Also show info on unbreakable items

HUD Settings:

Setting	Default	Description
warningThreshold	10	Percentage at which the warning activates
hudAnchor	BOTTOM_RIGHT	Screen corner for the HUD
hudOffsetX	4	Horizontal offset from the edge
hudOffsetY	4	Vertical offset from the edge
hudDisplayMode	BAR	Switch between BAR and PERCENTAGE view
showDamageDealt	false	Show damage taken instead of remaining

---

Requirements

• Minecraft 26.1.x (any sub-version)
• Fabric Loader 0.18.5 or newer
• Fabric API (any recent version)

Optional (Recommended)

• Mod Menu — browse and configure your mods
• Cloth Config — provides the configuration screen

Both are free and available on Modrinth and CurseForge.

---

License

This project is licensed under the MIT License — you are free to use, modify, and distribute it.