Squad HUD

Floating Squad HUD

Replaces individual minion token health bars with a single shared health bar that floats near the squad, giving Directors and players a clear at-a-glance view of the squad's collective stamina.

How It Works

When the Floating Squad HUD is enabled, each active minion squad in combat gains a floating panel positioned between its members. The panel shows:

• The squad's group name, colored to match its squad label
• A segmented health bar — one segment per minion — that fills and drains as the squad takes damage
• The current and maximum stamina pool (e.g. 8 / 12)

Individual minion token health bars are hidden while the HUD is active. The HUD is always visible to Directors regardless of player visibility settings.

Visual coming soon

Hover Lines

Hovering over any minion token or over the HUD panel itself fades in colored link lines connecting the panel to each squad member. The lines use the squad's label color for quick identification.

Lines are also shown while any squad member is selected or targeted, so it's always clear which tokens belong to which squad during combat.

Lines are only drawn to tokens that are visible to the current user — hidden, invisible, or out-of-sight tokens are excluded.

Dragging and Locking

The HUD panel can be dragged to any position on the canvas. Once moved, a padlock icon appears in the corner. The panel stays locked until the lock icon is clicked, at which point it glides smoothly back to its default position between the squad members.

Locked positions persist across page reloads — the panel will return to exactly where the Director left it even after a refresh.

HP Editor

Directors can edit the squad's stamina pool directly from the HUD without opening the combat tracker. Double-click or right-click the bar panel to open a small input field.

Enter an absolute value (8) or a signed delta (+2, -3) and press Enter. The bar animates to the new value.

Bar Animation

The health bar animates smoothly when stamina changes, draining from right to left using the same easing curve as Foundry's native token bars. Small changes animate slower so they remain readable; large changes animate faster.

If DS: Token Override is installed, tick mark segments match the per-minion divisions that module draws on native bars.

Player Visibility

Directors can control how much of the HUD players see. This is configured in the Squad Labels settings.

Players always see the full HUD for squads they own or that are Friendly disposition, regardless of this setting.

Setting	What Players See
Full	Bar and HP numbers
Bar only	Bar only — HP numbers hidden
Hidden	HUD hidden entirely; individual token bars restored

Settings

Found in the Squad Labels settings panel.

Setting	What It Does
Floating Squad HUD	Enable or disable the feature
Squad HUD Player Visibility	Controls what non-Director players can see

Notes

• The HUD positions itself between all squad members and displaces upward automatically to avoid overlapping any token.
• The HUD only appears during active combat. Outside of combat, individual token bars are restored.
• If a minion is removed from the squad or combat ends, individual token bars are restored immediately without needing a reload.
• Stamina floaters (the numbers that pop up when damage is dealt) are consolidated into a single float near the HUD rather than appearing on each individual token.