Detailed guide to health options
Health increases the max HP of the player. It works by adding an AttributeModifier to the GENERIC_MAX_HEALTH attribute. It is applied on PlayerJoinEvent, health stat changes, and config reloads.


Health is calculated based on the Health stat level:
GENERIC_MAX_HEALTH = 20.0 + (Stat.HEALTH * health.modifier)
Where Stat.HEALTH is the Health Stat Level visible with /stats and health.modifier is the config option "health.modifier" (Default value 0.5)
A "health.modifier" of 1.0 means that every Health Stat level increases the player's HP by 1.0

Health Scaling:

If "" is set to true, the amount of hearts displays on the player's screen is affected by their max health, preventing a player's health from blocking their entire screen. This means that the amount of hearts the player sees will not be 1 heart = 2 HP if their health is greater than 20.0
The amount of hearts displayed on the screen can be customized in the config under the "health.hearts" section of config.yml. The key is the number of heart, and the value is the minecraft health that amount of hearts is unlocked at. For example, if two entries are '12': 29 and '13': 37, this means the player will have 12 hearts shown on their screen when their minecraft health is from 29 (inclusive) to 37 (exclusive).
The values are not the HP shown on the action bar. To find the HP from the action bar the value is, multiply it by the health.hp-indicator-scaling option (default is 5). This supports hearts below 10 and hearts above 20, just add entries with the key as the number of hearts. The order of keys and values should be sequential, otherwise higher heart entries will override lower ones.
This is purely cosmetic, changing these options does not change the actual hp you have, and it only works if you have "" set to true.

HP Indicator Scaling

HP Indicator Scaling is the amount the player's raw attribute health should be multiplied by to get the displayed HP on the action bar. It is changed through the config option "health.hp-indicator-scaling". The default value of 5 makes it so that 20.0 raw HP = 100 Displayed Action Bar HP. This is also cosmetic and does not affect the actual amount of health a player has.
Last modified 4mo ago
Export as PDF
Copy link
Edit on GitHub