---

🩹 Better Health Recovery

更合理的生命恢复机制 | 让饥饿值真正“守护”你的血量

---

📖 模组介绍

中文

《Better Health Recovery》是一个轻量级、纯逻辑优化的模组，旨在修正原版 Minecraft 过于僵化的自然回血规则，让生命恢复与饥饿值之间的联动更符合直觉、更具策略性。

🎯 设计初衷

在原版游戏中，玩家只有饥饿值 ≥ 18（即 9 格） 时才能触发自然回血。这导致一个尴尬的局面：即使你还有 17 点饥饿值（8.5 格），血量却永远无法自动恢复，只能依靠金苹果、药水或食物强行“撑”到阈值。这种“全有或全无”的设计，既浪费了饥饿值的中间区间，也让低饥饿状态下的生存显得过于严苛。

⚙️ 核心机制

本模组不覆盖原版回血逻辑，而是在其基础上补充了一个“低饥饿应急恢复”通道，具体规则如下：

| 条件 | 说明 |
|------|------|
| 生效区间 | 当饥饿值 ＜ 18 时（原版回血被禁用），模组开始介入。 |
| 回血前提 | 当前生命值 必须小于 当前饥饿值（即血量低于饥饿数值）。 |
| 恢复上限 | 生命值 不会超过当前饥饿值，饥饿值既是“燃料”也是“天花板”。 |
| 恢复频率 | 与原版完全一致：每 4 秒（80 游戏刻）判定一次，每次恢复 1 点生命（半颗心）。 |
| 与原生共存 | 当饥饿值 ≥ 18 时，完全遵循原版回血规则（饥饿值 ≥ 18 且饱和度 > 0 时每 4 秒恢复 1 点），本模组不干扰。 |

💡 实际体验

• 举例：你有 12 点饥饿值（6 格），当前生命 8 点（4 颗心）。因为 8 < 12，模组会每 4 秒恢复 1 点生命，直到生命达到 12 点（即“填满”饥饿值对应的上限）。
• 代价：每次恢复消耗 6 点消耗度，大约每恢复 2~3 次就会额外消耗 1 点饥饿值（取决于饱和度），因此并非“免费午餐”，你需要合理规划食物摄入。
• 平衡性：恢复速度与原版一致（1 点/4 秒），但受饥饿值限制，不会出现“残血时靠低饱腹度无限回满”的情况，因为回血上限就是当前饥饿值，且饥饿值本身会因消耗而下降。

🧩 适用场景

• 前期食物匮乏时，利用低饥饿值缓慢回复，将食物作为主要恢复资源，减少对药水等外部物品的依赖。
• 战斗后血量略低于饥饿值，可等待几秒自然回复，节省资源。

🔧 技术说明

• 需要Fabric加载器和Minecraft26.2版本
• 使用 Mixin 注入 ServerPlayer.tick 尾部，逻辑简洁，性能开销极低。
• 未改动原版 FoodData 的任何算法，消耗度转换完全沿用原版机制，保证兼容性。

---

📝 Mod Description

English

Better Health Recovery is a lightweight, logic‑only mod that refines the vanilla natural health regeneration rules, making the interplay between food level and health more intuitive and strategic.

🎯 Design Goal

In vanilla Minecraft, natural regeneration only triggers when food level ≥ 18 (9 shanks). This leaves a dead zone: even with 17 food points, you cannot auto‑heal at all. The mod fills this gap by enabling a “low‑food emergency recovery” system, without overriding the vanilla behaviour when food is abundant.

⚙️ Core Mechanics

| Condition | Behaviour |
|-----------|-----------|
| Active range | When food level < 18 (vanilla regeneration disabled), the mod takes over. |
| Heal requirement | Current health must be less than current food level. |
| Heal cap | Health never exceeds current food level – food acts as both fuel and ceiling. |
| Heal frequency | Exactly as vanilla: every 4 seconds (80 ticks), restore 1 health point (half heart). |
| Vanilla coexistence | When food ≥ 18, vanilla rules apply unchanged (regeneration if food ≥ 18 and saturation > 0). |

💡 Gameplay Impact

• Example: You have 12 food, 8 health. Since 8 < 12, the mod heals 1 health every 4 seconds until health reaches 12 (the food ceiling).
• Cost: 6 exhaustion per heal – roughly every 2‑3 heals you lose 1 additional food (depending on saturation), so it’s not free; food management still matters.
• Balance: Healing speed matches vanilla (1 point/4s), but the food cap prevents infinite recovery from low food levels, because hunger itself depletes over time.

🧩 Ideal For

• Early game when food is scarce – use low food levels to recover slowly, relying on food rather than potions or external sources.
• Post‑combat recovery when health is slightly below food level – wait a few seconds to save resources.

🔧 Technical Notes

• Requires Fabric loader and Minecraft version 26.2
• Uses a Mixin injection at the tail of ServerPlayer.tick – minimal performance overhead.
• Does not alter any vanilla FoodData algorithms; exhaustion conversion strictly follows vanilla, ensuring full compatibility.

---