ActionHealth
Display entity health beautifully in the action bar
Version 4.0.0 | MC 1.17 - 1.21.1 | Java 21+
Overview
ActionHealth displays the health of any entity in your action bar when you
attack or
look at them. Perfect for PvP servers, survival gameplay, RPG servers, and any server where knowing your enemy's health matters.
Instead of guessing how close a mob or player is to death, you get instant visual feedback with customizable health bars, heart icons, and detailed information.
Features
- Action Bar Display - Clean, non-intrusive health display above your hotbar
- Attack Detection - See health when you hit any entity (melee or ranged)
- Look Detection - Optionally see health just by looking at entities
- Custom Heart Styles - Configurable filled, half, and empty heart icons with colors
- Player Toggle - Players can enable/disable for themselves with a simple command
- Persistent Preferences - Optionally remember player toggle states
- 12 Language Translations - Built-in mob name translations for multiple languages
- Client Language Support - Display mob names in each player's Minecraft language (with LangUtils)
- Combat Action Tracking - Alert tagged opponents when you use potions, golden apples, ender pearls, etc.
- Blacklist & Whitelist - Control exactly which entities show health
- World & Region Control - Disable in specific worlds or WorldGuard regions
- MythicMobs Support - Full compatibility with custom MythicMobs creatures
- PlaceholderAPI Support - Use any placeholder in your health messages
- Scalable Performance - Adaptive batching for servers with 100+ players
- Fully Customizable - Every message, icon, and behavior can be configured
Display Examples
Code (Text):
Default Style:
Zombie: ❤❤❤❤❤❤❤♡♡♡
Health Numbers:
Zombie - 15/20 ❤❤❤❤❤❤❤♡♡♡
Percentage Style:
Zombie (75%) ❤❤❤❤❤❤❤♡♡♡
Minimal:
❤❤❤❤❤❤❤♡♡♡
Commands
| Command | Description | Permission |
| /actionhealth | Shows help information | None |
| /actionhealth toggle | Toggle health display on/off for yourself | None |
| /actionhealth reload | Reload the configuration | ActionHealth.Reload |
Permissions
| Permission | Description | Default |
| ActionHealth.Health | Allows seeing health displays (when "Use Permissions" is enabled) | Everyone |
| ActionHealth.Reload | Allows using the reload command | OP only |
Placeholders
Use these in your
Health Message configuration:
| Placeholder | Description | Example Output |
| {name} | Entity name | Zombie |
| {health} | Current health | 15 |
| {maxhealth} | Maximum health | 20 |
| {percenthealth} | Health percentage | 75 |
| {usestyle} | Heart icon display | ❤❤❤❤❤❤❤♡♡♡ |
| {displayname} | Player/entity display name | §6PlayerName |
| {opponentlastdamage} | Last damage taken | 5 |
If another plugin overrides a placeholder, prefix with ah (e.g., {ahhealth})
PlaceholderAPI: All PlaceholderAPI placeholders work! Use ATTACKEDPLAYER_ prefix to get the attacked player's placeholders instead of the attacker's.
Configuration
Spoiler: Full config.yml (Click to expand)
# ActionHealth Configuration
# Requires: Minecraft 1.17+ | Java 21+
# Main health message format
Health Message : '&7&l {name } : {usestyle }'
# Separate message for mobs (leave empty to use above)
Non Player Message : ''
# Messages
Toggle Message : ''
On Enable : '&7ActionHealth has been &cenabled&7.'
On Disable : '&7ActionHealth has been &cdisabled&7.'
# Display Settings
Strip Name : true
Use Permissions : false
Show Mob : true
Show Player : true
Show NPC : true
# Delay for accurate health (useful with custom damage plugins)
Delay Message : false
Delay Tick : 1
# Heart Style Icons
Full Health Icon : "&4❤"
Half Health Icon : "&c❤"
Empty Health Icon : "&7❤"
# World/Region Control
Disabled worlds :
- example_world
Disabled regions :
- pvp_disabled_region
Region PvP : true
# Health Display Limits
Limit Health : 10
Upper Limit Health : "40 -> 10"
# Player Preferences
Remember Toggle : false
# Entity Filtering
Blacklist :
- 'Shop NPC'
Whitelist : [ ]
# Look-at Feature
Show On Look : true
Look Distance : 10
LookValues:
CheckTicks : 0
Dot : 0
Tolerance : 4
# Performance (for large servers)
Performance:
PlayersPerTick : 20
AdaptiveBatching : true
# Visibility
Can See : true
Invisible Potion : true
Spectator Mode : true
ShowMiniaturePets : true
ShowArmorStand : true
# Name Translations
Name Change : false
Name :
- Snow Golem = Snowman
Use Client Language : false
# Metrics
Allow Metrics : true
# Combat Action Tracking
Action:
Enabled : false
TagLength : 20
TagAmount : 2
Events:
CONSUME:
GOLDEN_APPLE : '&7&l {name } consumed &cgolden apple&7&l!'
REGENERATION_POTION : '&7&l {name } consumed &cregen potion&7&l!'
RIGHTCLICK:
ENDER_PEARL : '&7&l {name } used &cender pearl&7&l!'
SWAP:
ENDER_PEARL : '&7&l {name } swapped to &cender pearls&7&l!'
DAMAGE:
ANY : '&7&l {name } : {usestyle }'
Code (YAML):
# ActionHealth Configuration
# Requires: Minecraft 1.17+ | Java 21+
# Main health message format
Health Message : '&7&l {name } : {usestyle }'
# Separate message for mobs (leave empty to use above)
Non Player Message : ''
# Messages
Toggle Message : ''
On Enable : '&7ActionHealth has been &cenabled&7.'
On Disable : '&7ActionHealth has been &cdisabled&7.'
# Display Settings
Strip Name : true
Use Permissions : false
Show Mob : true
Show Player : true
Show NPC : true
# Delay for accurate health (useful with custom damage plugins)
Delay Message : false
Delay Tick : 1
# Heart Style Icons
Full Health Icon : "&4❤"
Half Health Icon : "&c❤"
Empty Health Icon : "&7❤"
# World/Region Control
Disabled worlds :
- example_world
Disabled regions :
- pvp_disabled_region
Region PvP : true
# Health Display Limits
Limit Health : 10
Upper Limit Health : "40 -> 10"
# Player Preferences
Remember Toggle : false
# Entity Filtering
Blacklist :
- 'Shop NPC'
Whitelist : [ ]
# Look-at Feature
Show On Look : true
Look Distance : 10
LookValues:
CheckTicks : 0
Dot : 0
Tolerance : 4
# Performance (for large servers)
Performance:
PlayersPerTick : 20
AdaptiveBatching : true
# Visibility
Can See : true
Invisible Potion : true
Spectator Mode : true
ShowMiniaturePets : true
ShowArmorStand : true
# Name Translations
Name Change : false
Name :
- Snow Golem = Snowman
Use Client Language : false
# Metrics
Allow Metrics : true
# Combat Action Tracking
Action:
Enabled : false
TagLength : 20
TagAmount : 2
Events:
CONSUME:
GOLDEN_APPLE : '&7&l {name } consumed &cgolden apple&7&l!'
REGENERATION_POTION : '&7&l {name } consumed &cregen potion&7&l!'
RIGHTCLICK:
ENDER_PEARL : '&7&l {name } used &cender pearl&7&l!'
SWAP:
ENDER_PEARL : '&7&l {name } swapped to &cender pearls&7&l!'
DAMAGE:
ANY : '&7&l {name } : {usestyle }'
Combat Action Tracking
When enabled, ActionHealth can notify you when your combat opponent:
- Drinks a potion
- Eats a golden apple
- Uses an ender pearl
- Switches to specific items
- Takes damage from any source
Plugin Integrations
| Plugin | Integration |
| PlaceholderAPI | Use any placeholder in health messages |
| WorldGuard | Disable health display in specific regions |
| MythicMobs | Display custom MythicMobs names, blacklist by internal name |
| mcMMO | Properly displays entity names with mcMMO health bars |
| LangUtils | Show mob names in each player's client language |
Built-in Translations
ActionHealth includes mob name translations for
12 languages:
- English (Default)
- Spanish (Español)
- French (Français)
- German (Deutsch)
- Italian (Italiano)
- Brazilian Portuguese (Português BR)
- Russian (Русский)
- Polish (Polski)
- Turkish (Türkçe)
- Japanese (日本語)
- Korean (한국어)
- Chinese Simplified (简体中文)
- Chinese Traditional (繁體中文)
Performance
ActionHealth is built for servers of
any size:
- Small servers (< 50 players): Works perfectly with default settings
- Medium servers (50-100 players): No configuration needed
- Large servers (100+ players): Adaptive batching automatically distributes workload
Code (YAML):
Performance:
PlayersPerTick : 20 # Players processed per tick for look-detection
AdaptiveBatching : true # Auto-adjusts based on player count
Installation
- Download ActionHealth-4.0.0.jar
- Place in your server's /plugins folder
- Restart your server (or use a plugin manager)
- Edit /plugins/ActionHealth/config.yml to customize
- Use /actionhealth reload to apply changes
Frequently Asked Questions
Spoiler: Click to view FAQ
Q: How do I turn off health display for myself?
A: Use /actionhealth toggle
Q: Can I show health only when looking, not when attacking?
A: Set Show On Look: true and disable the damage listener by setting Action.Enabled: true with DAMAGE: ANY
Q: Why don't I see health for some mobs?
A: Check if they're blacklisted, in a disabled world/region, or invisible.
Q: Can I use different messages for players vs mobs?
A: Yes! Set Non Player Message in config.yml
Q: Does this work with custom mobs from other plugins?
A: Yes! Any LivingEntity works. MythicMobs has special integration.
Q: How do I change the heart colors?
A: Edit Full Health Icon, Half Health Icon, and Empty Health Icon using color codes.
Q: Will this cause lag on my server?
A: No. ActionHealth uses efficient event-driven updates with adaptive batching for large servers.
Q: Can I disable health display in PvP-disabled regions?
A: Yes! Set Region PvP: true to automatically disable in no-PvP WorldGuard regions.
A: Use /actionhealth toggle
Q: Can I show health only when looking, not when attacking?
A: Set Show On Look: true and disable the damage listener by setting Action.Enabled: true with DAMAGE: ANY
Q: Why don't I see health for some mobs?
A: Check if they're blacklisted, in a disabled world/region, or invisible.
Q: Can I use different messages for players vs mobs?
A: Yes! Set Non Player Message in config.yml
Q: Does this work with custom mobs from other plugins?
A: Yes! Any LivingEntity works. MythicMobs has special integration.
Q: How do I change the heart colors?
A: Edit Full Health Icon, Half Health Icon, and Empty Health Icon using color codes.
Q: Will this cause lag on my server?
A: No. ActionHealth uses efficient event-driven updates with adaptive batching for large servers.
Q: Can I disable health display in PvP-disabled regions?
A: Yes! Set Region PvP: true to automatically disable in no-PvP WorldGuard regions.
Support
- Feature Requests: Post in Discussions
If you enjoy ActionHealth, please leave a rating and review!
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.17, 1.18, 1.19
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
Action Bar Health is a free Minecraft Java mod. Compatible with Minecraft 1.17, 1.18, 1.19, 1.20 and newer. Downloaded 352 times (via Spigot). Download it and open it directly in the game.