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.