FabricHealthDisplay
Combat in Minecraft is all about split-second decisions, and nothing ruins those decisions faster than losing track of your own health bar in the middle of a fight. FabricHealthDisplay is a lightweight client-side add-on that puts your current health front and center, displaying it in the format you prefer so you always know exactly how much punishment you can still take. Whether you are dueling on a PvP server, speedrunning, or just exploring caves, this mod keeps your vitals visible without cluttering the screen.
What FabricHealthDisplay Does
At its core, FabricHealthDisplay renders your health value on screen for a configurable amount of time whenever it changes. Instead of relying solely on the vanilla hearts in your hotbar, you get a clear numeric or symbolic readout that is easy to parse at a glance. The mod supports four distinct display modes, so you can tailor the experience to your playstyle:
- Mode 0 - None: nothing is displayed for that user, useful if you want the mod installed but silent.
- Mode 1 - Hearts: your health is shown as a count of hearts, matching vanilla intuition.
- Mode 2 - Percent: health appears as a percentage of your maximum health, great for players with lots of extra hearts or absorption.
- Mode 3 - Fraction: the classic health/maxHealth format, ideal for precise PvP awareness.
By default the readout stays visible for 3000 milliseconds after a health change, which is long enough to register during combat but short enough to stay out of the way. The default display mode is set to 1, so new users immediately see the hearts format.
Commands and Configuration
In-Game Commands
FabricHealthDisplay ships with a configurable command system. The command aliases are defined in the config as an array, with the defaults being "fabrichealthdisplayer", "fhd", "healthdisplayer", and "hd". That means you can type a short alias like /fhd to open your display settings instead of the full name. Command access is controlled by two options: commandRequiresPermission, a boolean that defaults to false, and the paired commandPermission string (default "fabrichealthdisplayer.use") and commandOpLevel integer (default 1). Server operators can therefore lock down who is allowed to change display settings, or leave it wide open for everyone.
The Config File
All settings live in fabrichealthdisplayer.json inside your config directory. Alongside the command options above, you will find commandSuccessText, which defaults to "[✓] Updated your display settings!" and is shown whenever a player changes their command level. The allowPlayersToChangePersonalSettings boolean, true by default, decides whether individual players can tweak their own display mode. When enabled, their choices are stored in the playerPreferences JSON object, so preferences persist between sessions. The displayTime integer and defaultDisplayMode integer round out the file and control how long the readout lingers and which mode new players start with.
Requirements and Compatibility
This is a Fabric add-on, so you will need the Fabric loader installed before anything else. It also depends on BFAPI, which must be present for the mod to function correctly. FabricHealthDisplay targets modern Minecraft releases in the 1.20 and 1.21 era, and it is worth checking the project pages for the exact supported version list before you install, since Fabric mods are version-sensitive. If you play on a server, remember this is a client-side mod, so you can use it anywhere without the server needing to install anything.
If you would rather skip manual file juggling, the foxygame.net launcher bundles FabricHealthDisplay directly in its add-on catalog, letting you tick a box and launch a ready-to-play profile with the correct loader and dependencies already matched. That approach also means auto-updates arrive without you re-downloading jars by hand.
How to Install FabricHealthDisplay
Getting the mod running takes only a few minutes if you follow the standard Fabric workflow:
- Install the Fabric loader for your Minecraft version.
- Place the BFAPI jar and the FabricHealthDisplay jar into your mods folder.
- Launch the game once so the config file generates in the config directory.
- Edit fabrichealthdisplayer.json to set your preferred display mode, timing, and command permissions.
- Join a world and use /fhd or another alias to adjust your personal settings on the fly.
When you download FabricHealthDisplay, always grab the build that matches your exact game version to avoid startup crashes. After installation, test the command aliases in a single-player world before taking it onto a server, and confirm that BFAPI loaded correctly in the mod list.
Final Thoughts
FabricHealthDisplay for Minecraft solves a small but genuinely annoying problem: never quite knowing how close you are to death. With four display modes, persistent per-player preferences, and a flexible command and permission system, it fits both casual players and server administrators. Install it once, tune the config to taste, and your health will always be exactly where your eyes already are.