HyRepair

---

免责声明： 此模组仍在开发中。如有错误或建议，请在我们的 Discord 上报告。

---

HyRepair

轻量级的 Hytale 服务器耐久度修复模组：简洁的命令、强大的权限控制、可选冷却时间、弹窗通知以及 RPG 风格的成功率模式。

功能简介

HyRepair 允许玩家修复手持物品、修复背包中所有符合条件的物品，或在耐久度过低时启用自动修复。专为生存、RPG 和 MMO 服务器设计，在这些服务器中耐久度至关重要——无需复杂机制。

• 自动生成配置文件 (mods/HyRepair/HyRepair.json)
• 弹窗通知 用于修复成功/失败（可选）——比聊天刷屏更整洁
• 修复音效 （仅执行玩家可听到）
• 物品黑名单 通过精确物品 ID（适用于所有修复模式）
• 可选冷却时间 + 按等级覆盖权限
• 可选 RPG 修复模式：成功几率 + 失败时损失耐久度
• 修复菜单 UI（可选）：用于修复/自动修复开关的简单点击菜单
• 自动修复（可选）：当耐久度达到设定百分比阈值时自动修复

客户端要求 / UI 模组

无需客户端 UI 模组。 修复菜单使用标准服务器资源包 UI 工作流程 (IncludesAssetPack)。此菜单不需要 HyUI 和 MultipleHUD。

快速设置

给予玩家使用 /repair 和 /repair all 的权限：

<span style="color:#e03e2d">hyrepair.command.repair</span>
<span style="color:#e03e2d">hyrepair.command.repair.all</span>

配置文件： mods/HyRepair/HyRepair.json 提示： 如果你更新了模组，缺失的配置键会自动添加。损坏的配置会被备份并重新生成。

命令与权限

命令	权限	描述
/repair	hyrepair.command.repair	修复你当前手持的物品。
/repair all	hyrepair.command.repair.all	修复你背包中所有符合条件的物品（单条总结弹窗）。
/autorepair	hyrepair.command.autorepair	切换手持物品的自动修复（在低耐久度阈值时修复）。
/autorepairall	hyrepair.command.autorepairall	切换整个背包的自动修复（在低耐久度阈值时修复符合条件的物品）。
/repairmenu	hyrepair.command.repairmenu	打开一个用于修复操作的简单 UI 菜单（可选功能，可在配置中禁用）。
/hyrepair reload	hyrepair.admin.reload	无需重启服务器即可重新加载 HyRepair.json。

自动修复阈值（基于百分比）

AutoRepairThreshold 是一个百分比。 例如：10 意味着 剩余 10% 耐久度。当一个物品的耐久度达到其最大耐久度的 ≤ 10% 时，它将自动修复（如果启用了自动修复且该物品符合条件）。

弹窗通知

• 修复成功/失败使用弹窗通知（可选）代替聊天刷屏。
• /repair all 显示一条总结弹窗：已修复 X 个，失败 Y 个。
• 修复弹窗可以包含物品名称（非常适合自定义物品）。

冷却时间覆盖（可选）

如果玩家拥有多个冷却时间权限，则 最高的数值生效。

适用范围	权限模式	示例	描述
/repair	hyrepair.command.repair.cooldown.<秒数>	hyrepair.command.repair.cooldown.30	将 /repair 的冷却时间设为 30 秒。
/repair all	hyrepair.command.repair.all.cooldown.<秒数>	hyrepair.command.repair.all.cooldown.120	将 /repair all 的冷却时间设为 120 秒。

冷却时间绕过（可选）

适用范围	权限	描述
/repair	hyrepair.command.repair.cooldown.bypass	/repair 无冷却时间。
/repair all	hyrepair.command.repair.all.cooldown.bypass	/repair all 无冷却时间。

示例

/repair 冷却时间设为 10 秒：

<span style="color:#e03e2d">hyrepair.command.repair.cooldown.10</span>

/repair all 冷却时间设为 120 秒：

<span style="color:#e03e2d">hyrepair.command.repair.all.cooldown.120</span>

工作人员设置（推荐）

允许使用命令 + 绕过冷却时间：

<span style="color:#e03e2d">hyrepair.command.repair
hyrepair.command.repair.all
hyrepair.command.repair.cooldown.bypass
hyrepair.command.repair.all.cooldown.bypass</span>

黑名单

被列入黑名单的物品将被排除在所有修复模式之外（命令和自动模式）。 在 HyRepair.json 中使用精确物品 ID 进行配置：

<span style="color:#e03e2d">"BlacklistItemIds"</span>: ["Weapon_Longsword_Iron", "Weapon_Longsword_Scarab", "Armor_Wool_Head"]

常见配置选项

• 自定义消息/文本
• 黑名单物品 ID（精确）
• 修复音效（启用/禁用 + 音效事件 ID）
• 弹窗通知（启用/禁用 + 自定义文本）
• RPG 修复模式（启用/禁用，成功几率，失败时耐久度损失，失败音效）
• /repair 和 /repair all 的默认冷却秒数
• 自动修复阈值百分比（AutoRepairThreshold）

HyRepair 专注于简洁性、性能以及细粒度的权限控制——非常适合希望实现可靠修复而又不增加不必要开销的服务器。

想改进这个模组吗？ 加入我们的 Discord