NaturalRegeneration

Natural Regeneration

A Hytale server plugin that passively regenerates player health after not taking damage for a configurable period of time.

Features

Automatic health regeneration after a delay period

Fully configurable via in-game commands

Persistent configuration saved to JSON

Optimized for server performance

Health Cap - Limit regeneration to a maximum HP value (absolute or percentage)

Update Checker - Automatically checks GitHub and CurseForge for new versions on startup and every 12 hours, notifies operators when they join

How It Works

When a player takes damage, their regeneration timer resets

After the configured delay (default: 10 seconds), health regeneration begins

Health regenerates at the configured rate until the player reaches max health or takes damage again

Commands

Command Description

/nr Shows help and available subcommands

/nr status Display current configuration

/nr toggle Enable or disable regeneration

/nr delay <seconds> Set delay before regeneration starts

/nr amount <hp> Set HP regenerated per tick

/nr interval <seconds> Set time between regeneration ticks

/nr healthcap <value> Set health cap (80 for absolute, 80% for percentage, none to disable)

Aliases: /naturalregeneration, /naturalregen, /nr

Configuration

Configuration is automatically saved to Server/mods/Toskan4134_NaturalRegeneration/NaturalRegeneration.json

Option Default Description

Enabled true Whether regeneration is active

DelaySeconds 10.0 Seconds after damage before regen starts

AmountHP 1.0 HP restored per regeneration tick

IntervalSeconds 1.0 Seconds between regeneration ticks

HealthCap "" Max HP to regenerate to ("80" for absolute, "80%" for percentage, "" for no cap)

CheckForUpdates true Whether to check for plugin updates

Example Configuration

{ "Enabled": true, "DelaySeconds": 10.0, "AmountHP": 1.0, "IntervalSeconds": 1.0, "HealthCap": "80%", "CheckForUpdates": true } Health Cap Examples

"80" - Won't heal above 80 HP (absolute value)

"80%" - Won't heal above 80% of max HP (percentage)

"" - No cap, heal to full health (default)

Update Checker

The plugin automatically checks for updates from GitHub and CurseForge:

Checks on server startup

Checks every 12 hours while the server is running

Logs to console when a new version is available

Notifies operators (players with * permission) when they join

Installation

Build the plugin JAR file

Place the JAR in your server's mods folder

Start/restart the server

Configure using in-game commands or edit the config file

Building

./gradlew build The compiled JAR will be located in build/libs/

License

MIT License

Author

Toskan4134