Fabric player-health visibility

Player Health Indicator Mod with clear hearts above players.

A technical guide to the Player Health Indicators project: how its heart renderer works, what the current 1.21 build requires, which version searches are not officially confirmed, and how to install or troubleshoot it without guessing.

Fabric client modFabric API requiredLatest official release: 1.1.1 for 1.21
What it is

A focused player-health renderer built around Minecraft-style hearts.

Player Health Indicators renders another player’s health above their name using heart textures rather than a generic progress bar. The renderer reads current health, maximum health, and absorption, then draws full, half, empty, and absorption hearts in the world view.

The project also uses the game’s HUD heart texture source, so a compatible texture pack can influence the visual appearance of the indicator instead of forcing a completely separate visual language.

Player focusedRenders health for other players
Effect awareSupports health boost and absorption
Texture awareUses HUD-style heart textures
Gameplay-style visual of a player with health and absorption hearts above the character
Features

Three core behaviors that define the original project.

These are the practical features documented by the project description, release history, and current renderer code—not generic health-mod assumptions.

01

Vanilla-style heart display

Other players can be shown with heart-based health information above their model, including full, half, and empty heart states tied to their actual health values.

02

Absorption and boosted health

The indicator accounts for extra health states such as absorption, allowing temporary yellow hearts to be represented separately from normal red health.

03

Toggle, stacking, and offset control

The project supports toggling the indicator through controls, while later releases added optional heart stacking and adjustable vertical offset for cleaner placement.

How it works

From player health values to a world-space row of hearts.

The current renderer hooks into player rendering, checks whether the indicator should be visible, reads health values, and draws the heart sprites above the player model.

1

Detect eligible players

The renderer targets other client players and avoids drawing the local player’s own overhead row.

2

Read health state

Current health, maximum health, and absorption are converted into full, half, empty, and yellow heart counts.

3

Render heart sprites

The hearts are placed above the player model, facing the camera so the indicator stays readable during movement.

4

Apply user controls

Rendering can be toggled, and supported builds can use heart stacking plus a configurable vertical offset.

Compatibility

Use the official project line as the baseline.

Latest published release1.1.1 for Minecraft 1.21
LoaderFabric
Client/server roleClient-side environment
Master branch requirementsFabric Loader ≥ 0.15.11, Java ≥ 21, Fabric API
Historical release lines1.20.1, 1.19.x and older supported releases exist
Version search reality

“1.21.4”, “1.21.7”, “1.21.8”, “1.21.10”, and “1.21.11” are not the same as the official 1.21 release label.

The project’s published release history currently shows 1.1.1 for Minecraft 1.21 as the latest official release. Public issue activity includes requests for newer point releases, so do not assume that the 1.21 build is automatically compatible with every later 1.21.x version.

Likewise, the supplied project metadata identifies Fabric—not Forge—and it is a Java Edition mod rather than an MCPE/Bedrock add-on.

Download Now
Use cases

Where an overhead heart row adds useful information.

The mod is most valuable when another player’s health state matters faster than opening menus or relying on indirect damage cues.

PvP awareness

Read an opponent’s remaining health more directly when the server and client setup allow the indicator to render.

Team coordination

See when teammates are low, boosted, or carrying absorption hearts before deciding whether to push, retreat, or regroup.

Texture-pack setups

Because the project uses HUD-style heart textures, compatible resource packs can keep the indicator visually consistent with the rest of the interface.

Download

Download Player Health Indicator Mod

The required primary button below uses the supplied GitHub master archive. That target is a source-code ZIP, so it should not be confused with a compiled release JAR. For gameplay installation, verify that the package you use is built for your exact Minecraft and Fabric versions.

Before changing a working profile, back up the instance and confirm the loader, game version, Java version, and Fabric API requirement.

Gameplay-style visual showing a player with overhead health hearts
01. Establish a clean Fabric baseline

Launch the target profile before adding the mod.

If Minecraft, Fabric Loader, Java, and Fabric API do not launch cleanly on their own, adding the health indicator makes diagnosis harder.

02. Use a build made for that game version

Do not treat “1.21” as a universal 1.21.x label.

The official latest release is labeled for Minecraft 1.21. A later point release can change mappings or APIs, so verify exact support rather than renaming or forcing a file.

03. Test the indicator in a controlled session

Check another visible player and confirm hearts render above the model.

If the game starts but the indicator is absent, first confirm the mod loaded, Fabric API is present, the toggle is enabled, and the target player is not hidden by visibility conditions.

04. Adjust layout only after basic rendering works

Use stacking and vertical offset as refinement tools.

Optional heart stacking and Y-offset control are useful for crowded displays, but they should be tuned after you know the base renderer is functioning.

!
Safety notice

Keep installation reversible and version-specific.

Back up worlds and profiles before changing mod files. Use only packages whose target version and loader are clear, avoid mixing duplicate builds, and remember that the supplied master ZIP is source code rather than a guaranteed install-ready JAR.

Pros and cons

Useful visibility with a narrow compatibility envelope.

The original project is deliberately focused: it adds player-health information without trying to become a broad combat HUD.

