expRepair

# 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 ` | 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 ` | Enable/disable passive repair server-wide | | `/er admin manual on\|off` | Set default manual repair for new players | | `/er admin manual allow on\|off ` | Enable/disable manual repair server-wide | | `/er admin threshold ` | View or set the default XP floor | | `/er admin maxXpPerRepair ` | 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. ```json { "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