🛡️ Durability Multiplier

"Stop babysitting your tools. Multiply durability or go God Mode — it's just a GameRule away."

---

📖 Introduction

Crafting top-tier Diamond or Netherite gear, enchanting it with Mending and Unbreaking, and grinding hundreds of hours of survival — only to watch your durability bar drain in a single quarry run. Vanilla tool degradation punishes dedication.

Durability Multiplier eliminates equipment burnout under the Instant Gratification design philosophy. Rather than altering item NBT data or breaking save compatibility, it intercepts durability damage at the source using a single lightweight ItemStack.hurtAndBreak Mixin. Every durability drain event is scaled by a server-wide percentage multiplier you control — no NBT edits, no world corruption, safe to add or remove at any time.

[!NOTE] 1 Jar 1 Version Policy: I build 1 dedicated JAR for each Minecraft version (e.g. MC 26.2, MC 26.3). Please download the exact build that matches your Minecraft installation.

Survival World Safe: Safe to add or remove at any time! Gear scales dynamically at runtime; no permanent item NBT or save file changes.

Part of the Instant Gratification Collection — mods that respect your time.

---

✨ Features

🔢 Percentage-Based Durability Scaling

The core mechanic uses integer percentage values rather than arbitrary multipliers:

• 100% = vanilla durability (no change)
• 200% = 2x durability (items last twice as long)
• 400% = 4x durability
• 50% = half durability (items wear faster)
• -1 = Single-Use / Glass Mode (item breaks on first use)

The default is 200% (2x global durability) — a balanced vanilla+ baseline that doubles tool lifespans without making gear feel free.

♾️ Three Durability Modes Per Category

Every item category supports three independent modes, configurable via GameRule:

Mode	GameRule Type	Effect
Percentage (ig:dm_percent_*)	Integer	Scale durability. 100 = vanilla, 200 = 2x, 50 = 0.5x, -1 = single-use
Infinity / God Mode (ig:dm_infinity_*)	Boolean	Item never takes damage. Overrides percentage.
Single-Use / Glass Mode (ig:dm_single_use_*)	Boolean	Item breaks on first use. Overrides percentage.

🗂️ Fine-Grained Category Hierarchy

Control each gear type independently with a clean priority chain: per-item override → sub-type → category group → global fallback.

Weapons: Swords, Spears, Tridents, Maces, Bows, Crossbows, Shields Tools: Pickaxes, Axes, Shovels, Hoes, Shears, Fishing Rods, Brushes, Flint & Steel Armor: Helmets, Chestplates, Leggings, Boots Flight: Elytra

🧩 Modded Item Support

Durability Multiplier auto-discovers all damageable modded items from other mods at startup via DynamicRegistryScanner. Each mod item gets its own dynamic GameRules (ig:percent_<namespace>_<path>, ig:infinity_<namespace>_<path>, ig:single_use_<namespace>_<path>), giving you per-item surgical control over every modded tool and weapon.

💬 Durability Tooltip

An optional in-game tooltip displays the active multiplier or mode label on every affected item. Toggle with ig:dm_show_tooltip. Display format is configurable: ADAPTIVE (auto-switches between Nx and %), PERCENTAGE, or MULTIPLIER.

⚙️ Optional Config GUI

Install ModMenu + YetAnotherConfigLib (optional, not required) for a full in-game config screen without needing to edit JSON files or use commands.

---

🎮 GameRule Reference

Set any rule in-game with /gamerule <key> <value>. No server restart required.

Global & Category Rules

GameRule Key	Type	Default	Description
ig:dm_percent_global	Integer	200	Global fallback for all items (100 = vanilla, 200 = 2x, -1 = single-use)
ig:dm_percent_weapons	Integer	0	Weapon category fallback (0 = defer to global)
ig:dm_percent_tools	Integer	0	Tool category fallback
ig:dm_percent_armor	Integer	0	Armor category fallback
ig:dm_percent_elytra	Integer	0	Elytra-specific percentage
ig:dm_infinity_global	Boolean	false	God Mode for all items
ig:dm_single_use_global	Boolean	false	Glass Mode for all items
ig:dm_show_tooltip	Boolean	true	Show active multiplier in item tooltip

