# Placeholders

URL: https://greenarrowlol.github.io/TNTGamesCore/docs/reference/placeholders/
Section: reference
Description: Every PlaceholderAPI placeholder the plugin exposes.

---

> For a complete page index, fetch https://greenarrowlol.github.io/TNTGamesCore/llms.txt.

Every placeholder the plugin exposes through PlaceholderAPI.

These need [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) installed. Once it is, any plugin that supports placeholders (scoreboards, holograms, tab lists) can use them. The identifier is `tntgames`, so every placeholder starts with `%tntgames_`.

## Player stats

These read the stats of the player the placeholder is shown to.

| Placeholder | Returns |
| --- | --- |
| `%tntgames_kills%` | Total kills. |
| `%tntgames_deaths%` | Total deaths. |
| `%tntgames_wins%` | Total wins. |
| `%tntgames_losses%` | Total losses. |
| `%tntgames_games_played%` | Games played. |
| `%tntgames_win_streak%` | Current win streak. |
| `%tntgames_kdr%` | Kill/death ratio, two decimals. |
| `%tntgames_wlr%` | Win/loss ratio, two decimals. |

## Leaderboards

Replace `N` with a position (1, 2, 3, and so on). Each returns the player name at that rank.

| Placeholder | Returns |
| --- | --- |
| `%tntgames_top_kills_N%` | Name of the player ranked N by kills. |
| `%tntgames_top_wins_N%` | Name of the player ranked N by wins. |
| `%tntgames_top_winstreak_N%` | Name of the player ranked N by win streak. |

For example, `%tntgames_top_wins_1%` is the player with the most wins.

## Live player counts

| Placeholder | Returns |
| --- | --- |
| `%tntgames_total_players%` | Players in any TNT game right now. |
| `%tntgames_tntrun_players%` | Players in TNT Run arenas. |
| `%tntgames_tnttag_players%` | Players in TNT Tag arenas. |
| `%tntgames_bowspleef_players%` | Players in Bow Spleef arenas. |

## Arena info

Replace `<name>` with an arena name. These return `N/A` if the arena does not exist.

| Placeholder | Returns |
| --- | --- |
| `%tntgames_arena_<name>_status%` | The arena's status. |
| `%tntgames_arena_<name>_players%` | Players currently in the arena. |
| `%tntgames_arena_<name>_maxplayers%` | Maximum players. |
| `%tntgames_arena_<name>_minplayers%` | Minimum players. |
| `%tntgames_arena_<name>_type%` | The arena's game type. |
| `%tntgames_arena_<name>_available%` | Free slots (max minus current). |

:::{note}
The default scoreboards already use the player-count placeholders. If PlaceholderAPI is not installed, those lines show the raw placeholder text instead of a number.
:::

## Related

- [Scoreboards and stats](/docs/features/scoreboards-and-stats/)
- [Installation](/docs/getting-started/installation/): installing PlaceholderAPI.