> 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/placeholders-and-leaderboards.md).

# Placeholders & Leaderboards

## Leaderboards

You need HolographicDisplays to work with Leaderboards, just use the placeholder:<br>

* {wizards\_wins\_number}
  * e.g: {wizards\_wins\_1} will return player with most wins.
  * {wizards\_wins\_2} etc
* {wizards\_kills\_number}
  * e.g: {wizards\_kills\_1} will return player with most checkpoints
  * {wizards\_kills\_2} etc

## Placeholders:

* {wizards\_kills\_NUMBER}
  * %kills% from player.
* {wizards\_wins\_NUMBER}
  * %wins% from player.
* {wizards\_damage\_NUMBER}
  * %damage% from player.
* {wizards\_healing\_NUMBER}
  * %healing% from player.

### PlaceholderAPI support ​&#x20;

The following placeholders are available, they are self explanatory:

%wizards\_wins%&#x20;

%wizards\_gamesplayed%&#x20;

%wizards\_losses%&#x20;

%wizards\_kills%&#x20;

%wizards\_assists%&#x20;

%wizards\_deaths%&#x20;

%wizards\_damagecaused%&#x20;

%wizards\_healingdone%&#x20;

%wizards\_balance%&#x20;

%wizards\_kit\_name%&#x20;

%wizards\_kit\_displayname%

&#x20;%wizards\_class\_name%&#x20;

%wizards\_class\_displayname%

### Arena Placeholders &#x20;

%wizards\_arena\_players\_{arena}%&#x20;

%wizards\_arena\_max\_players\_{arena}%&#x20;

%wizards\_arena\_min\_xplayers\_{arena}%&#x20;

%wizards\_arena\_status\_{arena}%&#x20;

%wizards\_points-to-win\_{arena}%

An extra placeholder is **%wizards\_team\_color%** that returns player's team color, if in game. This was added in case you need to use a third party nametag plugin.

## Scoreboard Placeholders

* Game Placeholder list:
  * %kit% - Player kit or class.
  * %formatted\_time% - Game time in mm:ss
  * %kills% - Game Kills
  * %deaths% - Game Deaths
  * %red\_points% - Red points
  * %blue\_points% - Blue points
  * %red\_points\_per\_second% - Red points per second
  * %blue\_points\_per\_second% - Blue points per second
  * %objectives% - Will replace all next lines with the amount of objectives you have.\
    %ctf - Will replace all lines with the CTF format at messages file.

* Lobby placeholders list:
  * %players% - Current number of players
  * %maxplayers% - Max amount of players
  * %minplayers% - Min amount of players
  * %mapname% - The map name
  * %timer% - Starting timer
  * %state% and %capitalize\_state% - Game state
  * %wins% - Player wins stat
  * %games\_played% - Player Games played stat
  * %balance% - Player balance
  * %kit% - Player kit or class.

## Unformatted Placeholders

Those will only return the value not the formatted placeholder from config, example:<br>

* %wizards\_data\_kills\_player\_1% - Returns the player name with most kill
* %wizards\_data\_kills\_1% - Returns the kill amount of the 1st player<br>

Applies for all leaderboard placeholders:<br>

* %wizards\_data\_damage\_player\_POSITION%
* %wizards\_data\_damage\_POSITION%
* %wizards\_data\_healing\_player\_POSITION%
* %wizards\_data\_healing\_POSITION%
* %wizards\_data\_flags\_captured\_player\_POSITION%
* %wizards\_data\_flags\_captured\_POSITION%
* %wizards\_data\_wins\_player\_POSITION%
* %wizards\_data\_wins\_POSITION%
* %wizards\_data\_exp\_player\_POSITION%
* %wizards\_data\_rank\_POSITION%
* %wizards\_data\_leaderboard\_exp\_POSITION%