Placeholders

Every PlaceholderAPI placeholder the plugin exposes.

2 min read 355 words

Every placeholder the plugin exposes through PlaceholderAPI.

These need PlaceholderAPI 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.