Shokuba-Health_Regeneration_Mod icon

Health Regeneration Mod

Allows players to passively regenerate health after spending time out of combat. Fully configurable via percentage or fixed values.

By Shokuba
Last updated 16 hours ago
Total downloads 470
Total rating 0 
Categories Mods AI Generated Quality Of Life
Dependency string Shokuba-Health_Regeneration_Mod-1.0.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2100 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2100

README

Health Regeneration Mod

A simple and highly configurable mod that adds passive health regeneration to players when they are out of danger.

🚀 Features

  • Regeneration Modes: Choose between healing a percentage of your maximum health or a fixed flat value per tick.
  • Out-of-Combat System: Healing instantly stops upon taking damage and will only resume after spending a safe period of time.
  • Optimized Performance: Automatic data cleanup between rounds to prevent memory leaks or state synchronization issues.
  • Real-time Configuration: Fully compatible with BepInEx configuration files or in-game ConfigurationManagers.

⚙️ Configuration (.cfg)

Upon running the game for the first time with the mod installed, a configuration file will be generated in your BepInEx/config/com.MoyaGz.repo.healthregen.cfg directory.

[General]

  • Enable Mod (true/false): Fully enables or disables the mod features.

[Regen Settings]

  • Regen Type (MaxHealth or RegenAmount):
    • MaxHealth: Heals based on a percentage of the player's maximum health.
    • RegenAmount: Heals an exact, fixed amount of health points.
  • Max Health Percent Amount (Default: 1.5): Percentage of maximum health recovered per tick (Supports decimals).
  • Regen Amount (Default: 1): Exact points of health recovered if using the fixed amount mode.
  • Regen Interval (Default: 0.5): How often the healing effect is applied (in seconds).

[Combat Settings]

  • Out Of Combat Time (Default: 8.0): The duration in seconds that you must spend without taking damage for regeneration to begin.

🛠️ Installation

  1. Ensure you have BepInEx installed.
  2. Download this mod and place the .dll file inside the BepInEx/plugins/ directory.
  3. Launch the game to generate the config file, and you are good to go!

📝 Developer Notes

  • The mod internally accumulates health fractions when using small percentages, ensuring that healing applies accurately and smoothly as whole integers within the game engine.