Health Regeneration Overhaul

Health Regeneration Overhaul

This API changes the way health is regenerated. Instead of depending on the hunger system, entity attributes are
used.

The vanilla hunger system including exhaustion and saturation is disabled by default.

Additionally, an entity attribute called _healthregenerationoverhaul:reserved_health_ is added and a vanilla bug that clamps player health to a maximum of 20 when respawning/joining a world has been fixed.

Default implementation

Health is regenerated by _healthregenerationoverhaul:health_regeneration_ every _healthregenerationoverhaul:health_tick_threshold_ ticks.

When health is reduced, regeneration is stopped for _healthregenerationoverhaul:health_regeneration_delay_threshold_ ticks.

_healthregenerationoverhaul:reserved_health_ describes the percentage amount of maximum health that is currently not available.

Default attribute values

• _healthregenerationoverhaul:health_regeneration_: 0
• _healthregenerationoverhaul:health_tick_threshold_: 100
• _healthregenerationoverhaul:health_regeneration_delay_threshold_: 100
• _healthregenerationoverhaul:reserved_health_: 0

Customization

When the vanilla game rule “natural_health_regeneration” is true, players have 1 additional health regeneration.

In the client config an alternative health bar can be enabled and customised.

The server config has options to set the default value for each attribute (including max_health). This only affects the attribute values for players, not other entities.

Also in the server config, the vanilla food system can be re-enabled.

API

Casting a “LivingEntity” to the “HealthRegeneratingEntity” interface gives access to all relevant methods.