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. Mod works server-side or in single player.

## ✨ 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`	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.