# 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&#x26;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&#x26;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&#x26;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&#x26;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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://floodeer.gitbook.io/wizards-1/fundamentals/system-and-mechanics/scoreboard.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
