> For the complete documentation index, see [llms.txt](https://edseries-plugins.gitbook.io/p/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://edseries-plugins.gitbook.io/p/pinnaduels/reference/placeholders.md).

# Placeholders

With PlaceholderAPI installed: `%pinnaduels_<key>%`. They only read memory, so they are safe for TAB's async refresh.

## Profile

`elo`, `peak`, `league`, `league_icon`, `league_glyph`, `position` (`-` while unranked), `wins`, `losses`, `draws`, `winrate`, `streak`, `placement` (`2/3`), `weekly_wins`

## Tokens

`tokens`, `tokens_max`, `next_token` (blocks left), `token_percent`

## Queue

`queued`, `queue_time`, `queue_size`, `matched` (true while a match is being accepted or prepared)

## Duel

`in_duel`, `spectating`, `duel_state` (the `state.*` text), `duel_type` (the `type.*` text), `opponent`, `opponent_elo`, `score`, `opponent_score`, `score_diff` (`format.diff-*`), `time_left`. Spectators see side A as `score` and `opponent` is `format.versus` ("A vs B").

Raw values for HUD plugins: `side_a_name`, `side_a_uuid`, `side_a_score`, `side_b_name`, `side_b_uuid`, `side_b_score` (side A = the first player, for duelists and spectators alike), `my_side` (`a` / `b` / `spectator`), `duel_phase` (`loading`, `countdown`, `running`, `results`, `closed`), `duel_seconds_left`, `duel_duration`, `duel_countdown`.

## Global

`season`, `season_left`, `active_duels`, `top_<n>_name`, `top_<n>_elo`, `top_<n>_league`, `top_<n>_icon`, `top_<n>_glyph`

## Glyph numbers (optional, for resource-pack menus)

Add `_glyphs` to any key (`elo_glyphs`, `position_glyphs`...) to write it with the characters of `title-glyphs.chars` in config.yml, e.g. font images of your resource pack. `_glyphs_center` also centres it on the menu title cursor and moves the cursor back, so the rest of the title keeps its place. Without `title-glyphs.chars` they return the plain value.

## Examples

TAB: a scoreboard with `display-condition: "%pinnaduels_queued%=true"` while queued, and one with `"%world%=pinnaduels"` in the arenas showing `%pinnaduels_score%` vs `%pinnaduels_opponent_score%` and `%pinnaduels_time_left%`.
