-
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, so there is nothing to turn into a number. Their Display Mode offers percentage or no text at all, and nothing else.
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 where this plugin draws a replacement for them - that is deliberate, so no mechanic bar silently disappears.
If you see two hitpoint bars, the setting is off.
That is Persist Duration (seconds), 5 by default, in NPC Bar — Info and Player Bar — Info separately. Set it to 0 to hide bars the instant combat tracking ends, or raise it to keep the last known HP on screen longer.
To keep bars up regardless of combat, 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 applies on Ironman accounts, and bosses with shared or personal loot are exempt.
Two independent toggles in NPC Bar — Info control it: Grey Out Health Bars and Grey Out Names, both on by default.
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; the toggles also reset to visible when the plugin restarts.
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.
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.
NPC Bar — Info — Show Weakness Icon is off by default. With it on, nothing is drawn for an NPC that has no known elemental weakness, which is most of them.
Either that NPC id has no known max HP, or it is a ToA minion in a team, where the number would be a guess. See Boss and mechanic support.
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.