> For the complete documentation index, see [llms.txt](https://floodeer.gitbook.io/wizards/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://floodeer.gitbook.io/wizards/fundamentals/system-and-mechanics/scoreboard.md).

# Scoreboard

There's a lot of ways to use the Scoreboard, you can change it at language.yml to make look the way you want

## Default Domination Scoreboard

<figure><img src="https://4293080539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYrTV6pKptRagG0E9N0EQ%2Fuploads%2FFppw165XXYjCwMAfGZVS%2FdefaultScoreboard.png?alt=media&amp;token=b026b706-1030-4116-9019-093ba6fe3b49" alt=""><figcaption><p>This is the default Scoreboard.</p></figcaption></figure>

This is the basic scoreboard, the config for it is as follows:&#x20;

```
  Game-Scoreboard:
  - ' '
  - '&9BLU&f: &9%blue_points%&f / &a+%blue_points_per_second%'
  - '&cRED&f: &c%red_points%&f / &a+%red_points_per_second%'
  - ' '
  - '%objectives%'
  - ' '
  - '&fKills: &a%kills%'
```

The %objectives% placeholder will replace all the lines with your game objectives, you can change the objective names in the same language.yml file.

As version 6.0.0, you can add the placeholder %time\_to\_win% to display the time it will take for a team to win a Domination match.&#x20;

<figure><img src="https://4293080539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYrTV6pKptRagG0E9N0EQ%2Fuploads%2FhNRJvgwoQf7hOKbHA4nX%2F1.png?alt=media&amp;token=2684345b-192e-4c8f-8f4f-4e72c5bc0356" alt=""><figcaption></figcaption></figure>

As version 6.0.0, with a few tweaks, you can make the Domination Scoreboard look a little similar to something very familiar

<figure><img src="https://4293080539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYrTV6pKptRagG0E9N0EQ%2Fuploads%2Fh8zZ0RtECjqVkiePjcqm%2F2.png?alt=media&amp;token=4f36c14c-7bbb-4532-8f0e-6400467bc760" alt=""><figcaption></figcaption></figure>

The config for the scoreboard above:

```
  Game-Scoreboard:
  - ' '
  - '&9BLU&f: &9%blue_points%&f / &a+%blue_points_per_second%'
  - '&cRED&f: &c%red_points%&f / &a+%red_points_per_second%'
  - ' '
  - '%time_to_win%'
  - ' '
  - '%objectives%'
  - ' '
  - '&fKills: &a%kills%'
  Title: '&e&lWIZARDS'
  Uncaptured-Point-Placeholder: '&f&l%name%'
  Objective-Placeholder: '%color%&l%name% &l%team_prefix%'
  Blue-Team-Prefix: '&9BLU'
  Red-Team-Prefix: '&cRED'
  Time-To-Win: '%team_prefix% &6Wins in &b%time%'
  Time-To-Win-Empty: '&7...'
```

## CTF Scoreboard

<figure><img src="https://4293080539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYrTV6pKptRagG0E9N0EQ%2Fuploads%2FonnNcyP0K7QccPcAAc1W%2F3.png?alt=media&amp;token=e8548cb6-0530-424a-8434-30ed5494201c" alt=""><figcaption></figcaption></figure>

For the CTF Scoreboard, you can just add the %ctf% Placeholder. This placeholder will be removed if the game does not have any CTF flags, you can also let the %objectives% placeholder there, it will be removed if there are no objectives.

```
  Game-Scoreboard:
  - ' '
  - '&9BLU&f: &9%blue_points%&f / &a+%blue_points_per_second%'
  - '&cRED&f: &c%red_points%&f / &a+%red_points_per_second%'
  - ' '
  - '%objectives%'
  - '%ctf%'
  - ' '
  - '&fKills: &a%kills%'
```

## Placeholders

Here's a list of ALL Placeholders for the Game Scoreboard

<table data-full-width="true"><thead><tr><th>Placeholder</th><th>Scoreboard Type</th><th>Function</th><th>Condition</th></tr></thead><tbody><tr><td>%kit%</td><td>ALL</td><td>Returns the player current kir or class.</td><td>None</td></tr><tr><td>%class_displayname%</td><td>ALL</td><td>Returns class display name, returns kit name if using kits</td><td>None</td></tr><tr><td>%formatted_time%</td><td>In-Game Scoreboard</td><td>Returns the game time in mm:ss</td><td>None</td></tr><tr><td>%kills%</td><td>In-Game Scoreboard</td><td>Returns the kill amount</td><td>None</td></tr><tr><td>%deaths%</td><td>In-Game Scoreboard</td><td>Returns the death amount</td><td>None</td></tr><tr><td>%red_points%</td><td>In-Game Scoreboard</td><td>Returns red points</td><td>CTF Captures-To-Win must be set to -1 OR Score-To-Capture must have a value.</td></tr><tr><td>%blue_points%</td><td>In-Game Scoreboard</td><td>Returns blue points</td><td>CTF Captures-To-Win must be set to -1 OR Score-To-Capture must have a value.</td></tr><tr><td>%red_kills%</td><td>In-Game Scoreboard</td><td>Returns red team total kills</td><td>None</td></tr><tr><td>%blue_kills%</td><td>In-Game Scoreboard</td><td>Returns blue team total kills</td><td>None</td></tr><tr><td>%red_points_per_second%</td><td>In-Game Scoreboard</td><td>Retruns red points per second</td><td>The game cannot be only CTF.</td></tr><tr><td>%blue_points_per_second%</td><td>In-Game Scoreboard</td><td>Retruns blue points per second</td><td>The game cannot be only CTF.</td></tr><tr><td>%red_flags_captured%</td><td>In-Game Scoreboard</td><td>Returns the amount of red flags captured</td><td>The game has to be CTF or at least have the flags set.</td></tr><tr><td>%blue_flags_captured%</td><td>In-Game Scoreboard</td><td>Returns the amount of blue flags captured</td><td>The game has to be CTF or at least have the flags set.</td></tr><tr><td>%time_to_win%</td><td>In-Game Scoreboard</td><td>Returns the approximate time for a team to win according to their points per second</td><td>The game cannot be only CTF or only TDM. Game objectives has to be set. The formula does not count kills per X time.</td></tr><tr><td>%objectives%</td><td>In-Game Scoreboard</td><td>Returns, and replaces, all next lines with the game objectives</td><td>The game has to have objectives, otherwise this line will be deleted.</td></tr><tr><td>%ctf%</td><td>In-Game Scoreboard</td><td>Returns, and replaces, all next lines with the CTF flags and its state.</td><td>The game has to have flags, otherwise this line will be deleted.</td></tr><tr><td>%players%</td><td>Lobby Scoreboard</td><td>Returns the current player amount.</td><td>None</td></tr><tr><td>%mapname%</td><td>Lobby Scoreboard</td><td>Returns the map name or display name if any.</td><td>None</td></tr><tr><td>%minplayers%</td><td>Lobby Scoreboard</td><td>Returns the minimum amount of players for the starting countdown.</td><td>None</td></tr><tr><td>%maxplayers%</td><td>Lobby Scoreboard</td><td>Returns the max of players of the arena.</td><td>None</td></tr><tr><td>%timer%</td><td>Lobby Scoreboard</td><td>Returns the starting countdown.</td><td>None</td></tr><tr><td>%state%</td><td>Lobby Scoreboard</td><td>Returns the game state.</td><td>None</td></tr><tr><td>%capitalize_state%</td><td>Lobby Scoreboard</td><td>Returns the capitalized game state.</td><td>None</td></tr><tr><td>%wins%</td><td>Lobby Scoreboard</td><td>Returns the win amount.</td><td>None</td></tr><tr><td>%games_played%</td><td>Lobby Scoreboard</td><td>Returns the amount of games played.</td><td>None</td></tr><tr><td>%balance%</td><td>Lobby Scoreboard</td><td>Returns the player balance.</td><td>None</td></tr></tbody></table>
