EasyAutoHeal

EasyAutoHeal

自動喝治療蜜酒 —— 血量危險時從背包裏挑一瓶治療蜜酒自動喝掉，純客戶端模組。

[AI-generated] 本模組由 AI 生成（源碼、文檔、圖標）。

功能

• 觸發條件（任一滿足）
• 當前生命值 < 固定閾值（默認 20 滴）
• 當前生命值 ÷ 生命上限 < 百分比閾值（默認 10%，分母含食物加成）
• 滿血硬保護：生命值等於上限時絕不觸發。就算把閾值配成超過血量上限的值

（例如固定閾值填 200 而上限只有 150），也不會滿血浪費蜜酒。

• 空肚保護：喫下的食物數量少於 2 個 時絕不觸發（可配置 0~3），

剛出生 / 清空食物欄時不會白白浪費蜜酒。

• 蜜酒識別：不寫死物品名 —— 運行時掃描背包消耗品，凡「喝下後帶 HP 恢復效果」的

（次級 / 中級 / 緩愈治療蜜酒以及未來的同類物品）都能識別。

• 優先級：背包裏同時有多種時，默認先喝最強的一瓶（可改爲先喝最弱的，省着好藥）。
• 不浪費：走遊戲原版 Player.ConsumeItem 鏈路 —— 蜜酒的回覆/冷卻效果還在身上時，

遊戲本身就會拒絕再喝，一瓶都不會被消耗；喝下後另有 10 秒保護冷卻。

• 提示：喝下時屏幕左上角彈一條提示（可關）。

配置（BepInEx/config/easyautoheal.client.only.cfg）

| 分區 | 鍵 | 默認 | 說明 |

|---|---|---|---|

| 1 - Auto Heal | Enabled | true | 總開關 |

| | FixedHpThreshold | 20 | 固定血量閾值（滴） |

| | PercentHpThreshold | 10 | 百分比閾值（%） |

| | MinFoods | 2 | 至少喫下幾個食物才允許觸發（0-3） |

| | CheckInterval | 0.5 | 檢查間隔（秒） |

| | CooldownSeconds | 10 | 喝下後的保護冷卻（秒） |

| | StrongestFirst | true | true=先喝最強；false=先喝最弱 |

| | ShowMessage | true | 喝下時左上角提示 |

⚠️ 與所有 BepInEx 配置一樣：改 cfg 前先退遊戲，遊戲運行中手改會被覆蓋。

兼容性

• 純客戶端：無 Jotunn、無 ServerSync、無 NetworkCompatibility 聲明（NotEnforced）。
• 聯機：主機不裝也能用（只動本地玩家自己的背包，走原版消耗鏈路）。
• 只讀不改任何 prefab 數值。

安裝

r2modman「Install from file」選 EasyAutoHeal-1.0.1.zip，

或把 EasyAutoHeal.dll 丟進 BepInEx/plugins/。

前置：BepInExPack_Valheim 5.4.2350。

版本

• 1.0.1（2026-09-17）：修掉「不判血量、滿血也一直喝藥」。

1.0.0 誤把 Character.GetHealthPercentage() 當 0–100 的百分數用，

但它的 IL 實測是 GetHealth() / GetMaxHealth() —— 返回 0.0–1.0 的比例，沒有 ×100。

於是 pct < 10 恆爲真 ⇒ 百分比條件永遠滿足 ⇒ 只要背包有藥、食物夠 2 個就喝，

與當前血量無關（實測日誌：hp=150/150，1% 也喝）。

現改爲自己按 0–100 計算，cfg 語義不變（PercentHpThreshold=10 依然表示 10%）；

另加滿血硬保護，日誌也升級爲打出完整判定依據。

• 1.0.0（2026-09-17）：首個版本。