HyRepair

---

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