# Placeholders

### PlaceholderAPI

| Placeholder                                 | Description                                                                                                                                                                  | Player needed | Output                       |
| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- | ---------------------------- |
| %deluxecombat\_in\_combat%                  | Returns, if the player is in combat mode                                                                                                                                     | Yes           | true / false                 |
| %deluxecombat\_combat\_time%                | Returns the remaining combat time in seconds                                                                                                                                 | Yes           | Seconds                      |
| %deluxecombat\_combat\_opponent%            | Returns the current combat opponent                                                                                                                                          | Yes           | Playername                   |
| %deluxecombat\_combat\_mode%                | Returns whether the player is in PvP or PvE combat.                                                                                                                          | Yes           | PvE / PvP                    |
| %deluxecombat\_has\_pvp\_enabled%           | Returns, if the player has pvp enabled                                                                                                                                       | Yes           | true / false                 |
| %deluxecombat\_has\_protection%             | Returns, if the player has an active pvp protection                                                                                                                          | Yes           | true / false                 |
| %deluxecombat\_protection\_time\_remaining% | Returns, if the player has an active protection, the remaining time as a time string                                                                                         | Yes           | Protection time (e.g 5m 10s) |
| %deluxecombat\_bounty\_value%               | Returns the value of the bounty the player currently has                                                                                                                     | Yes           | Vault Money                  |
| %deluxecombat\_bounty\_initiator%           | Returns the name of the bounty initiator                                                                                                                                     | Yes           | Playername                   |
| %deluxecombat\_has\_bounty%                 | Returns, if the player has a bounty                                                                                                                                          | Yes           | true / false                 |
| %deluxecombat\_bounty\_prefix%              | Returns the bounty prefix if the  player has a bounty                                                                                                                        | Yes           | Bounty Prefix                |
| %deluxecombat\_item\_cooldown%              | Returns the cooldown in seconds of the item the player is holding in his hand                                                                                                | Yes           | Seconds                      |
| %deluxecombat\_item\_cooldown\_type%        | Displays the item cooldown in seconds for a certain item. TYPE has to be replaced with the material you want to display. e.g ender\_pearl, chorus\_fruit, etc. (lower case!) | Yes           | Seconds                      |
|                                             |                                                                                                                                                                              |               |                              |
| %deluxecombat\_ranking\_kills%              | Returns the amount of kills a player has                                                                                                                                     | Yes           | Kills                        |
| %deluxecombat\_ranking\_deaths%             | Returns the amount of deaths a player has                                                                                                                                    | Yes           | Deaths                       |
| %deluxecombat\_ranking\_kd%                 | Returns the K/D ration of the player                                                                                                                                         | Yes           | KD Ratio                     |
| %deluxecombat\_ranking\_combatlogs%         | Returns the amount of combatlogs a player has                                                                                                                                | Yes           | Combatlogs                   |
| %deluxecombat\_ranking\_points%             | Returns the amount of points a player has                                                                                                                                    | Yes           | Points                       |
| %deluxecombat\_ranking\_streak%             | Returns the current killstreak of the player                                                                                                                                 | Yes           | Killstreak                   |
| %deluxecombat\_ranking\_maxstreak%          | Returns the highest killstreak the player ever had                                                                                                                           | Yes           | Highest killstreak           |
| %deluxecombat\_ranking\_rank%               | Return the current rank of the player                                                                                                                                        | Yes           | Rank                         |

### MVdWPlaceholders

In case you are using MVdWPlaceholders instead of PlaceholderAPI, you can simply use following placeholder and replace the \<Placeholder> part with one of the placeholders above.

```
{placeholderapi_<Placeholder>}​
```

### Creating a sign leaderboard

The sign leaderboard is the easiest to setup since it requires no additional plugins. Simply place a sign at your desired location and input following lines of text:

1. \[DC]
2. {STATSTYPE}
3. {RANK}
4. *Empty*

{% hint style="info" %}
Available stats types: KILLS, DEATHS, POINTS, COMBATLOGS, STREAK, MAXSTREAK
{% endhint %}

### Creating a hologram leaderboard

Do you want a leaderboard, that displays the best players on your server? Then read this tutorial carefully.

#### Requirements

* [x] PlaceholderAPI is installed
* [x] A hologram plugin is installed (The hologram plugin needs to support PlaceholderAPI placeholders)
* [x] The point-ranking-system is enabled
* [x] The wanted stats type needs to be loaded (You can find more about that here)

#### Setup

After you have met all requirements, you can create the leaderboard. Simply create a new hologram line and insert following placeholder:

```
%deluxecombat_ranking_[STATSTYPE]_[RANK]%
```

#### Replacements

You need to replace following things in that placeholder:

* \[STATSTYPE]
  * Replace with: KILLS, DEATHS, POINTS or COMBATLOGS
* \[RANK]
  * Replace with any rank you want to display.

{% hint style="info" %}
The highest rank you can enter is configured in the Point-Ranking-System menu. Any number higher than the pull-limit won't be parsed.
{% endhint %}

#### Using server groups

Do you have multiple server-groups? Then please use following placeholder:

```
%deluxecombat_ranking_[STATSTYPE]_[RANK]_[SERVER GROUP]%
```

Simply replace \[SERVER GROUP] with the desired server group.

{% hint style="info" %}
You can list all available server groups with /dc group list
{% endhint %}