Changelog - PassiveRegen Mod

[1.1.0] - 2026-03-23

Added

• Gradle Build System: Complete migration from manual compilation to Gradle with automatic server jar downloads
• Advanced Configuration System: JSON-based configuration with 15 configurable settings
• Command System: Full /pregen command with extensive control options
  • /pregen reload - Reload configuration from disk
  • /pregen enable - Enable passive regeneration
  • /pregen disable - Disable passive regeneration
  • /pregen status - Show current system status
  • /pregen set <setting> <value> - Change any configuration setting
  • /pregen get <setting> - Display current value of a setting
  • /pregen list - List all available configuration options
  • /pregen reset - Reset all settings to default values
• Health Threshold Configuration: Ability to set minimum health percentage before regen starts
• Low Health Multiplier: Increased regen rate when player health is below threshold
• Diminishing Returns System: Configurable diminishing returns for high health values
• Regen Cap System: Optional cap on maximum health restoration per regen cycle
• Max Regen Per Interval Control: Limit HP restored per regeneration tick
• OP-Only Command Protection: Optional requirement for server operators to use configuration commands

Changed

• Configuration Format: Upgraded from simple 4-setting config to comprehensive JSON-based system with 15 options
• Communication: All in-game messages now in English
• Description: Updated manifest to reflect extensive configuration capabilities

Improved

• Performance: Maintained efficient ECS-based implementation
• Flexibility: Users can now fine-tune regen behavior to match any server needs
• User Control: Admin can adjust settings without restarting server (via /pregen reload)
• Default Behavior: Enhanced defaults work better out-of-box

Configuration Settings (v1.1.0)

Core Settings

• Enabled (boolean) - Enable/disable mod entirely
• OutOfCombatSeconds (double) - Time without combat before regen starts (default: 30.0)
• RegenAmount (double) - HP restored per tick (default: 1.0)
• RegenIntervalSeconds (double) - Seconds between regen ticks (default: 1.0)

Health Thresholds

• EnableHealthThreshold (boolean) - Only regen below certain health %
• HealthThresholdPercent (double) - Health % threshold (default: 100.0)

Low Health Multiplier

• LowHealthMultiplier (double) - Multiplier when health is low (default: 1.5)
• LowHealthThreshold (double) - % threshold for low health (default: 30.0)

Diminishing Returns

• EnableDiminishingReturns (boolean) - Enable diminishing returns
• DiminishingThreshold (double) - % above which diminishing returns apply (default: 80.0)
• DiminishingMultiplier (double) - Multiplier for high health (default: 0.5)

Advanced

• MaxRegenPerInterval (double) - Max HP per tick, -1 for unlimited (default: -1.0)
• EnableRegenCap (boolean) - Enable maximum health cap
• RegenCapPercent (double) - Max health restoration % (default: 100.0)
• RequireOpCommands (boolean) - Require OP status for commands (default: true)

Examples

Fast Regen:

/pregen set amount 2.0
/pregen set interval 0.5

Results in 4 HP/second regeneration

Conservative Regen:

/pregen set combat 60.0
/pregen set enablethreshold true
/pregen set threshold 50

Requires 60 seconds out of combat AND must be below 50% health

Balanced Configuration:

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

Technical Details

• Built on Hytale's ECS system for per-player entity tracking
• BuilderCodec-based configuration for robust JSON persistence
• Automatic configuration reload and save operations
• Thread-safe cooldown management per player
• Comprehensive logging of configuration changes

Fixed

• N/A (Initial release with Gradle migration)

Known Limitations

• Day/night cycle multipliers not implemented (intentionally simplified)
• Particle effects not implemented (intentionally simplified)
• Sound effects not implemented (intentionally simplified)
• Food requirement integration not implemented (intentionally simplified)
• Environmental factors (water, lava, air) not checked (intentionally simplified)
• Movement restrictions not enforced (intentionally simplified)

[1.0.0] - Previous Version

Features

• Basic passive health regeneration after out-of-combat timer
• Simple JSON configuration
• Combat-aware timer reset
• Performance-friendly ECS implementation

Quick Start

# Check status
/pregen status

# Adjust settings
/pregen set combat 45      # Change timer to 45 seconds
/pregen set amount 2.0     # Regenerate 2 HP per tick

# Save and reload
/pregen reload

# View current value
/pregen get combat

# Reset to defaults
/pregen reset