Private, lightweight combat feedback for modern Minecraft servers.
Inspect a mob before the fight. See every hit when combat begins.

---

Combat information without the clutter

LightHealth is a focused mob health plugin and damage indicator for Paper, Purpur, and Folia. Aim at a mob to inspect its HP without attacking, then get clear, responsive feedback as soon as combat starts.

Every display is drawn per viewer with TextDisplay entities, so mob names stay untouched, nobody is forced to see your UI, and no other plugin is required.

Inspect Aim at a mob to see its health before attacking.

Fight Get holograms, damage numbers, and personal bars.

Stay in control Use /lh toggle and /lh status at any time.

What players see

Channel	What the player sees	Default
Hologram	A health bar floating above the mob	On
Damage numbers	Rising amounts, colored by how hard you hit, with a distinct crit look	On
Action bar	Personal health and damage line, shifting green → yellow → red	On
Boss bar	The same feedback at the top of the screen, for bosses and arenas	Off
Look-at inspect	A mob's HP while you aim at it, no hit required	On

Not a nametag plugin

	Nametag-based plugins	LightHealth
Mob names	Rewritten with HP text	Untouched
Visibility	Everyone sees the same tag	Per viewer, /lh toggle opt-out
Damage feedback	Usually none	Floating numbers with crit styling
Before the fight	Hit first, then read HP	Aim to inspect
Dependencies	Often ProtocolLib or similar	None

Pick a style

Set style in config.yml, or write your own MiniMessage template.

Style	Example
bar	[██████████░░] 17/20
hearts	❤❤❤❤❤❤❤❤❤❤ 17/20 (missing hearts dim to gray)
numeric	❤ 17/20
custom	<bar> <white><health></white>/<gray><max></gray>

Placeholders: <health> <max> <percent> <amount> <name> <hearts> <bar> <symbol>.

Get started

1. Download the latest jar from GitHub Releases.
2. Move it into your server's plugins/ folder.
3. Restart the server, then look at or hit a mob.

Default configuration

language: en
style: bar
display:
  hologram: true
  damage-numbers: true
  actionbar: true
  bossbar: false

look-at:
  enabled: true
  range: 12
  show:
    hologram: true
    actionbar: true
    bossbar: false

Damage tiers, timings, view distances, blacklists, and custom formats live in the configuration guide. Missing keys are merged in automatically after an update, so your config.yml survives upgrades.

Commands

Aliases: /lh, /lighthealth, /mhp.

Command	Permission	Description
/lh	—	Show help
/lh toggle	lighthealth.toggle	Turn personal feedback on or off
/lh status	—	Show personal setting, active channels, look-at, and style
/lh reload	lighthealth.admin	Reload config and messages
/lh lang <en|ru|es|zh>	lighthealth.admin	Set the plugin language

Full reference: commands & permissions.

Permissions

Permission	Default	Description
lighthealth.see	true	See health displays (bars, holograms, numbers, look-at)
lighthealth.toggle	true	Use /lh toggle
lighthealth.admin	op	Reload and language

Requirements

Server	Paper, Purpur, or Folia 1.21.4+ (Paper 26.x included)
Java	21+ on 1.21.x · 25+ on 26.x (Minecraft itself requires 25)
Dependencies	None
Languages	English, Russian, Spanish, Chinese

This is a Paper plugin. It will not load on CraftBukkit or Spigot.

Build

You need JDK 25 to compile (Paper 26.2 API). The published jar is Java 21 bytecode.

./gradlew build
# → build/libs/LightHealth-1.1.0.jar

Every push and pull request runs the same build and unit tests on GitHub Actions.

Links

Documentation · Releases · Report an issue · SpigotMC

License

MIT · bedepay