Troubleshooting

Setting names are given as Section — Setting, matching the plugin's settings panel.

No bar over other players

Other Player Bar — Style — Show for Other Players is off by default; add Always Show Player HP Bar for every visible player rather than only those you fight. Names are separate and on by default.

Other players show a percentage, never a number

The game does not send another player's max HP, so there is nothing to turn their bar into a number with.

An NPC shows a percentage instead of a number

Its max HP is missing from the bundled table, or it is a scaled minion in a team. See HP numbers.

The game's own health bar is still showing

Behavior — Hide Native Health Bar covers hitpoint bars only, so a native bar tracking a mechanic stays unless the plugin is drawing a replacement. Two hitpoint bars on one actor means the setting is off.

Bars disappear a few seconds after a fight

That is Persist Duration (seconds), 5 by default and set separately for NPCs and players; 0 hides bars immediately. To ignore combat entirely, use the matching Always Show setting.

An NPC's bar or name is grey

Another player has damaged it, so its loot is not yours. Ironman accounts only, bosses with shared or personal loot exempt, and controlled by Grey Out Health Bars and Grey Out Names.

All names or all bars vanished at once

A Hotkeys toggle has been pressed - they flip visibility instantly without changing a setting. Press the same key again, or restart the plugin, to bring them back.

Bars overlap, stagger, or vanish on a shared tile

Actors on one tile stack vertically, Prioritize Self on Same Tile hides anything standing on your tile, and the stack limits cap how many render per tile. Bars on adjacent tiles can still overlap at low camera angles.

No weakness icon on an NPC

NPC Bar — Info — Show Weakness Icon is off by default, and nothing is drawn for an NPC with no known elemental weakness.

Another player's prayer icon or skull is missing in a crowd

Only one set of overhead icons is drawn per tile, so a stack does not become a wall of icons. Your own icons always draw.

Hitsplats or chat text look slightly different

They are redrawn by the plugin, because hiding a player's health bar hides their whole overhead bundle - see Overhead replacement.

The bar drifts up and down during attack animations

Bars anchor to the actor's model height, which some animations change, so the whole group moves for the duration.

Nothing above helped

Check Known limitations, then open an issue with the details listed in Reporting a bug.