> For the complete documentation index, see [llms.txt](https://docs.criticalred.com/chatgames/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.criticalred.com/chatgames/placeholders.md).

# Placeholders

PlaceholderAPI support & Internal Placeholders

## PlaceholderAPI (PAPI)

There are some placeholders that are supported through the external plugin PlaceholderAPI. These placeholders can be used with any other plugin that also supports PAPI in order to display information from ChatGames. You will find these placeholders below.

| Placeholder                                   | Description                                                                                                                                                                                                                                                      |
| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| %chatgames\_\<gameType>\_score%               | Returns the player's \<gameType> score with gameType being either **reaction\|unscramble\|trivia\|math**                                                                                                                                                         |
| %chatgames\_total\_games\_won%                | Returns how many games the player has won in total                                                                                                                                                                                                               |
| %chatgames\_total\_games%                     | Return how many games have run since the config.yml file was generated                                                                                                                                                                                           |
| %chatgames\_\<gameType>\_player\_\<position>% | Return the player name of the player that is at \<position> in the \<gameType> hiscores. GameType is either **reaction\|unscramble\|trivia\|math\|total** and the position is any ranking position. If no player is at that position then it will return "N/A".  |
| %chatgames\_\<gameType>\_score\_\<position>%  | Return the player score of the player that is at \<position> in the \<gameType> hiscores. GameType is either **reaction\|unscramble\|trivia\|math\|total** and the position is any ranking position. If no player is at that position then it will return "N/A". |

## Internal Placeholders

These are placeholders that you are able to use through the messages.yml file and the config.yml file. They are useful when executing commands or broadcasting game messages.

| Placeholder | Description                                   |
| ----------- | --------------------------------------------- |
| %player%    | Returns the player name of the winning player |
| %question%  | Returns the question of the most recent game  |
| %answer%    | Returns the answer of the most recent game    |