HardcoreRegen

HardcoreRegen
Silent, configurable emergency regeneration for scripted hardcore servers
HardcoreRegen is a lightweight Paper plugin that allows server administrators to selectively enable slow health regeneration for specific players.

It is designed for scripted hardcore events, cinematic server content, story-driven gameplay, controlled challenges, and custom mechanics where selected players need emergency regeneration without visible potion effects, particles, sounds, or regeneration icons.

Players are managed directly through an in-game administrator GUI, making it easy to enable or disable the mechanic without editing files or using complicated commands.

Features
In-game administrator GUI
Use a simple chest-style inventory menu to manage the plugin.

The GUI includes:

• Online players displayed as player heads
• Green names for players with regeneration enabled
• Red names for players with regeneration disabled
• Current health display for each player
• Click-to-toggle player selection
• Global plugin enable/disable button
• Configurable heart threshold
• Configurable healing interval
• Configurable healing amount
• Built-in explanation item describing the plugin behavior

Per-player controls
Regeneration is only applied to players manually enabled through the administrator menu.

Each selected player is stored by UUID, so their setting remains active after:

• Server restarts
• Plugin reloads
• Player disconnects
• Player reconnects
• Player name changes

Fully configurable healing
The following settings can be adjusted directly from the GUI:

• Health threshold that activates regeneration
• Amount restored per healing pulse
• Time between healing pulses
• Global plugin enable/disable state

The default configuration restores half a heart every four seconds while the player is at or below one heart.

Visually silent behavior
HardcoreRegen does not apply a potion effect or use the normal regeneration status effect.

The plugin does not create:

• Potion particles
• Regeneration particles
• Healing sounds
• Potion icons
• Visible item interactions
• Inventory-based effects

Health is updated directly by the server, keeping the mechanic visually clean for scripted gameplay.

Persistent configuration
Player selections are saved automatically in:

plugins/HardcoreRegen/players.yml
No external database is required.

Default behavior
Trigger threshold: 1 heart
Healing amount: 0.5 heart
Healing interval: 4 seconds
For example, if a selected player reaches one heart or less, the plugin gradually restores health every four seconds until the player rises above the configured threshold or reaches their normal maximum health.

Commands
/hardcoreregen
Opens the HardcoreRegen administrator GUI.

/hr
Alias for /hardcoreregen.

/hardcoreregen reload
Reloads the plugin configuration and player settings.

Permissions
hardcoreregen.admin
Allows a player to:

• Open the administrator GUI
• Enable or disable regeneration for players
• Change the threshold
• Change the healing amount
• Change the healing interval
• Toggle the plugin
• Reload the configuration

The permission is granted to server operators by default.

Installation

1. Download the HardcoreRegen jar.
2. Place it in your server's plugins folder.
3. Make sure you are running Paper 1.20.x or a compatible fork.
4. Restart the server.
5. Run:

/hardcoreregen

1. Click player heads to enable or disable emergency regeneration.

Requirements

• Paper 1.20.x
• Java 17 or newer
• Permission to manage server plugins
• No database or external service required

Included files

• Ready-to-install plugin jar
• Source code bundle
• Default configuration
• Persistent player settings
• In-game administrator GUI
• Reload command
• Permission support

Intended use
HardcoreRegen is intended for:

• Scripted hardcore servers
• Custom server events
• Story-driven gameplay
• Cinematic recordings
• Content creator servers
• Controlled challenge mechanics
• Custom survival experiences
• Server-owned health mechanics

This plugin is designed to be visually silent during gameplay, but server administrators should understand that server-side health changes may still be observable to other server plugins, logs, or administrative monitoring tools.

Support
Before requesting support, please include:

• Your Paper version
• Your Java version
• Your server console output
• The plugin version
• A list of other plugins that may modify player health