# Scoreboards and stats

URL: https://greenarrowlol.github.io/TNTGamesCore/docs/features/scoreboards-and-stats/
Section: features
Description: Per-game scoreboards, tracked player stats, and leaderboards.

---

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

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](/docs/configuration/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](/docs/reference/placeholders/) for the full list and exact names.

## Related

- [Placeholders](/docs/reference/placeholders/): every placeholder name.
- [Storage](/docs/configuration/storage/): SQLite and MySQL setup.
- [Messages and language](/docs/configuration/messages/): editing scoreboard and message text.