PlaceholderAPI Placeholders

All PlaceholderAPI variables registered under the %shyamduels_% identifier, plus <tag> scoreboard/tab tokens (such as <ffa_players>) used in tab/scoreboard.yml.

Player Statistics Placeholders

Placeholder Variable	Output Format	Description
`%shyamduels_kills%`	Integer	Total kills recorded.
`%shyamduels_deaths%`	Integer	Total deaths recorded.
`%shyamduels_kd%` / `%shyamduels_kdr%`	Decimal	Kills divided by deaths, formatted to two decimal slots.
`%shyamduels_wins%`	Integer	Total ranked match victories.
`%shyamduels_losses%`	Integer	Total ranked match defeats.
`%shyamduels_wl%`	Decimal	Wins divided by losses, formatted to two decimal slots.
`%shyamduels_killstreak%`	Integer	Current consecutive kills (resets on death).
`%shyamduels_best_killstreak%`	Integer	All-time highest consecutive kill record.
`%shyamduels_winstreak%`	Integer	Current consecutive matchmaking victories.
`%shyamduels_best_winstreak%`	Integer	All-time highest consecutive matchmaking win record.
`%shyamduels_elo%`	Integer	Current matchmaking rating.
`%shyamduels_rank%` / `%shyamduels_rank_colored%` / `%shyamduels_rank_color%`	MiniMessage Format	Displays rank name formatting (e.g., `<gold>[Gold V]</gold>`). Returns `<gray>[Unranked]</gray>` if no rank applies.

Active Match States

Placeholder Variable	Output Format	Description
`%shyamduels_in_duel%`	boolean	Returns true if the player is currently inside a duel.
`%shyamduels_in_fight%`	boolean	Returns true if the player is inside an active fight.
`%shyamduels_kit%`	String	Displays the active kit display name for the current match.
`%shyamduels_opponent%`	String	Displays the opponent player's name, or "None".

Queue and Matchmaking Placeholders

Placeholder Variable	Output Format	Description
`%shyamduels_in_queue%`	boolean	Returns true if the player is in queue.
`%shyamduels_queue_kit%`	String	Displays the display name of the queued kit.
`%shyamduels_queue_mode%`	String	Displays the active queue matchmaking mode (e.g. Ranked).
`%shyamduels_wait_time%` / `%shyamduels_queue_wait_time%`	String	Formatted duration elapsed in queue (e.g., `01:24`).
`%shyamduels_queue_count%`	Integer	Number of kits the player is currently queued for (multi-queue).
`%shyamduels_queue_players%`	Integer	Total players currently queued inside your active kit queue.
`%shyamduels_queue_playing%`	Integer	Total players currently in active matches inside your active kit queue.
`%shyamduels_players%`	Integer	Total online players on the server.
`%shyamduels_queue_elapsed%`	Integer	Seconds the player has been in queue.
`%shyamduels_queue_kits%`	String	Comma-separated list of kits the player is queued for.
`%shyamduels_is_queued%`	boolean	Alias for whether the player is queued.

Player Preference Toggles

Returns status settings (e.g., ON or OFF):

Placeholder Variable	Returns	Preference Monitored
`%shyamduels_setting_scoreboard%`	ON / OFF	Sidebar scoreboard state.
`%shyamduels_setting_tab%`	ON / OFF	Custom list tabs formatting state.
`%shyamduels_setting_nametags%`	ON / OFF	Nametag state.
`%shyamduels_setting_actionbar%`	ON / OFF	Queue time action bar state.
`%shyamduels_setting_friends%`	ON / OFF	Friend request receipt state.
`%shyamduels_tab_view%` / `%shyamduels_setting_tab_view%`	Lobby / Friends	Active lobby tab list page setting.

Party Status Placeholders

Placeholder Variable	Returns	Description
`%shyamduels_in_party%`	boolean	Returns true if the player is inside a party.
`%shyamduels_party_members%`	Integer	Current count of online party members.
`%shyamduels_party_mode%`	String	Returns the active party mode (e.g., FFA).
`%shyamduels_party_play_mode%`	String	Returns the party play mode (Queue, Split, FFA, or Vs Party).
`%shyamduels_party_chat%`	ON / OFF	Returns whether party chat is active for the player.

Practice Placeholders

Registered by the practice module under the same shyamduels identifier:

Placeholder Variable	Returns	Description
`%shyamduels_autogg%`	Enabled / Disabled	Whether the player has auto-GG enabled.
`%shyamduels_deathmessages%`	Enabled / Disabled	Whether custom death messages are enabled for the player.

Scoreboard and Tab Tokens

These tokens use <tag> syntax in tab/scoreboard.yml and tab list lines. ShyamDuels resolves them when rendering scoreboards and tab lists; PlaceholderAPI placeholders on the same line are processed afterward. Many tags mirror the %shyamduels_*% variables above.

Example from tab/scoreboard.yml:

yaml- '  <gray>Players:</gray> <white><ffa_players>[display=<is_ffa>]</white>'

The [display=<condition>] suffix hides the whole line when the condition is false (see Config Tokens below).

Match and Activity State

