expRepair
Take control of your Mending enchantment. expRepair lets you decide when and how your gear gets repaired using your stored XP — no more losing XP to random orb pickups at the wrong time.
- Loaders
- FabricNeoForge
- Downloads on Modrinth
- 3.4K
- Followers on Modrinth
- 3
- versions
- 10
- Updated
- September 23, 2026Sep 23
- Published
- in 2026
At a glance
Install on the server only; players don't need it
🔧 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 ` | 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.
FAQ
How to install expRepair?
Install Fabric for your Minecraft version, download expRepair for the same version and loader, put the file into the mods folder and launch the game with the loader profile.
Which Minecraft versions does expRepair support?
expRepair has builds for Minecraft 1.21.5–26.3.
Is expRepair needed on the server?
Server only — players don't need to install it