# PlaceholderAPI

{% 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. |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://andrei1058.gitbook.io/stevesus/hooks/placeholderapi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.