🌟 Core Features

Precise Decimal Health Tracking: Vanilla Minecraft limits scoreboards to whole numbers, which means a player at 0.5 health looks identical to a player at 1.0 health. HealthIndicator bypasses this limitation. If a player drops below 1 full health point, the plugin dynamically displays their exact decimal health (e.g., 0.5 ❤️ or 0.7 ❤️), ensuring players know exactly when their opponent is one-shot.

Advanced Absorption & Golden Apple Display: When a player consumes a Golden Apple or gains absorption, the display splits dynamically. Instead of a single blended number, players will see their base health and their golden health separated beautifully.

Example without Absorption: 20 ❤️

Example with Absorption: 20 ❤️ | 4 💛

Fully Customizable via MiniMessage: The plugin features a robust config.yml that uses modern MiniMessage formatting. Server owners can customize colors using standard tags (like <red>, <yellow>, <bold>) or exact Hex codes (like <#FF5555>), and can completely change the symbols and layout without needing to touch the Java code.

Universal World Support: The plugin automatically tracks and updates the health of every online player across all server dimensions and custom worlds seamlessly.

⚙️ Technical Specifications

Supported Versions: Minecraft 1.21 and 1.21.1+

Required Java Version: Java 21 (Strictly required for 1.21 Minecraft servers).

Required Server Software: PaperMC, Purpur, or any modern Paper-fork. (Note: This plugin relies on the modern Paper API NumberFormat to override the vanilla integer limitations. It is not compatible with standard Spigot).

Dependencies: None. The plugin is 100% standalone and does not require PlaceholderAPI, ProtocolLib, or any other background plugins to function.

Performance: Highly optimized. It utilizes a lightweight repeating task that updates player scoreboards every 10 ticks (0.5 seconds), providing immediate feedback without straining server resources or causing TPS drops.

🛠️ Configuration (config.yml)

The plugin generates a simple, easy-to-read configuration file that allows admins to dictate exactly how the health string looks in both standard and absorption states.

YAML

----------------------------------------

HealthIndicator Configuration

----------------------------------------

You can use standard MiniMessage tags for colors: <red>, <white>, <yellow>, <bold>, <#HEXCODE>

Placeholders:

%health% - The player's base health number

%absorption% - The player's golden apple health number

Format when the player has normal health (no golden apples)

normal-format: "<white>%health%</white> <red>❤</red>"

Format when the player has golden apple hearts

absorption-format: "<white>%health%</white> <gray>|</gray> <yellow>%absorption% ❤</yellow>"