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

# Placeholders

With [PlaceholderAPI](https://modrinth.com/plugin/placeholderapi) installed, rnChatGames registers the `%rnchatgames_...%` placeholders automatically (no eCloud download needed). Use them in scoreboards, tab lists, holograms, other plugins and in rnChatGames' own texts.

<figure><img src="https://348500357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSlVHklG0EMAOmvfqcizu%2Fuploads%2Fk0bGmXpgEyDpRwguxdWt%2Fen-scoreboard.png?alt=media" alt="A scoreboard made with the placeholders"><figcaption><p>A scoreboard made with the placeholders</p></figcaption></figure>

## Next game

| Placeholder                         | Example                                              |                                                                    |
| ----------------------------------- | ---------------------------------------------------- | ------------------------------------------------------------------ |
| `%rnchatgames_next_game_formatted%` | `4m 07s`, `45s`, `now`, `waiting for players`, `off` | Countdown to the next automatic game, or what is happening instead |
| `%rnchatgames_next_game%`           | `247`                                                | Seconds until the next game (`-` when none)                        |
| `%rnchatgames_next_game_minutes%`   | `4`                                                  | Minutes part of the countdown                                      |
| `%rnchatgames_next_game_seconds%`   | `07`                                                 | Seconds part of the countdown                                      |

The texts of `_formatted` are in the language file → `next-game`. Without PlaceholderAPI, players can use `/rncg next`.

## Running game

| Placeholder                  |                            |
| ---------------------------- | -------------------------- |
| `%rnchatgames_active%`       | `true` / `false`           |
| `%rnchatgames_active_game%`  | Name of the game running   |
| `%rnchatgames_time_left%`    | Seconds left               |
| `%rnchatgames_games_played%` | Games played on the server |

## Player who sees it

| Placeholder                 |                                                  |
| --------------------------- | ------------------------------------------------ |
| `%rnchatgames_points%`      | Points                                           |
| `%rnchatgames_wins%`        | Total wins                                       |
| `%rnchatgames_rank%`        | Position in the points ranking                   |
| `%rnchatgames_streak%`      | Current win streak                               |
| `%rnchatgames_best_streak%` | Best win streak                                  |
| `%rnchatgames_fastest%`     | Fastest win                                      |
| `%rnchatgames_wins_<game>%` | Wins of one game, e.g. `%rnchatgames_wins_math%` |
| `%rnchatgames_best_<game>%` | Best time in one game                            |

## Rankings and records

| Placeholder                                 |                                                                          |
| ------------------------------------------- | ------------------------------------------------------------------------ |
| `%rnchatgames_top_<position>_name%`         | Name in the points ranking, e.g. `%rnchatgames_top_1_name%`              |
| `%rnchatgames_top_<position>_value%`        | Points of that position                                                  |
| `%rnchatgames_top_<game>_<position>_name%`  | Name in the wins ranking of a game, e.g. `%rnchatgames_top_math_1_name%` |
| `%rnchatgames_top_<game>_<position>_value%` | Wins of that position                                                    |
| `%rnchatgames_record_<game>_name%`          | Who has the fastest win of a game                                        |
| `%rnchatgames_record_<game>_time%`          | That time                                                                |

Empty values show `placeholder-none` from the language file (`-` by default).