Skip to content

Troubleshooting

dpooley edited this page Sep 2, 2026 · 9 revisions

Troubleshooting

Setting names below 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. Turn it on for bars over players you are fighting, and add Always Show Player HP Bar for every visible player.

Names are separate: Other Player Bar — Info — Show Player Name is on by default and works with bars turned off.

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. Their Display Mode offers a percentage or no text at all.

An NPC shows a percentage instead of a number

Either that NPC has no max HP in the bundled table, or it is a ToA minion in a team. See Boss and mechanic support.

A boss's bar turned blue, or a second bar appeared underneath

Those are the shield and charge bars, both on by default. Blue means the bar is showing a shield rather than hitpoints; a second bar beneath means the boss is winding up a special attack, and its fill is the timer. Both have their own toggle and colour in NPC Bar — Info, and Shield and charge bars explains them per encounter.

The game's own health bar is still showing

Behavior — Hide Native Health Bar is on by default and covers hitpoint bars only. Bars tracking a mechanic rather than hitpoints keep their native sprites, except while this plugin draws a replacement for them - which is what lets you turn Show Shield Bar or Show Charge Bar off and get the game's version back.

Two hitpoint bars on the same actor means the setting is off.

Bars disappear a few seconds after a fight

That is Persist Duration (seconds), 5 by default, set separately in NPC Bar — Info and Player Bar — Info. Set it to 0 to hide bars immediately, or raise it to keep them longer.

To ignore combat entirely, use Always Show NPC Bar, Always Show HP Bar (self), or Always Show Player HP Bar (other players).

An NPC's bar or name is grey

That is the Ironman shared-loot warning: another player has damaged the NPC, so its loot is not yours. It runs on Ironman accounts only, and bosses with shared or personal loot are exempt.

Two independent toggles in NPC Bar — Info control it, both on by default: Grey Out Health Bars and Grey Out Names. The grey overrides the aggressive name colour.

All names or all bars vanished at once

Check Hotkeys. Toggle Names, Toggle HP Bars and Toggle Weakness Icons flip visibility instantly without changing any setting. Press the same key again to bring them back; they also reset to visible when the plugin restarts.

Toggle HP Bars takes the charge bar with it. It leaves the aggressive-NPC icon alone.

Bars overlap, stagger, or vanish on a shared tile

Actors on the same tile have their bars and names stacked vertically instead of drawn on top of each other. Two settings shape that:

  • Behavior — Prioritize Self on Same Tile (on by default) hides an NPC's or player's bar and name when they stand on your tile, rather than stacking with yours.
  • NPC Stack Limit and Player Stack Limit cap how many actors render per tile. 0 is unlimited.

Stacking only covers actors on literally the same tile - see Known limitations.

No weakness icon on an NPC

NPC Bar — Info — Show Weakness Icon is off by default. With it on, nothing is drawn for an NPC with no known elemental weakness, which is most of them.

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. See Overhead replacement.

Hitsplats or chat text look slightly different

They are redrawn by the plugin rather than the client, because hiding a player's health bar hides their whole overhead bundle. The redraws use the game's own sprites, fonts, four-splat diamond and chat position. Turning off Show for Self hands your own overheads back to the client.

Chat text keeps the position the game gives it, so Vertical Offset changes the gap between your bar and your chat text without moving the text.

The bar drifts up and down during attack animations

Bars anchor to the actor's model height, which some animations change, so the bar and everything grouped with it moves for the duration.

Nothing above helped

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

Clone this wiki locally