Scoreboards and stats

Per-game scoreboards, tracked player stats, and leaderboards.

1 min read 278 words

Live scoreboards for each game and state, plus player stats and leaderboards.

Scoreboards

The plugin shows a scoreboard that changes with what the player is doing: in the global lobby, waiting in an arena, playing, or spectating. Layouts live in scoreboard.yml, one per game and state, so you can rewrite the lines without touching code.

Scoreboard lines can use placeholders, including the plugin's own player-count placeholders such as %tntgames_total_players%. Those require PlaceholderAPI.

Note

The scoreboard footer shows tntgames.com, the in-game server domain. Change it in scoreboard.yml to your own domain.

Stats tracked

The plugin records per-player stats and keeps them in a database (SQLite by default, MySQL optional). See Storage for where the data lives.

Stat Meaning
Kills Players you eliminated.
Deaths Times you were eliminated.
Wins Games you won.
Losses Games you lost.
Games played Total games finished.
Win streak Current run of wins in a row.
KDR Kill/death ratio.
WLR Win/loss ratio.

Leaderboards

The plugin exposes ranked lists you can show anywhere placeholders work (holograms, scoreboards, signs):

  • Top kills
  • Top wins
  • Top win streak

Each returns the player name at a given position, so %tntgames_top_wins_1% is the top player by wins.

Showing stats

All stats and leaderboards are available through PlaceholderAPI. See Placeholders for the full list and exact names.