被动恢复

❤️ 被动生命恢复

脱离战斗后自动恢复生命值！ 提供15+ 项设置，完全可自定义。

✨ 功能特点

• 被动生命恢复： 脱离战斗一段时间后自动恢复生命值。
• 战斗感知： 当你攻击或受到伤害时，计时器会重置 — 战斗中无法作弊！
• 广泛可配置： 15+ 项设置，可微调恢复机制以满足服务器需求
• 管理员命令系统： 游戏内 /pregen 命令，无需重启即可管理所有设置
• 高级机制： 生命阈值、低生命倍率、收益递减等
• 性能友好： 基于 Hytale 的 ECS 系统构建，实现高效的玩家数据追踪
• 基于 Gradle： 现代化的构建系统，自动管理服务器 jar 文件

🎮 工作原理

1. 进入战斗：通过攻击敌人或受到伤害。
2. 等待30秒（可配置）：期间不进行任何战斗动作。
3. 开始恢复：每秒恢复1点生命值（可配置），直至生命值满！

  ⚔️ 战斗 → ⏱️ 等待30秒 → ❤️ 开始恢复！

如果你再次进入战斗，恢复过程会立即停止，并且计时器会重置。

⚙️ 配置

游戏内命令

本模组提供完整的命令系统，用于管理所有设置：

/pregen help              # 显示命令帮助
/pregen status            # 查看当前配置和状态
/pregen reload            # 从磁盘重新加载配置
/pregen enable            # 启用模组
/pregen disable           # 禁用模组
/pregen set <key> <val>   # 更改任意设置
/pregen get <key>         # 查看特定设置的值
/pregen list              # 列出所有可用设置
/pregen reset             # 重置为默认值

配置文件

模组在首次运行时将生成 PassiveRegen.json 配置文件：

{
    "Enabled": true,
    "OutOfCombatSeconds": 30.0,
    "RegenAmount": 1.0,
    "RegenIntervalSeconds": 1.0,
    "EnableHealthThreshold": false,
    "HealthThresholdPercent": 100.0,
    "LowHealthMultiplier": 1.5,
    "LowHealthThreshold": 30.0,
    "EnableDiminishingReturns": false,
    "DiminishingThreshold": 80.0,
    "DiminishingMultiplier": 0.5,
    "MaxRegenPerInterval": -1.0,
    "EnableRegenCap": false,
    "RegenCapPercent": 100.0,
    "RequireOpCommands": true
}

配置选项

设置	默认值	类型	描述
Enabled	true	boolean	完全启用或禁用模组
OutOfCombatSeconds	30.0	double	恢复开始前的脱战秒数
RegenAmount	1.0	double	每次恢复周期恢复的生命值
RegenIntervalSeconds	1.0	double	每次恢复周期之间的秒数
EnableHealthThreshold	false	boolean	仅在生命值低于一定百分比时恢复
HealthThresholdPercent	100.0	double	触发恢复的生命值百分比阈值
LowHealthMultiplier	1.5	double	低生命值时的恢复倍率
LowHealthThreshold	30.0	double	判定为低生命状态的百分比阈值
EnableDiminishingReturns	false	boolean	启用收益递减机制
DiminishingThreshold	80.0	double	开始应用收益递减的生命值百分比
DiminishingMultiplier	0.5	double	收益递减后的恢复率倍率
MaxRegenPerInterval	-1.0	double	每次恢复周期的最大生命值（-1为无限制）
EnableRegenCap	false	boolean	启用最大生命回复上限
RegenCapPercent	100.0	double	可恢复到的最大生命值百分比
RequireOpCommands	true	boolean	使用命令是否需要OP权限

配置示例

快速恢复 (4 HP/秒)：

/pregen set amount 2.0
/pregen set interval 0.5

保守模式 (慢速且安全)：

/pregen set combat 60.0
/pregen set amount 0.5
/pregen set interval 2.0

基于生命值恢复：

/pregen set enablethreshold true
/pregen set threshold 50
# 仅在生命值低于50%时恢复

收益递减 (低生命值时更高恢复)：

/pregen set enablediminishing true
/pregen set diminishingthreshold 80
/pregen set diminishingmult 0.5
# 生命值低于80% = 全额恢复，高于80% = 50%恢复速率

服务器均衡：

/pregen set combat 45
/pregen set amount 1.5
/pregen set enablediminishing true
/pregen set lowmult 2.0

📥 安装

1. 下载 Linceros.PassiveRegen-1.1.0.jar 文件。
2. 将 .jar 文件放入 Hytale 服务器的 mods 文件夹。
3. 启动你的服务器！
4. 模组将在首次运行时自动创建 PassiveRegen.json 配置文件。
5. （可选）编辑配置文件或使用 /pregen 命令进行自定义。

📋 版本历史

v1.1.0 (当前版本)

• ✨ 完整的 Gradle 迁移，支持自动下载服务器 JAR 文件
• ✨ 高级配置系统，拥有 15+ 项设置
• ✨ 用于游戏内管理的完整命令系统
• ✨ 生命值阈值、倍率、收益递减机制
• ✨ 恢复上限和每次间隔最大恢复量控制
• ✨ 100% 英文界面
• 有关详细更改，请参阅 CHANGELOG.md

v1.0.0

• 基础的被动生命恢复功能
• 简单的4选项JSON配置
• 战斗感知计时器

🔮 未来计划

• HUD 指示器显示恢复状态
• 通过命令进行玩家个性化恢复设置
• 基于游戏难度的不同恢复速率
• 与自定义属性/状态系统集成

👨‍💻 作者

由 Linceros 创作。

---

属于 Linceros 的 Hytale 模组合集。

更多信息，请访问 CHANGELOG.md 查看详细的版本历史和更新。