Token	Output	Description
`<is_ffa>`	boolean	True when the player is in an FFA arena.
`<is_in_fight>` / `<in_fight>`	boolean	True during a duel or FFA match.
`<is_editing_kit>`	boolean	True while the player is in kit editor.
`<is_in_party>`	boolean	True when the player is in a party.
`<is_queued>`	boolean	True when the player is waiting in queue.
`<in_queue>`	Integer	Players waiting in the viewer's active kit queue (0 if not queued).

FFA

Token	Output	Description
`<ffa_players>`	Integer	Players currently in the same FFA arena as the viewer.
`<ffa_rollback>`	N/A	Reserved legacy tag.
`<kit>`	String	Active kit display name (duel, FFA, or queue context).

Duel and Round Info

Token	Output	Description
`<self>`	String	Viewer's username.
`<self_ping>`	Integer	Viewer's ping (ms).
`<opponent>`	String	Opponent name, or `None`.
`<opponent_ping>`	Integer	Opponent ping during a duel (0 if none).
`<round>`	Integer	Current round number in a multi-round duel.
`<max_rounds>` / `<total_rounds>`	Integer	Maximum rounds configured for the duel.
`<own_wins>`	Integer	Viewer's round wins in the current duel.
`<opponent_wins>`	Integer	Opponent's round wins in the current duel.
`<duration>`	String	Elapsed match time (e.g. `01:24`).
`<hits>` / `<hits_opponent>`	0	Legacy compatibility tags.

Queue

Token	Output	Description
`<queue_kit>`	String	Display name of the primary queued kit.
`<queue_primary_kit>`	String	Same as `<queue_kit>`.
`<queue_mode>`	String	Active queue mode (e.g. Ranked).
`<queue_count>`	Integer	Number of kits the player is queued for (multi-queue).
`<queue_extra>`	Integer	Extra queued kits beyond the primary (`queue_count - 1`).
`<queue_kits>`	String	Comma-separated list of queued kit names.
`<queue_players>`	Integer	Players waiting in the viewer's active kit queue.
`<queue_playing>`	Integer	Players in active matches for the viewer's queued kit.
`<queue_elapsed>`	Integer	Seconds spent in queue.
`<wait_time>`	String	Formatted queue wait time (e.g. `1:24`).

Party and Teams

Token	Output	Description
`<party_owner>`	String	Party leader name.
`<party_members>`	Integer	Online party member count.
`<party_mode>`	String	Active party mode (e.g. FFA).
`<party_play_mode>`	String	Party play mode (Queue, Split, FFA, Vs Party).
`<party_chat>`	ON / OFF	Whether party chat is enabled for the viewer.
`<enemy_team_owner>`	String	Enemy team leader in party vs party.
`<own_team_left>`	Integer	Alive players on the viewer's team.
`<own_team_members>`	Integer	Total players on the viewer's team.
`<enemy_team_left>`	Integer	Alive players on the enemy team.
`<enemy_team_members>`	Integer	Total players on the enemy team.

Player Stats

Token	Output	Description
`<kills>`	Integer	Total kills.
`<deaths>`	Integer	Total deaths.
`<kd>` / `<kdr>`	Decimal	K/D ratio.
`<wins>`	Integer	Ranked wins.
`<losses>`	Integer	Ranked losses.
`<elo>`	Integer	Current ELO rating.
`<rank>`	String	Rank display name, or `Unranked`.
`<rank_colored>`	MiniMessage	Colored rank name with formatting codes.

Server and Settings

Token	Output	Description
`<players>`	Integer	Online player count.
`<max_players>`	Integer	Server max players.
`<online_staff>`	Integer	Online staff count.
`<free_arenas>`	Integer	Available duel arenas.
`<arenas>`	Integer	Total registered arenas.
`<ping>`	Integer	Viewer ping (ms).
`<setting_tab>`	ON / OFF	Custom tab list toggle.
`<setting_nametags>`	ON / OFF	Nametag toggle.
`<setting_scoreboard>`	ON / OFF	Scoreboard toggle.
`<setting_actionbar>`	ON / OFF	Queue action bar toggle.
`<setting_friends>`	ON / OFF	Friend request toggle.
`<setting_tab_view>`	Lobby / Friends	Active lobby tab page preference.

Player Head Components

Token / Placeholder	Output	Description
`%shyamduels_head_self%`	`<head:self>`	Player head component for scoreboards/tab.
`%shyamduels_head_enemy%`	`<head:enemy>`	Opponent head component during duels.

Tab Config Tokens

Additional tokens used only in ShyamDuels tab/scoreboard configs:

Token	Output	Description
`%shyamtab_display_mode%`	String	Current lobby tab display mode (Lobby or Friends). Shown in `tab/display.yml` footers.
`%animation:<name>%`	String	Scrolling animation frame from `tab/animations.yml`. Resolved before PlaceholderAPI.
`[display=true]` / `[display=false]`	Conditional	Hide or show a tab/scoreboard line based on a boolean condition (often another `<tag>`).

Relational Placeholders

Relational placeholders are evaluated relative to two players. The identifier is prefixed by %rel_shyamduels_%:

Placeholder Variable	Returns	Description
`%rel_shyamduels_relation%`	Color Codes	Returns relationship color coding (e.g. green for teammates, red for enemies). Used for nametags.
`%rel_shyamduels_team%`	Color Codes	Evaluates matches and assigns relationship color highlights.