Paletted Hearts

What does it do?

Palette Hearts is a client-side Fabric mod that replaces Minecraft's multiple heart rows with compact, dynamically colored hearts whenever the player has more than 10 hearts of health or absorption.

Unlike traditional heart-coloring mods, Palette Hearts dynamically recolors the heart textures from your active resource pack, rather than simply tinting them. This allows custom heart designs to retain their original shapes, transparency, outlines, and shading while displaying different colors for each health layer.

Both health and absorption hearts are condensed into their own single rows. When multiple layers are present, a small number beside the hearts indicates the current layer, keeping the HUD clean and easy to read.

Features

Dynamic Heart Recoloring: Generates recolored versions of the active resource pack's heart textures while preserving their original details where possible.

Compact Health Display: Condenses multiple rows of health into one color-coded row.

Condensed Absorption: Displays additional absorption hearts in a compact, layered format.

Health Layer Counters: Displays a small number beside health or absorption hearts when multiple layers are present.

Customizable Colors: Configure health, absorption, poison, wither, and freezing colors using hexadecimal #RRGGBB values.

Resource Pack Support: Automatically regenerates recolored textures when resource packs are reloaded.

Multiple Recoloring Modes: Choose between palette recoloring, traditional tinting, or original textures.

Client-Side Only: Does not require installation on the server.

Resource Pack Compatibility

Palette Hearts is designed to work with Minecraft resource packs that replace the vanilla heart textures.

The mod reads the active resource pack's heart sprites and creates recolored versions instead of requiring specially designed replacement textures.

Most ordinary static heart textures should work, although highly detailed, multicolored, animated, or unusually formatted textures may not recolor perfectly. Unsupported textures may fall back to their original appearance.

Mod Compatibility

Palette Hearts modifies Minecraft's vanilla health HUD rendering.

Dedicated compatibility with other HUD-modifying mods has not yet been verified. Mods that replace or significantly modify heart rendering may conflict with Palette Hearts.

If you encounter a compatibility issue, please report it with the conflicting mod's name, Minecraft version, and relevant logs or screenshots.

Configuration

All settings can be changed through:

config/palettehearts.json

Changes to the configuration require restarting Minecraft.

Requirements

Minecraft: 26.3

Mod Loader: Fabric

Dependency: Fabric API

Environment: Client-side

Credits

Inspired by Colorful Hearts by Terrails