expRepair
expRepair is a lightweight Minecraft mod that lets players spend their XP to automatically repair Mending-enchanted gear — without relying on XP orbs dropping near you. Choose between passive background repair or manual on-demand repair, with full server-side control over defaults and permissions.
✨ Features
🔁 Passive Repair
Automatically repairs your equipped Mending gear every second using your stored XP. Set an XP floor so passive repair never spends below a minimum level, keeping you safe from dropping too low.
🔧 Manual Repair
Sneak + right-click in the air while holding a damaged Mending item to instantly repair it using your XP. Great for quick fixes without waiting for passive repair to kick in.
🔒 Mutually Exclusive Modes
Passive and manual repair cannot both be active at the same time — enabling one automatically disables the other. Both can be disabled simultaneously if you prefer to manage repairs yourself.
💾 Persistent Settings
All player settings are saved permanently to the server. Settings survive disconnects, restarts, deaths, and dimension changes.
🛠️Admin Controls
Server administrators have full control over mod behavior:
- Set server-wide defaults for new players
- Enable or disable passive and/or manual repair server-wide
- Override individual player settings
- Broadcast or silently reload configuration changes
📋 Commands
All commands support both /exprepair and the /er shorthand.
Player Commands
| Command | Description |
|---|---|
/er |
Help / overview |
/er passive |
Toggle passive repair on/off |
/er manual |
Toggle manual repair on/off |
/er threshold [levels] |
View or set your XP floor (0 to clear) |
/er status |
View your current settings |
/er serverdefaults |
View server defaults (read-only) |
/er version |
Show mod version |
Admin Commands (OP level 2+)
| Command | Description |
|---|---|
/er admin |
View server settings |
/er admin passive on|off |
Set default passive repair for new players |
/er admin passive allow on|off [silent] |
Enable/disable passive repair server-wide |
/er admin manual on|off |
Set default manual repair for new players |
/er admin manual allow on|off [silent] |
Enable/disable manual repair server-wide |
/er admin threshold [levels] |
View or set the default XP floor |
/er admin maxXpPerRepair [xp] |
View or set max XP spent per repair tick |
/er admin reload [silent] |
Reload config from disk |
/er admin <player> |
View a player's current settings |
/er admin <player> reset |
Reset a player to server defaults |
/er admin <player> passive on|off |
Override a player's passive repair |
/er admin <player> manual on|off |
Override a player's manual repair |
/er admin <player> threshold <levels> |
Override a player's XP floor |
⚙️ Configuration
Settings are stored in config/exprepair.json and can be edited by hand or managed entirely through in-game commands. Changes made via commands are written to disk immediately — no restart required. Use /er admin reload to apply hand-edited changes.
{
"maxXpPerRepair": 8,
"defaultPassive": false,
"defaultManual": false,
"defaultThreshold": 0,
"allowPassive": true,
"allowManual": true
}
┌──────────────────┬─────────┬───────────────────────────────────────────────────────────┐
│ Property │ Default │ Description │
├──────────────────┼─────────┼───────────────────────────────────────────────────────────┤
│ maxXpPerRepair │ 8 │ Maximum XP spent per repair tick │
├──────────────────┼─────────┼───────────────────────────────────────────────────────────┤
│ defaultPassive │ false │ Default passive repair state for new players │
├──────────────────┼─────────┼───────────────────────────────────────────────────────────┤
│ defaultManual │ false │ Default manual repair state for new players │
├──────────────────┼─────────┼───────────────────────────────────────────────────────────┤
│ defaultThreshold │ 0 │ Default minimum XP level passive repair won't spend below │
├──────────────────┼─────────┼───────────────────────────────────────────────────────────┤
│ allowPassive │ true │ Whether players are allowed to use passive repair │
├──────────────────┼─────────┼───────────────────────────────────────────────────────────┤
│ allowManual │ true │ Whether players are allowed to use manual repair │
└──────────────────┴─────────┴───────────────────────────────────────────────────────────┘
---
📦 Requirements
- Minecraft: 1.21.11
- Loader: Fabric
- Fabric API: Required
- Fabric Loader: 0.18.4 or higher
---
🔗 Source Code
Available on https://github.com/LunixiaLIVE/expRepair under the MIT License.
