> For the complete documentation index, see [llms.txt](https://timderspieler.gitbook.io/timderspieler-plugins/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://timderspieler.gitbook.io/timderspieler-plugins/deluxecombat/supported-plugins/placeholders.md).

# 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 %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://timderspieler.gitbook.io/timderspieler-plugins/deluxecombat/supported-plugins/placeholders.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.
