Action Bar Health

Why ActionHealth

• It works on your server version. The same jar runs on Spigot, Paper and other forks from 1.8 to 26.3, and on Folia. You do not need a special build for old or new servers.
• New Minecraft versions should not need an update. ActionHealth does not check the server version. It detects which features the server has.
• You can change everything. The message, the heart icons, the colors and the look distance are all in the config.
• No required dependencies. Optional plugins are detected when they are installed.

Features

• Health on hit: when you hit a player or a mob, its health shows in your action bar. Arrows and other projectiles count too.
• Health on look: when you look at an entity, its health shows. On 1.13.2+, any part of the hitbox counts, so large mobs and ModelEngine models work. You can turn this off.
• Styles: use hearts, bars, lines or plain numbers. Examples are below.
• Absorption: a yellow heart shows each heart of absorption, for example from a golden apple.
• Colors: use & color codes or hex colors such as &#4fdfc4. Servers before 1.16 show the closest color.
• Display time: hide the action bar sooner than the client default of about 3 seconds.
• Action messages: see when an enemy you fought drinks a potion, eats a golden apple or uses an ender pearl. This is off by default. Turn it on with "Action" in the config.
• Toggle: players can turn ActionHealth off for themselves. The choice can be saved after they log out.
• Filters: turn it off in some worlds or WorldGuard regions, or for players, mobs, NPCs, invisible entities and spectators. Use a blacklist or a whitelist of names.
• Translations: rename mobs in the config, or use the client language with LanguageUtils.
• Config updates: when an update adds options, ActionHealth adds them to the end of your config.yml, with their comments. The rest of the file stays the same.

Supported versions

• Minecraft: Spigot 1.8 to 26.3, plus forks such as Paper and Folia.
• Java: 8 or newer. Use the Java version your server already runs.

Version 3.9.0 was tested on real servers with bots that check the action bar:

• Spigot: 1.8, 1.8.3, 1.8.8, 1.9, 1.9.4, 1.10.2, 1.11.2, 1.12.2, 1.13, 1.13.2, 1.14.4, 1.15.2, 1.16.1, 1.16.3, 1.16.5, 1.17.1, 1.18.2, 1.19.4, 1.20.1, 1.20.4, 1.20.6, 1.21.1, 1.21.4, 1.21.11, 26.1.2, 26.2, 26.3
• Paper: 1.8.8, 1.16.5, 1.20.6, 1.21.11, 26.3
• Folia: 1.21.11, 26.2
• Plugins: WorldGuard 6.1, 6.2.2, 7.0.15 and 7.0.19, PlaceholderAPI 2.12.3, ModelEngine R3.1.11

How the tests work

Commands and permissions

• /actionhealth reload: reloads the config. Permission: ActionHealth.Reload
• /actionhealth toggle: turns the health display on or off for you. Permission: ActionHealth.Toggle, which all players have by default.
• ActionHealth.Health: lets a player see health messages. This only applies when "Use Permissions" is true in the config.

Optional plugins

• WorldGuard (6 or 7, with WorldEdit): turn ActionHealth off in regions.
• PlaceholderAPI and MVdWPlaceholderAPI: use their placeholders in the message and in the health icons.
• MythicMobs (4 or 5): blacklist or whitelist mobs by their internal name.
• ModelEngine: shows health when you look at or hit a model. Tested with ModelEngine R3.
• mcMMO: shows the right mob name when mcMMO health bars are on.
• LanguageUtils: shows mob names in each player's client language.

Placeholders
Use these in the health message:

• {name}: the name of the player or mob
• {displayname}: the display name or custom name
• {health} and {maxhealth}: current and maximum health
• {percenthealth}: health left as a percentage
• {usestyle}: the health icons from the config
• {opponentlastdamage}: the last damage the target took
• {absorption}: the absorption health of the target

If another plugin replaces a placeholder first, add "ah" in front, for example {ahhealth}. PlaceholderAPI placeholders use the attacking player. Add ATTACKEDPLAYER_ to use the attacked player, for example %ATTACKEDPLAYER_player_exp%.

Config
Default config




Translations
Rename mobs with the "Name Change" option in the config. Community translations are on GitHub. You can share yours with a pull request.

Links

• Source code
• Report a bug
• All releases on GitHub