expRepair

🔧 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.}