Sub-Type Rules (Weapons)

GameRule Key	Items
ig:dm_percent_swords	Swords
ig:dm_percent_spears	Spears
ig:dm_percent_tridents	Tridents
ig:dm_percent_maces	Maces
ig:dm_percent_bows	Bows
ig:dm_percent_crossbows	Crossbows
ig:dm_percent_shields	Shields

Sub-Type Rules (Tools)

GameRule Key	Items
ig:dm_percent_pickaxes	Pickaxes
ig:dm_percent_axes	Axes
ig:dm_percent_shovels	Shovels
ig:dm_percent_hoes	Hoes
ig:dm_percent_shears	Shears
ig:dm_percent_fishing_rods	Fishing Rods
ig:dm_percent_brushes	Brushes
ig:dm_percent_flint_and_steel	Flint & Steel

Sub-Type Rules (Armor)

GameRule Key	Items
ig:dm_percent_helmets	Helmets
ig:dm_percent_chestplates	Chestplates
ig:dm_percent_leggings	Leggings
ig:dm_percent_boots	Boots

[!TIP] All _percent_ rules have an _infinity_ and _single_use_ twin. Example: ig:dm_infinity_elytra, ig:dm_single_use_swords.

---

📦 Setup & Configuration

Step 1: Install

1. Install Fabric Loader and Fabric API for your Minecraft version.
2. Install Dasik Library >=1.8.38 (required dependency).
3. Drop durability-multiplier-x.y.z+<version>.jar into your mods/ folder.
4. Launch your game or server. All damageable items immediately use the active durability percentage!

Step 2: Customize via GameRule

I recommend these balanced vanilla+ starting points:

• Tools: /gamerule ig:dm_percent_tools 300 — smooth quarrying without constant trips
• Elytra: /gamerule ig:dm_percent_elytra 500 — long-range exploration
• Armor: /gamerule ig:dm_percent_armor 200 — fair combat wear

For hardcore RPG or roguelike packs, try Glass Mode: /gamerule ig:dm_single_use_global true — every item breaks after one use.

Step 3: Config File

Settings are also editable in config/durability-multiplier.json. Install ModMenu + YACL for an in-game GUI.

---

🤝 Support & Community

I'm an independent solo developer creating lightweight, vanilla-enhancing mods that respect your time and game performance. If Durability Multiplier saves your gear, consider supporting future development:

[!TIP] 🇮🇩 Indonesian supporters can support my work directly using local payment options (GoPay, OVO, Dana, QRIS, LinkAja) via Saweria or SocioBuzz!

Join my official Discord community for live development updates, early test builds, and friendly support:

• 💬 Discord Community: https://discord.gg/EV99bgAFqb

---

🗒️ Metadata & Permissions

Property	Value
Mod Name	Durability Multiplier
Namespace / Mod ID	durability-multiplier
License	GNU General Public License v3.0 (GPLv3)
Side Safety	Server & Client (Server-Authoritative)
Required Dependency	Dasik Library >=1.8.38
Optional	ModMenu, YetAnotherConfigLib (in-game GUI)
Source Code	GitHub Repository
Issue Tracker	GitHub Issues

[!IMPORTANT] 📦 Modpack Permissions & Distribution: You are fully welcome to include this mod in any modpack on any platform! However, the mod file must be downloaded directly through official distribution channels (Modrinth or CurseForge). Re-uploading, mirroring, or redistributing the original mod JAR to third-party mirror sites, scraper portals, or unauthorized launchers is strictly prohibited.

🔑 License & Fork Guidelines (No Zero-Change Re-uploads): This project is open-source under the GNU GPLv3. You are fully encouraged to inspect the code, learn from it, and fork the repository to create genuine modifications, substantial feature expansions, or community ports — provided your project remains open-source under GPLv3 with proper attribution. Straight 1:1 re-uploads, clone forks with no meaningful functional changes, or re-publishing identical builds under different project names are strictly forbidden.

---