Health-Indicator

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： bukkit paper spigot

标签： game-mechanics technology utility

? 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 , , ) 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: , , , , <#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: "%health% ❤"

Format when the player has golden apple hearts

absorption-format: "%health% | %absorption% ❤"