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

# PlaceholderAPI

Additional placeholders that you can use in other plugins.

{% hint style="info" %}
You can use someone else's placeholders provided by PlaceholdersAPI almos everywhere in SteveSus and SteveSus-Connector.
{% endhint %}

### Common Placeholders

{% hint style="success" %}
Common placeholders are provided both by the mini-game plugin and proxy-connector plugin.
{% endhint %}

| Placeholder                             | Description                                                                                                                                                                |
| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| %stevesus\_global\_player\_count%       | Fetch players number (in-game) from all arenas.                                                                                                                            |
| %stevesus\_global\_spectator\_count%    | Fetch spectators number from all arenas.                                                                                                                                   |
| %stevesus\_global\_user\_count%         | Fetch total players and spectators number from all arenas.                                                                                                                 |
| %stevesus\_global\_arena\_count%        | Fetch amount of active games.                                                                                                                                              |
| %stevesus\_game\_count\_template\_NAME% | Fetch amount of active games from the given template. NAME must be replaced with a template name.                                                                          |
| %stevesus\_game\_player\_count\_TAG%    | Fetch amount of players from the given arena. TAG must be replaced with a game identifier. Usually numbers. On connector-side tag is composed by server:id.                |
| %stevesus\_game\_spectator\_count\_TAG% | Fetch amount of spectators from the given arena. TAG must be replaced with a game identifier. Usually numbers. On connector-side tag is composed by server:id.             |
| %stevesus\_game\_user\_count\_TAG%      | Fetch amount of players and spectators from the given arena. TAG must be replaced with a game identifier. Usually numbers. On connector-side tag is composed by server:id. |
| %stevesus\_game\_state\_TAG%            | Fetch game state in requester's language. TAG must be replaced with a game identifier. Usually numbers. On connector-side tag is composed by server:id.                    |
| %stevesus\_stats\_first\_play%          | Get first play date. Formatted using requester's language.                                                                                                                 |
| %stevesus\_stats\_last\_play%           | Get  last play date. Formatted using requester's language.                                                                                                                 |
| %stevesus\_stats\_games\_played%        | Get games played.                                                                                                                                                          |
| %stevesus\_stats\_games\_won%           | Games won.                                                                                                                                                                 |
| %stevesus\_stats\_games\_lost%          | Games lost.                                                                                                                                                                |
| %stevesus\_stats\_games\_abandoned%     | Games abandoned. Useful for a hall of shame.                                                                                                                               |
| %stevesus\_stats\_kills%                | Kills made as an impostor.                                                                                                                                                 |
| %stevesus\_stats\_sabotages%            | Sabotages made as an impostor.                                                                                                                                             |
| %stevesus\_stats\_sabotages\_fixed%     | Amount of fixed sabotages.                                                                                                                                                 |
| %stevesus\_stats\_tasks%                | Tasks done.                                                                                                                                                                |

### MiniGame-Side Placeholders

{% hint style="info" %}
These placeholders can be used only on a mini-game server.
{% endhint %}

| Placeholder                                 | Description                                                |
| ------------------------------------------- | ---------------------------------------------------------- |
| %stevesus\_game\_user\_count\_current%      | Get amount of players and spectators on current game.      |
| %stevesus\_game\_player\_count\_current%    | Get amount of players on current game.                     |
| %stevesus\_game\_spectator\_count\_current% | Get amount of spectators on current game.                  |
| %stevesus\_game\_state\_current%            | Get current game state translated in requester's language. |
| %stevesus\_game\_is\_spectator%             | Returns true/ false if requesters is spectating.           |
| %stevesus\_game\_is\_player%                | Returns true/ false if requesters is playing.              |
| %stevesus\_game\_kills%                     | Player kills in current game.                              |
| %stevesus\_game\_sabotages%                 | How many sabotages a player activated in current game.     |
| %stevesus\_game\_sabotages\_fixed%          | How many sabotages a player fixed in current game.         |
| %stevesus\_game\_tasks%                     | Finished tasks in current game.                            |

### Connector-Side Placeholders

{% hint style="info" %}
These placeholders can be used with connector plugin only.
{% endhint %}

| Placeholder                         | Description                                                                                         |
| ----------------------------------- | --------------------------------------------------------------------------------------------------- |
| %stevesus\_game\_count\_node\_NAME% | Get amount of active games on the given node/ slave. NAME must be replaced with a slave identifier. |