Disclaimer: This mod is still in development. Please report bugs / suggestions on our Discord.

HyRepair

Lightweight durability repairs for Hytale servers: clean commands, strong permission control, optional cooldowns, toast notifications, and an RPG-style chance mode.

What it does

HyRepair lets players repair the item they are holding, repair all eligible items in their inventory, or enable automatic repairs when durability gets low. Designed for Survival, RPG, and MMO servers where durability matters — without heavy mechanics.

Automatic config generation (mods/HyRepair/HyRepair.json)
Toast notifications for repair success/fail (optional) — cleaner than chat spam
Repair sounds (only the executing player hears them)
Item blacklist by exact item ID (applies to all repair modes)
Optional cooldowns + per-rank override permissions
Optional RPG Repair mode: success chance + durability loss on failure
Repair Menu UI (optional): simple click menu for repair / autorepair toggles
Auto Repair (optional): repairs when durability reaches a % threshold

Client requirements / UI mods

No client-side UI mod required. The Repair Menu uses the standard server asset-pack UI workflow (IncludesAssetPack). HyUI and MultipleHUD are not required for this menu.

Quick setup

Give players access to /repair and /repair all:

hyrepair.command.repair
hyrepair.command.repair.all

Config file: mods/HyRepair/HyRepair.json

Tip: If you update the mod, missing config keys are added automatically. Broken configs are backed up and regenerated.

Commands & Permissions

Command	Permission	Description
`/repair`	`hyrepair.command.repair`	Repairs the item you are currently holding.
`/repair all`	`hyrepair.command.repair.all`	Repairs all eligible items in your inventory (single summary toast).
`/autorepair`	`hyrepair.command.autorepair`	Toggles auto-repair for the held item (repairs at low durability threshold).
`/autorepairall`	`hyrepair.command.autorepairall`	Toggles auto-repair for the entire inventory (repairs eligible items at low durability threshold).
`/repairmenu`	`hyrepair.command.repairmenu`	Opens a simple UI menu for repair actions (optional feature, can be disabled in config).
`/hyrepair reload`	`hyrepair.admin.reload`	Reloads `HyRepair.json` without restarting the server.

Auto Repair threshold (percent-based)

AutoRepairThreshold is a percentage. Example: 10 means 10% durability remaining. When an item reaches ≤ 10% of its max durability, it will be repaired automatically (if AutoRepair is enabled and the item is eligible).

Toast notifications

Repair success/fail uses toast notifications (optional) instead of chat spam.
/repair all shows one summary toast: Repaired X, failed Y.
Repair toasts can include the item name (great for custom items).

Cooldown Overrides (Optional)

If a player has multiple cooldown permissions, the highest value wins.

Applies to	Permission pattern	Example	Description
`/repair`	`hyrepair.command.repair.cooldown.<seconds>`	`hyrepair.command.repair.cooldown.30`	Sets cooldown for `/repair` to 30 seconds.
`/repair all`	`hyrepair.command.repair.all.cooldown.<seconds>`	`hyrepair.command.repair.all.cooldown.120`	Sets cooldown for `/repair all` to 120 seconds.

Cooldown Bypass (Optional)

Applies to	Permission	Description
`/repair`	`hyrepair.command.repair.cooldown.bypass`	No cooldown for `/repair`.
`/repair all`	`hyrepair.command.repair.all.cooldown.bypass`	No cooldown for `/repair all`.

Examples

/repair cooldown to 10 seconds:

hyrepair.command.repair.cooldown.10

/repair all cooldown to 120 seconds:

hyrepair.command.repair.all.cooldown.120

Staff setup (recommended)

Allow commands + bypass cooldowns:

hyrepair.command.repair
hyrepair.command.repair.all
hyrepair.command.repair.cooldown.bypass
hyrepair.command.repair.all.cooldown.bypass

Blacklist

Blacklisted items are excluded from all repair modes (commands and auto modes).

Configure in HyRepair.json with exact item IDs:

"BlacklistItemIds": ["Weapon_Longsword_Iron", "Weapon_Longsword_Scarab", "Armor_Wool_Head"]

Common config options

Custom messages / text
Blacklist item IDs (exact)
Repair sounds (enable/disable + sound event ID)
Toast notifications (enable/disable + custom text)
RPG Repair mode (enable/disable, success chance, durability loss on fail, fail sound)
Default cooldown seconds for /repair and /repair all
AutoRepair threshold percent (AutoRepairThreshold)

HyRepair focuses on simplicity, performance, and fine-grained permission control — ideal for servers that want reliable repairs without unnecessary overhead.

Want to improve this mod? Join our Discord