EasyAutoHeal

EasyAutoHeal

Automatically drink healing mead - when your health is in danger, pick a bottle of healing mead from your backpack and drink it automatically. This is a pure client-side module.

[AI-generated] This module is generated by AI (source code, documentation, icons).

Function

• Trigger conditions (any one is met)
• Current health < fixed threshold (default 20 drops)
• Current health ÷ maximum health < percentage threshold (default 10%, denominator includes food bonus)
• Full health hard protection: It will never be triggered when the health value is equal to the upper limit. Even if the threshold is set to a value that exceeds the upper limit of blood volume,

(For example, if the fixed threshold value is 200 and the upper limit is only 150), the mead will not be wasted at full health.

• Fasting protection: Never trigger when the number of foods eaten is less than 2 (configurable 0~3),

Mead will not be wasted when being born/emptying the food bar.

• Mead identification: do not write down the item name - scan the backpack for consumables at runtime, any "with HP recovery effect after drinking"

(Level/Intermediate/Healing Mead and future similar items) are all recognized.

• Priority: When there are multiple types in the backpack at the same time, the strongest bottle will be drank first by default (can be changed to drink the weakest bottle first to save good medicine).
• Don’t waste: use the original Player.ConsumeItem link of the game - when the mead’s recovery/cooling effect is still on you,

The game itself will refuse to drink anymore, and no bottle will be consumed; there is also a 10-second protective cooldown after drinking.

• Tip: When drinking, a prompt will pop up in the upper left corner of the screen (can be turned off).

Configuration (BepInEx/config/easyautoheal.client.only.cfg)

| partition | key | default | description |

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

| 1 - Auto Heal | Enabled | true | Master switch |

| | FixedHpThreshold | 20 | Fixed blood volume threshold (drops) |

| | PercentHpThreshold | 10 | Percent threshold (%) |

| | MinFoods | 2 | At least several foods must be eaten to allow triggering (0-3) |

| | CheckInterval | 0.5 | Check interval (seconds) |

| | CooldownSeconds | 10 | Protection cooldown after drinking (seconds) |

| | StrongestFirst | true | true=Drink first to be the strongest; false=Drink first to be the weakest |

| | ShowMessage | true | Prompt in the upper left corner when drinking |

⚠️ Same as all BepInEx configurations: exit the game before changing cfg. Any changes made while the game is running will be overwritten.

compatibility

• Pure client: no Jotunn, no ServerSync, no NetworkCompatibility statement (NotEnforced).
• Online: The host can be used without installing it (only the local player's own backpack is used, and the original version consumes the link).
• Read only and do not change any prefab value.

Install

r2modman "Install from file" select EasyAutoHeal-1.0.1.zip,

Or drop EasyAutoHeal.dll into BepInEx/plugins/.

Prerequisite: BepInExPack_Valheim 5.4.2350.

Version

• 1.0.1 (2026-09-17): Fixed the issue of "Always drinking medicine regardless of blood volume and full blood".

1.0.0 Mistakenly used Character.GetHealthPercentage() as a percentage of 0–100.

But its IL is actually GetHealth() / GetMaxHealth() - which returns a ratio of 0.0–1.0, no ×100.

So pct < 10 is always true ⇒ The percentage condition is always satisfied ⇒ As long as there is medicine in the backpack and enough food for 2 people, drink it.

It has nothing to do with the current blood volume (actual measurement log: hp=150/150, 1% also drinks).

Now it is calculated by itself from 0-100, and the semantics of cfg remain unchanged (PercentHpThreshold=10 still means 10%);

In addition, full health protection is added, and the log is also upgraded to provide complete judgment basis.

• 1.0.0 (2026-09-17): First version.