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.