HyRepair

Allows players to repair the item they are currently holding using a simple command, with configurable limits and permission-based access.

File Details

HyRepair-1.1.0.jar

  • R
  • Feb 1, 2026
  • 23.78 KB
  • 67
  • Early Access

File Name

HyRepair-1.1.0.jar

Supported Versions

  • Early Access

Added:

/repair all command
- Added `/repair all` to repair all eligible items in your inventory
- Repairs items across: Hotbar, Backpack, Utility, and Armor containers

Configurable default cooldowns + permission-based overrides
- Added config keys for default cooldowns:
  - `DefaultRepairCooldownSeconds`
  - `DefaultRepairAllCooldownSeconds`
- Cooldowns can be overridden via permissions:
  - `hyrepair.command.repair.cooldown.<seconds>`
  - `hyrepair.command.repair.all.cooldown.<seconds>`
- Added cooldown bypass permissions:
  - `hyrepair.command.repair.cooldown.bypass`
  - `hyrepair.command.repair.all.cooldown.bypass`

Admin reload command
- Added `/hyrepair reload` to reload `HyRepair.json` without restarting the server
- Permission required: `hyrepair.admin.reload`

RPG Repair mode (optional)
- Added optional “RPG style” repair system (disabled by default)
- Configurable in `RpgRepair`:
  - `Enabled` (default: false)
  - `SuccessChancePercent`
  - `FailDurabilityLoss`
- On failure, the item loses durability instead of being repaired
- Added fully configurable failure message + summary for `/repair all`
- Added optional failure sound (local player-only):
  - `FailSoundEnabled`
  - `FailSoundEventId`

Per-item sound options for /repair all
- Added `PlaySuccessSoundPerItem`:
  - If true, plays the success sound once per repaired item in `/repair all`
  - If false, plays at most once per command
- Added `RpgRepair.PlayFailSoundPerItem` for RPG mode failures

Clean config folder + migration
- Config is now stored in a clean folder: `mods/HyRepair/HyRepair.json`
- Automatically migrates an older config location if found (legacy loader folder)

Automatic config upgrade + broken-config backup
- Existing configs are now auto-upgraded: missing keys are added automatically on load
- If the config is invalid/broken, it is backed up as:
  - `HyRepair.json.broken-<timestamp>`
  and a fresh default config is regenerated

More configurable messages + placeholders
- Added/expanded message set in config
- Messages support placeholders like:
  - `{prefix}`, `{seconds}`, `{count}`, `{itemId}`, `{damage}`, `{repaired}`, `{failed}`


Changed:

Blacklist behavior improvements
- Blacklist now applies to both `/repair` and `/repair all`
- Blacklist matching is more forgiving:
  - ignores case
  - trims whitespace

Cooldown behavior improvement
- Cooldowns are only consumed if there is actually something eligible to repair
  (no wasted cooldown when nothing can be repaired)

Sound handling improvements
- Sound playback is always local player-only (2D/UI sound)
- Sound event indices are cached to reduce repeated lookups


Fixed:

Safety check while using tools item
- Repair commands are blocked while the player is in a “using tools item” state
  to avoid unexpected inventory state issues

Resilience against invalid sound IDs
- If a sound event ID is invalid, the command still works (sound failure won’t break repairs)