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 (e.g. 1.5; the per-kit variants below format to two decimals). |
%shyamduels_wins% | Integer | Total ranked match victories. |
%shyamduels_losses% | Integer | Total ranked match defeats. |
%shyamduels_wl% | Decimal | Wins divided by losses (e.g. 1.5). |
%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_playtime% | String | Formatted total playtime (e.g. 3h 24m). |
%shyamduels_playtime_hours% | Integer | Total playtime rounded down to whole hours. |
%shyamduels_rank% | String | Displays the rank display name, or Unranked. |
%shyamduels_rank_colored% / %shyamduels_rank_color% | MiniMessage Format | Displays the colored rank name (e.g., <gold>[Gold V]</gold>). Returns <gray>[Unranked]</gray> if no rank applies. |
Additional Rank & Opponent Placeholders
Extra ELO/rank and in-duel opponent placeholders handled by the expansion:
| Placeholder Variable |
Output Format |
Description |
%shyamduels_ping% / %shyamduels_self_ping% | Integer | Viewer's ping (ms). |
%shyamduels_opponent_ping% | Integer | Opponent's ping (ms) during a duel. |
%shyamduels_rank_id% | String | Rank identifier key. |
%shyamduels_rank_min_elo% / %shyamduels_rank_max_elo% | Integer | ELO boundaries of the player's rank. |
%shyamduels_next_rank% | String | Next rank display name, or empty at the top tier. |
%shyamduels_next_rank_color% / %shyamduels_next_rank_colored% | MiniMessage | Next rank colored name. |
%shyamduels_next_rank_elo% | Integer | ELO required to reach the next rank. |
%shyamduels_elo_needed% / %shyamduels_elo_left% / %shyamduels_elo_to_next% | Integer | ELO remaining until the next rank. |
%shyamduels_elo_percent% / %shyamduels_elo_percentage% / %shyamduels_elo_progress% | String | Progress to the next rank as a percentage (e.g. 75.0%). |
%shyamduels_elo_bar% / %shyamduels_elo_progressbar% | String | Colored progress bar to the next rank. |
%shyamduels_opponent_elo% | Integer | Opponent's ELO during a duel. |
%shyamduels_opponent_rank% | String | Opponent's rank display name during a duel. |
%shyamduels_opponent_rank_color% / %shyamduels_opponent_rank_colored% | MiniMessage | Opponent's colored rank name during a duel. |
The rank/ELO metrics above (rank, rank_color, rank_colored, rank_id, rank_min_elo, rank_max_elo, next_rank*, elo_needed/elo_left/elo_to_next, elo_percent/elo_percentage/elo_progress, elo_bar/elo_progressbar) are also available as per-kit metrics via %shyamduels_<kit>_<metric>%.
Per-Kit Statistics Placeholders
The plugin exposes statistics filtered for specific kit categories. Use the format %shyamduels_<kit>_<metric>% where <kit> is the lowercase internal kit ID (e.g., nodebuff, boxing, or a custom kit identifier) and <metric> is one of the following:
| Kit Metric |
Output Format |
Description |
Example |
wins | Integer | Ranked victories with this kit. | %shyamduels_nodebuff_wins% |
losses | Integer | Ranked defeats with this kit. | %shyamduels_boxing_losses% |
games | Integer | Total matches played with this kit. | %shyamduels_gapple_games% |
kills | Integer | Total kills recorded using this kit. | %shyamduels_nodebuff_kills% |
deaths | Integer | Total deaths recorded using this kit. | %shyamduels_boxing_deaths% |
kd | Decimal | Kills/Deaths ratio with this kit. | %shyamduels_nodebuff_kd% |
wl | Decimal | Wins/Losses ratio with this kit. | %shyamduels_boxing_wl% |
winrate | Decimal | Win rate percentage with this kit. | %shyamduels_boxing_winrate% |
elo | Integer | Elo matchmaking rating for this specific kit. | %shyamduels_nodebuff_elo% |
killstreak | Integer | Current active killstreak with this kit. | %shyamduels_nodebuff_killstreak% |
best_killstreak | Integer | All-time highest killstreak with this kit. | %shyamduels_boxing_best_killstreak% |
winstreak | Integer | Current active winstreak with this kit. | %shyamduels_nodebuff_winstreak% |
best_winstreak | Integer | All-time highest winstreak with this kit. | %shyamduels_boxing_best_winstreak% |
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 (appends (+N) when multi-queued). |
%shyamduels_queue_mode% | String | Displays the active queue team-size mode (e.g. 1v1, 2v2). |
%shyamduels_wait_time% / %shyamduels_queue_wait_time% | String | Formatted duration elapsed in queue (e.g., 1: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 MiniMessage-colored status settings (e.g., <green>On</green> or <red>Off</red>):
| 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 party visibility mode: Public, Friends Only, or Private. |
%shyamduels_party_play_mode% | String | Returns the party play mode label: Queue, Party Split, Party FFA, or Party 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). |
<opponent_elo> | Integer | Opponent ELO during a duel (0 if none). |
<opponent_rank> | String | Opponent rank display name during a duel, or Unranked. |
<opponent_rank_color> / <opponent_rank_colored> | MiniMessage | Opponent's colored rank name during a duel. |
<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 team-size mode (e.g. 1v1, 2v2). |
<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 | Party visibility mode: Public, Friends Only, or Private. |
<party_play_mode> | String | Party play mode label: Queue, Party Split, Party FFA, or Party 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. |
<wl> | Decimal | W/L ratio. |
<killstreak> | Integer | Current killstreak. |
<best_killstreak> | Integer | All-time best killstreak. |
<winstreak> | Integer | Current winstreak. |
<best_winstreak> | Integer | All-time best winstreak. |
<playtime> | String | Formatted playtime (e.g. 3h 24m). |
<playtime_hours> | Integer | Total playtime in whole hours. |
<elo> | Integer | Current ELO rating. |
<rank> | String | Rank display name, or Unranked. |
<rank_color> / <rank_colored> | MiniMessage | Colored rank name (e.g. <gold>[Gold V]</gold>), or <gray>[Unranked]</gray>. |
<rank_id> | String | Rank identifier key, or unranked. |
<rank_min_elo> / <rank_max_elo> | Integer | ELO boundaries of the player's rank. |
<next_rank> | String | Next rank display name, or MAX at the top tier. |
<next_rank_color> / <next_rank_colored> | MiniMessage | Next rank colored name, or <gold>MAX</gold>. |
<next_rank_elo> | Integer | ELO required to reach the next rank, or MAX. |
<elo_needed> / <elo_left> / <elo_to_next> | Integer | ELO remaining until the next rank. |
<elo_percent> / <elo_percentage> / <elo_progress> | String | Progress to the next rank as a percentage (e.g. 75.0%). |
<elo_bar> / <elo_progressbar> | String | Colored progress bar to the next rank. |
Server and Settings
| Token | Output | Description |
|---|
<players> | Integer | Online player count. |
<max_players> | Integer | Server max players. |
<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 |
%shyamduels_display_mode% | String | Lobby tab display mode (Lobby or Friends). Not a PlaceholderAPI placeholder: resolved as a literal token only inside tab/display.yml footer rendering. Use %shyamduels_tab_view% / %shyamduels_setting_tab_view% for a real PAPI placeholder. |
%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>). |
Tournament Placeholders
Variables for tournament statuses, active rounds, participants, and viewers:
| Placeholder Variable |
Returns |
Description |
%shyamduels_tournament_status% | String | Current tournament state (e.g. Waiting, In Progress, Disabled). |
%shyamduels_tournament_kit% | String | Kit chosen for the tournament. |
%shyamduels_tournament_players% | Integer | Current joined participant count. |
%shyamduels_tournament_max_players% | Integer | Maximum allowed participants. |
%shyamduels_tournament_min_players% | Integer | Minimum required participants. |
%shyamduels_tournament_current_round% | Integer | Current active round index. |
%shyamduels_tournament_total_rounds% | Integer | Total expected bracket rounds. |
%shyamduels_tournament_remaining_players% | Integer | Count of non-eliminated remaining players. |
%shyamduels_tournament_champion% | String | Name of the crowned champion. |
%shyamduels_tournament_next_auto% | String | Time remaining until next automated tournament run. |
%shyamduels_tournament_player_status% | String | Viewer's tournament status (Alive, Fighting, Eliminated). |
%shyamduels_tournament_player_wins% | Integer | Matches won by the viewer in the current tournament. |
%shyamduels_tournament_player_losses% | Integer | Matches lost by the viewer. |
%shyamduels_tournament_player_round% | Integer | Rounds survived by the viewer. |
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. |