Strengths

  • Simple overhead heart display that is easy to read during play.
  • Accounts for half hearts, missing hearts, and absorption.
  • Uses HUD-style heart textures, supporting visual consistency with compatible resource packs.
  • Optional stacking and vertical offset improve placement in supported releases.
  • Client-side design keeps the feature focused on the local player’s view.

Limitations

  • The supplied project is Fabric-based; Forge searches do not map directly to it.
  • The latest official release is labeled Minecraft 1.21, not every later 1.21.x point release.
  • It is a Java Edition mod, not an MCPE/Bedrock add-on.
  • Compatibility still depends on loader, Java, Fabric API, and game version matching.
  • Visibility rules can prevent rendering for players the client cannot see normally.
Release information

Latest official release: 1.1.1 for Minecraft 1.21.

Published July 27, 2024, version 1.1.1 fixed hearts being flipped after the project’s update to Minecraft 1.21.

Notable release history

The 1.1.0 release line added optional heart stacking and the ability to change the vertical offset of the hearts. Earlier releases also included compatibility work across older Minecraft versions.

Newer point-version searches should be checked against actual releases rather than inferred from the 1.21 label. Public issue activity shows users requesting newer 1.21.x updates, which is a useful signal that exact support should be verified.

Troubleshooting

Diagnose loader failures separately from rendering failures.

A clean troubleshooting path identifies whether the problem happens before Minecraft reaches the menu, when the mod loads, or only when the hearts should appear.

Game does not finish loading

Confirm Minecraft version, Fabric Loader, Java, and Fabric API first. Remove the new mod file and verify the baseline profile still launches before testing again.

Mod loads but no hearts appear

Check the rendering toggle, confirm you are viewing another eligible player, and test without unrelated HUD or rendering modifications.

Hearts overlap names or UI

Use the supported Y-offset option and heart stacking where available, especially when a nameplate, scoreboard objective, or many hearts share the same vertical space.

Later 1.21.x profile fails

Do not assume the official 1.21 release is compatible with 1.21.4, 1.21.7, 1.21.8, 1.21.10, or 1.21.11. Move back to a confirmed version or wait for an explicit matching build.

Guides preview

Version-aware setup and troubleshooting guides.

Read focused guides for common searches without assuming that similarly named versions are interchangeable.

Original Forge compatibility illustration

Player Health Indicator Mod Forge compatibility

What to verify before using a Forge-targeted build.

Read guide →
Original older-version health indicator illustration

Player Health Indicator Mod 1.8 9 guide

Why older game profiles need their own matching packages.

Read guide →
Original mod troubleshooting illustration

Installation and troubleshooting

A clean sequence for diagnosing startup and display issues.

Read guide →
View All Guides
FAQ

Verified questions about features, versions, and setup.

These answers distinguish confirmed project behavior from common search terms that do not have an explicitly published matching build.

It renders other players’ health above them as Minecraft-style hearts, using current health, maximum health, and absorption to determine the visible heart states.
Yes. The current project metadata identifies Fabric as the loader and lists Fabric API as a required dependency.
Yes. The project metadata marks the environment as client, so the indicator is designed to run in the player’s local client environment.
The current renderer targets other client players and explicitly avoids drawing the local player’s overhead health row.
Yes. The renderer calculates odd health values and uses half-heart states when needed.
Yes. Absorption is read separately and rendered with yellow heart states above the normal health calculation.
The project description says it uses the same heart texture source as the HUD, so compatible texture packs can change how those hearts look.
Yes. The project description notes a keybind can be set in controls to toggle health bars on or off.
Heart stacking lets long rows wrap into multiple rows, while Y offset changes the vertical placement of the indicator above a player. These options were added in the 1.1.0 release line.
The 1.1.1 release for Minecraft 1.21 fixed hearts appearing flipped after the 1.21 update.
The latest published release shown in the project history is PlayerHealthIndicators 1.1.1 for Minecraft 1.21, released July 27, 2024.
The supplied project metadata identifies Fabric, not Forge. A Forge search should not be treated as evidence that this exact project has an official Forge build.
The published release history does not show an official 1.21.11 build for this project. Public issues include requests for a 1.21.11 update, so exact support should be considered unconfirmed.
The latest official release is labeled 1.21 rather than 1.21.10. Verify a dedicated build before using the mod on that point release.
Those are later point-version searches, while the official latest release is labeled Minecraft 1.21. Do not assume compatibility without a build that explicitly names the target version.
The project’s public activity has included requests and development discussion around 1.21.4, but the published official release history shown here still centers on the 1.21 build. Treat 1.21.4 support as something to verify, not assume.
The published release history does not list 1.8.9, and public project issues include a request for that version. That means 1.8.9 should not be presented as an official supported build of this project.
This project is a Java Edition Fabric mod. MCPE/Bedrock uses a different add-on system, so the same package and installation method do not apply.
It lists Fabric Loader 0.15.11 or newer, Minecraft 1.21, Java 21 or newer, and Fabric API.
The required Download button on this site points to the supplied GitHub master source archive. A source ZIP is not the same thing as a compiled mod JAR, so verify the package format before installing anything.