-
Notifications
You must be signed in to change notification settings - Fork 0
Troubleshooting
Most reports turn out to be one of these. Setting names below are given as Section — Setting, matching the plugin's own settings panel.
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 even with bars turned off.
The game gives no max HP for another player - there is no message carrying it and no API to ask - so there is nothing to turn a ratio into a number with. Their Display Mode offers percentage or no text at all, and nothing else.
Either that NPC id has no known max HP, or it is a ToA minion in a team, where a number would be a guess. Boss and mechanic support explains both cases. A missing NPC is worth an issue: adding one is a single data row.
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 the fill is a timer for it. Full explanation, per encounter, on Shield and charge bars.
Both have their own toggle and colour in NPC Bar — Info.
Behavior — Hide Native Health Bar is on by default and covers hitpoint bars only. Bars that track a mechanic rather than hitpoints keep their native sprites, except for as long as this plugin draws a replacement for them. That is deliberate - it means turning off Show Shield Bar or Show Charge Bar gives you the game's version back rather than leaving you with no bar at all.
If you can see two hitpoint bars on the same actor, the setting is off.
That is Persist Duration (seconds), 5 by default, set separately in NPC Bar — Info and Player Bar — Info. It keeps the last known HP on screen after combat tracking ends. 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).
That is the Ironman shared-loot warning: another player has damaged the NPC, so the loot is not yours. It only runs on Ironman accounts, 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 also overrides the aggressive name colour, so a marked NPC stops looking aggressive once its loot is gone.
Check Hotkeys. Toggle Names, Toggle HP Bars and Toggle Weakness Icons each flip visibility instantly without changing any setting, so a stray keypress looks like a broken plugin. 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, since it is part of the same overlay. It leaves the aggressive-NPC icon alone on purpose.
Actors on the same tile get 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 entirely 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. Which ones survive the cap is arbitrary, not nearest-first.
Stacking only handles actors on literally the same tile. Bars from adjacent tiles can still overlap at low camera angles, and a bar visibly jumps the moment its tile starts or stops being shared - that is stacking engaging, not a glitch.
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.
Known limitation. Bars anchor to the actor's model height, and some attack animations change it, so the bar, name, icon and hitsplats all bob together for the duration.
Open an issue with the details in Reporting a bug.