❤️ Passive Regen

Regenerate health passively when you're out of combat! Fully configurable with 15+ settings.

✨ Features

Passive Health Regeneration: Automatically recover health when you haven't been in combat for a while.
Combat-Aware: The timer resets whenever you attack or take damage — no cheesing during fights!
Extensively Configurable: 15+ settings to fine-tune regeneration to your server's needs
Admin Command System: In-game /pregen commands to manage all settings without restarts
Advanced Mechanics: Health thresholds, low health multipliers, diminishing returns, and more
Performance Friendly: Built on Hytale's ECS system for efficient per-player tracking
Gradle-Based: Modern build system with automatic server jar management

🎮 How It Works

Enter combat by attacking an enemy or taking damage.
Wait 30 seconds (configurable) without any combat action.
Start regenerating 1 HP per second (configurable) until full!

  ⚔️ Combat → ⏱️ Wait 30s → ❤️ Regen starts!

The regeneration stops immediately if you enter combat again, and the timer resets.

⚙️ Configuration

In-Game Commands

The mod provides a full command system for managing all settings:

/pregen help              # Show command help
/pregen status            # View current configuration and status
/pregen reload            # Reload configuration from disk
/pregen enable            # Enable the mod
/pregen disable           # Disable the mod
/pregen set <key> <val>   # Change any setting
/pregen get <key>         # View specific setting value
/pregen list              # List all available settings
/pregen reset             # Reset to default values

Configuration File

The mod generates a PassiveRegen.json config file on first run:

{
    "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
}

Configuration Options

Setting	Default	Type	Description
`Enabled`	`true`	boolean	Enable or disable the mod entirely
`OutOfCombatSeconds`	`30.0`	double	Seconds without combat before regen starts
`RegenAmount`	`1.0`	double	HP restored per regeneration tick
`RegenIntervalSeconds`	`1.0`	double	Seconds between each regen tick
`EnableHealthThreshold`	`false`	boolean	Only regen below certain health %
`HealthThresholdPercent`	`100.0`	double	Health % threshold for regen
`LowHealthMultiplier`	`1.5`	double	Multiplier when health is low
`LowHealthThreshold`	`30.0`	double	% threshold for low health state
`EnableDiminishingReturns`	`false`	boolean	Enable diminishing returns
`DiminishingThreshold`	`80.0`	double	% above which diminishing returns apply
`DiminishingMultiplier`	`0.5`	double	Multiplier for diminished regen rate
`MaxRegenPerInterval`	`-1.0`	double	Max HP per tick (unlimited if -1)
`EnableRegenCap`	`false`	boolean	Enable maximum health restoration cap
`RegenCapPercent`	`100.0`	double	Maximum health % to regenerate to
`RequireOpCommands`	`true`	boolean	Require OP status to use commands

Example Configurations

Fast Regen (4 HP/sec):

/pregen set amount 2.0
/pregen set interval 0.5

Conservative (Slow & Safe):

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

Health-Based Regen:

/pregen set enablethreshold true
/pregen set threshold 50
# Only regenerates when below 50% health

Diminishing Returns (More HP when Health is Low):

/pregen set enablediminishing true
/pregen set diminishingthreshold 80
/pregen set diminishingmult 0.5
# Below 80% = full regen, above 80% = 50% regen rate

Server Balanced:

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

📥 Installation

Download the Linceros.PassiveRegen-1.1.0.jar.
Place the .jar file into your Hytale server's mods folder.
Start your server!
The mod will automatically create PassiveRegen.json config on first run.
(Optional) Edit config or use /pregen commands to customize.

📋 Version History

v1.1.0 (Current)

✨ Complete Gradle migration with automatic Server JAR downloads
✨ Advanced configuration system with 15+ settings
✨ Full command system for in-game management
✨ Health thresholds, multipliers, diminishing returns
✨ Regen cap and max regen per interval controls
✨ 100% English interface
See CHANGELOG.md for detailed changes

v1.0.0

Basic passive health regeneration
Simple 4-option JSON configuration
Combat-aware timer

🔮 Future Ideas

HUD indicator showing regen status
Per-player regen customization with commands
Different regen rates based on difficulty
Integration with custom attributes/stats systems

👨‍💻 Author

Created by Linceros.

Part of the Linceros Mod Collection for Hytale.

For more information, visit CHANGELOG.md for detailed version history and updates.