Player Overlays

Per-player overlays for names, factions, subfactions, scores, and secondary objective cards in gd streamer.

Last updated: 2026-03-23

Player overlays#

Player overlays display information for a single player. There are 8 overlay types per player (16 total), each with its own URL. Use them to build modular, flexible layouts in OBS.

All player overlays use the player's assigned color for accents and borders.

Name overlays#

OverlayURL path
Player 1 name/overlay/{id}/player1-name
Player 2 name/overlay/{id}/player2-name

Displays the player's name in a compact badge with their assigned color. Use these for lower-thirds, player camera labels, or any layout where you want to identify who is who.

URL parameters

ParameterValuesDefaultDescription
nostyle1offStrip the background and styling, rendering plain text only
alignleft, center, rightleftText alignment
position0--Center the overlay horizontally
Tip
Use nostyle=1 when you want to composite the raw player name over your own custom graphics in OBS, without the gd streamer background styling.

Faction overlays#

OverlayURL path
Player 1 faction/overlay/{id}/player1-faction
Player 2 faction/overlay/{id}/player2-faction

Shows the player's faction name (e.g., Space Marines, Death Guard, Orks). Useful alongside the name overlay to give viewers context about each player's army.

URL parameters

ParameterValuesDefaultDescription
nostyle1offStrip the background and styling, rendering plain text only
alignleft, center, rightleftText alignment
position0--Center the overlay horizontally

Subfaction overlays#

OverlayURL path
Player 1 subfaction/overlay/{id}/player1-subfaction
Player 2 subfaction/overlay/{id}/player2-subfaction

Displays the subfaction or detachment name (e.g., Ultramarines, Hive Fleet Leviathan). If no subfaction is set, this overlay renders nothing -- it stays transparent and invisible on stream.

URL parameters

ParameterValuesDefaultDescription
nostyle1offStrip the background and styling, rendering plain text only
alignleft, center, rightleftText alignment
position0--Center the overlay horizontally

Total score overlays#

OverlayURL path
Player 1 total score/overlay/{id}/player1-total-score
Player 2 total score/overlay/{id}/player2-total-score

A large, prominent score display showing the player's cumulative VP total. The score is capped at 100 VP. The player's color provides the visual accent.

These work well as standalone score badges near each player's camera feed.

URL parameters

ParameterValuesDefaultDescription
nostyle1offStrip the background and styling, rendering the score number as plain text
alignleft, center, rightleftText alignment
position0--Center the overlay horizontally

Individual secondary card overlays#

OverlayURL path
Player 1 secondary 1/overlay/{id}/player1-secondary1
Player 1 secondary 2/overlay/{id}/player1-secondary2
Player 2 secondary 1/overlay/{id}/player2-secondary1
Player 2 secondary 2/overlay/{id}/player2-secondary2

Each overlay displays the card image for a single secondary objective. When the player changes their active secondary (in Tactical mode), the card image updates automatically.

URL parameters

ParameterValuesDefaultDescription
position0--Center the overlay horizontally
Tip
Place these near the player's camera view so viewers can see which secondaries are in play without cluttering the main scoreboard area.

Combined secondary viewer overlays#

OverlayURL path
Player 1 secondaries/overlay/{id}/player-1-secondary-viewer
Player 2 secondaries/overlay/{id}/player-2-secondary-viewer

Shows both of a player's active secondary cards side by side in a single overlay. This is a convenient alternative to adding two separate secondary card overlays when you want to display the full secondary setup in one browser source.

URL parameters

ParameterValuesDefaultDescription
position1centeredSet to 1 to move to the default left-aligned position

Secondary name overlays#

OverlayURL path
Player 1 secondary 1 name/overlay/{id}/p1-secondary-1-name
Player 1 secondary 2 name/overlay/{id}/p1-secondary-2-name
Player 2 secondary 1 name/overlay/{id}/p2-secondary-1-name
Player 2 secondary 2 name/overlay/{id}/p2-secondary-2-name

Displays the name of a single active secondary objective as text. Useful for custom layouts where you want to show which secondary is in play without the full card image.

URL parameters

ParameterValuesDefaultDescription
nostyle1offStrip the background and styling, rendering plain text only
alignleft, center, rightleftText alignment
position0--Center the overlay horizontally

What's next?#

See the Score Displays for overlays that combine both players' data into a single scoreboard or banner.