promotional bannermobile promotional banner
premium banner
This API changes how health regeneration works and disables the food system.

Description

Health Regeneration Overhaul

This API changes the way health is regenerated. Instead of depending on the hunger system, two new entity attributes are used.
The hunger system including exhaustion and saturation is disabled by default, but it can be re-enabled in the server config.

Default implementation

Health is regenerated by generic.health_regeneration every generic.health_tick_threshold ticks.

When health is reduced, regeneration is stopped for generic.health_regeneration_delay_threshold ticks.

Default attribute values

  • generic.health_regeneration: 0
  • generic.health_tick_threshold: 100
  • generic.health_regeneration_delay_threshold: 100

Customization

When the vanilla gamerule "naturalRegeneration" is true, players have a health regeneration of at least 1.

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

API

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