HP Bar Plus

<div id="header" align="center">

Issues Tracker

Fabric API

</div>

HPBarPlus

A lightweight, fully client-side health display mod. See HP bars above every entity — with customizable symbols, dynamic gradient colors, and per-entity filtering.

🎯 Symbol-Based HP Display

Health is shown using Unicode symbols above entity names.

- 1 HP = full symbol  |  1 HP = hollow symbol - *Example:* 19 HP → `❤❤❤❤❤❤❤❤❤♡`

🎨 Display Styles

Choose how health is displayed:

| Style | Example | |---|---| | Icons Only | `❤❤❤❤❤❤❤❤❤❤` | | Icons + Numbers | `❤❤❤❤❤❤❤❤❤❤ 20/20` | | Icon + Numbers | `❤ 20/20` | | Numbers Only | `20/20` |

🔤 Symbol Presets

Pick your favorite symbol style:

> ❤♡  ◆◇  ▼▽  ♦♢  ✦✧  ✮✰  ■□  ●○

🌈 Dynamic Gradient Colors

Colors change based on health percentage — from full to critical.

Custom - Custom — Classic red tones - Custom — Snow white → deep blue - Custom — Light → dark green - Custom — Blood red → near-black - Custom — Bright gold → dark bronze - Custom — Light purple → deep purple - 🎨 Custom — Pick your own 4-stop gradient (100% → 50% → 25% → 0%)

Save and load your own custom color presets!

🔍 Entity Filtering

Control exactly which entities display health bars:

- Show Self — Toggle Players, Hostile, Passive, Bosses - Show Self — Pick individual entity types from a searchable list - Supports localized search (type in English, Russian, or any language!) - Scrollable popup with per-entity checkboxes - Show Self toggle (3rd person only)

📐 Adjustable Render Distance

Set the HP bar visibility range from 8 to 64 blocks.

⚙️ In-Game Configuration

Full settings GUI accessible via Mod Menu. Every setting takes effect immediately — no restart needed.

💾 Persistent Settings

All configuration is stored in `config/HPBarPlus/settings.json`. Legacy config files are automatically migrated.

---

🖥️ Client-Side Only

This mod is fully client-side — no server installation required. Works on any server, singleplayer, and LAN.