Action Bar Health

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

Default Style:
  Zombie: ❤❤❤❤❤❤❤♡♡♡
  Health Numbers:
  Zombie - 15/20 ❤❤❤❤❤❤❤♡♡♡
  Percentage Style:
  Zombie (75%) ❤❤❤❤❤❤❤♡♡♡
  Minimal:
  ❤❤❤❤❤❤❤♡♡♡

Commands

Permissions

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

# 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

Perfect for competitive PvP servers where tracking opponent actions gives strategic advantage!

Plugin Integrations

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 (繁體中文)

All translations include every mob through Minecraft 1.21.1, including Breeze, Bogged, Sniffer, Camel, Warden, and more!

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

Performance:
    PlayersPerTick: 20      # Players processed per tick for look-detection
    AdaptiveBatching: true  # Auto-adjusts based on player count

Installation

1. Download ActionHealth-4.0.0.jar
2. Place in your server's /plugins folder
3. Restart your server (or use a plugin manager)
4. Edit /plugins/ActionHealth/config.yml to customize
5. Use /actionhealth reload to apply changes

Frequently Asked Questions

Support

• Feature Requests: Post in Discussions

If you enjoy ActionHealth, please leave a rating and review!