❤️ 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

1. Enter combat by attacking an enemy or taking damage.
2. Wait 30 seconds (configurable) without any combat action.
3. 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

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

1. Download the Linceros.PassiveRegen-1.1.0.jar.
2. Place the .jar file into your Hytale server's mods folder.
3. Start your server!
4. The mod will automatically create PassiveRegen.json config on first run.
5. (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.