🔧 expRepair

Repair your gear with XP — passively or on demand. No anvils. No grindstones.

---

Vanilla Mending only heals the item you're holding, and only when an XP orb happens to drop — so your armor rots mid-fight and your off-hand never gets a repair. expRepair fixes that. It spends your stored experience — levels and the progress bar, not just loose orbs — to keep your whole kit alive the moment it takes damage.

🆕 New in 1.9.5: one jar now runs on every Minecraft 26.x release — 26.1, 26.1.1, 26.1.2, 26.2 and 26.3.

No new items, no blocks — it's server-side, so a vanilla client can just connect, and it runs the same in single-player.

⚔️ Vanilla Mending vs. expRepair

	🎣 Vanilla Mending	🔧 expRepair
What it repairs	Only the held item	Your whole loadout (passive)
When	When an XP orb lands	Every second, or on demand
XP source	Loose orbs only	Your stored XP
Armor while fighting	Rots	Maintained
Control	None	Passive / Manual + XP floor

✨ Two ways to repair — pick one

• 🟢 Passive — the whole kit, hands-off. Once per second, every damaged Mending item you have equipped (main hand, off-hand, and all four armor slots) tops itself off from your XP, up to a budget. Your gear stays healthy in the background while you mine, fight, or fly.
• 🎯 Manual — just the tool in hand. Sneak + right-click in the air holding a damaged Mending item and it repairs on the spot. Nothing happens automatically, so you decide when your levels get spent.

Turning one mode on turns the other off — no doubt about what's spending your XP.

🔧 How it works

XP converts to durability at a fixed, transparent rate: 1 XP = 2 durability. Each repair spends at most maxXpPerRepair (default 8 → up to 16 durability), drawn from your total experience.

• A protective XP floor. Set a threshold and passive repair will never spend XP that would drop you below it — bank levels for that next enchant while the overflow keeps your gear alive.
• Mending is the opt-in. Only Mending-enchanted items are ever touched — nothing repairs gear you didn't intend to.
• Survival only, only while alive. Creative/spectator are skipped, and no XP is spent on the death screen.

🎛️ You're in control

• A clickable login summary — on join, a compact status line shows your mode + threshold with inline toggle buttons (and you can switch the message off entirely).
• Full admin control — operators set server-wide defaults, force a mode for any player, or block a mode outright. Config hot-reloads, no restart.
• Plays nice with PvP mods — exposes a suppression hook so combat mods (e.g. pvpOption) can pause repairs mid-duel.

⌨️ Commands

Base command /exprepair (alias /er) — run it bare for a clickable help screen.

Command	What it does
/exprepair passive	Toggle passive repair (turns manual off)
/exprepair manual	Toggle manual repair (turns passive off)
/exprepair threshold <levels>	Set the XP floor passive won't spend below
/exprepair status	Show your passive / manual / threshold settings
/exprepair loginmessage	Toggle your on-join status message
/exprepair admin …	Op tools: server defaults, per-player overrides, block a mode, reload

⚙️ Configuration

Server settings live in config/exprepair.json (editable in-game via /exprepair admin …, hot-reloads). Tune maxXpPerRepair, the new-player defaults for passive/manual/threshold, and master allowPassive / allowManual switches. Per-player choices persist separately.

📦 Compatibility

Loaders	Fabric and NeoForge — one jar runs on both
Minecraft	26.1 – 26.3 — one jar, v1.9.5 · 1.21.11 and 1.21.5 – 1.21.10 — v1.9.4
Fabric API	Required on Fabric · not needed on NeoForge
Side	Server-side — vanilla clients fully supported, single-player too
Extra libraries	None — fully standalone

---

Enjoying it? Hop in the Discord · ⭐ the repo · explore the rest of Lunixia's Minecraft QOL Mods

_{⛏️ Small, focused mods that cut out the boring stuff.}