> 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/commands-and-permissions.md).

# Commands & Permissions

Here you can find all Commands and Permissions of DeluxeCombat.

## Permissions

To apply permissions to your players, we recommend using [LuckPerms](https://luckperms.net/). It offers a simple web editor with auto completion.

{% tabs %}
{% tab title="Quick Setup" %}

<table data-full-width="true"><thead><tr><th width="329">Permission</th><th>Description</th></tr></thead><tbody><tr><td>deluxecombat.admin</td><td>Permission for administrators to setup and manage DeluxeCombat entirely. Operators have this permission my default.</td></tr><tr><td>deluxecombat.user</td><td>Basic permission for players to gain access to old-pvp, kill-recaps, grace, deathback, togglepvp, stattrak, pvpstats and bounties. Recommended if you want to quickly setup the plugin.</td></tr></tbody></table>
{% endtab %}

{% tab title="Bypass" %}
Bypass permissions are used to disable certain behaviour of DeluxeCombat for certain players.

| Permission                           | Description                                                   |
| ------------------------------------ | ------------------------------------------------------------- |
| deluxecombat.bypasscommand           | Use blocked commands during combat                            |
| deluxecombat.bypassquit              | Combatlog without any punishments                             |
| deluxecombat.bypasshitdelay          | Hit without delay (Not without weapon cooldown!)              |
| deluxecombat.bypass.enderpearl       | Bypass enderpearl restrictions                                |
| deluxecombat.bypass.chorusfruit      | Bypass chorus-fruit restrictions                              |
| deluxecombat.bypass.totem-of-undying | Bypass totem of undying restrictions                          |
| deluxecombat.bypass.apple.god        | Bypass god apple restrictions                                 |
| deluxecombat.bypass.apple.gold       | Bypass gold apple restrictions                                |
| deluxecombat.bypass.elytra           | Bypass elytra restrictions                                    |
| deluxecombat.bypass.building         | Bypass building restrictions during combat                    |
| deluxecombat.bypass.armor-change     | Bypass amor change restrictions                               |
| deluxecombat.bypass.item-interact    | Bypass item / enchantment restrictions                        |
| deluxecombat.bypass.mending          | Bypass mending restrictions                                   |
| deluxecombat.bypass.drops            | Bypass the dropping behaviour of DeluxeCombat                 |
| deluxecombat.bypass.bounty           | Be immune against bounties                                    |
| deluxecombat.bypass.headdrop         | Your head cannot be dropped on death                          |
| deluxecombat.bypass.tnt              | Bypass tnt cooldown restrictions                              |
| deluxecombat.bypass.glowing          | Immune against glowing effects                                |
| deluxecombat.bypass.fly              | Bypass any flying restrictions                                |
| deluxecombat.bypass.tagger           | Bypass the combat tagger (Has to be enabled in the /dc menu!) |
| deluxecombat.ghostplayer.bypass      | No ghostplayer will be spawned on server quit                 |
| {% endtab %}                         |                                                               |

{% tab title="Bounty" %}
Permissions related to the bounty system.

| Permission                      | Description                          |
| ------------------------------- | ------------------------------------ |
| deluxecombat.bounty             | Create a bounty                      |
| deluxecombat.bounty.information | Use the /bounty (Player) command     |
| deluxecombat.bounty.list        | Use the /bounty list command         |
| deluxecombat.bounty.compass     | Attach a bounty tracker to a compass |
| deluxecombat.bypass.bounty      | Be immune against bounties           |
| {% endtab %}                    |                                      |

{% tab title="Status / Tag" %}
Permissions related to the /tag command

| Permission                      | Description                   |
| ------------------------------- | ----------------------------- |
| deluxecombat.status.check       | Use the /tag command          |
| deluxecombat.status.check.other | Use the /tag (Player) command |
| deluxecombat.status.check.list  | Use the /tag list command     |
| {% endtab %}                    |                               |

{% tab title="Statistic" %}
Permissions related to the /pvpstats command

| Permission                     | Description                                                    |
| ------------------------------ | -------------------------------------------------------------- |
| deluxecombat.stats.check       | Use the /pvpstats command                                      |
| deluxecombat.stats.check.other | Use the /pvpstats (Player) command                             |
| deluxecombat.stats.reset       | Reset your stats with /pvpstats reset                          |
| deluxecombat.stats.reset.other | Reset the stats of other players with /pvpstats reset (Player) |
| {% endtab %}                   |                                                                |

{% tab title="StatTrack" %}
Permissions related to the StatTrack feature.

| Permission                        | Description                                                 |
| --------------------------------- | ----------------------------------------------------------- |
| deluxecombat.stattrak             | Use the /stattrak command                                   |
| deluxecombat.stattrak.inspect     | Use the /stattrak inspect command                           |
| deluxecombat.stattrak.register    | Attach a stattrak on your item with /stattrak register      |
| deluxecombat.stattrak.reset       | Reset your stattrak with /stattrak reset                    |
| deluxecombat.stattrak.changeowner | Change the owner of the stattrak with /stattrak changeowner |
| deluxecombat.stattrak.delete      | Remove the stattrak from an item with /stattrak delete      |
| {% endtab %}                      |                                                             |

{% tab title="Untitled" %}

{% endtab %}

{% tab title="Others" %}
Every other permission.

| Permission                       | Description                                                                        |
| -------------------------------- | ---------------------------------------------------------------------------------- |
| **deluxecombat.admin**           | Permission to manage and configure the DeluxeCombat plugin                         |
| deluxecombat.user                |                                                                                    |
| deluxecombat.old-pvp             | Required if a player wants to use the old pvp features such as no attack cooldown  |
| deluxecombat.view\.kill-recaps   | View kill recaps                                                                   |
| deluxecombat.view\.leaderboard   | View the leaderboard with /dc leaderboard                                          |
| deluxecombat.grace               | Check your grace status with /grace                                                |
| deluxecombat.grace.disable       | Disable your grace period with /grace disable                                      |
| deluxecombat.deathback           | Use the /deathback command                                                         |
| **deluxecombat.togglepvp**       | Toggle your pvp status                                                             |
| deluxecombat.togglepvp.list      | List the pvp status of every player online                                         |
| **deluxecombat.keep-inventory**  | Keep your inventory on death (Needs to be enabled)                                 |
| **deluxecombat.keep-experience** | Keep your experience on death                                                      |
| deluxecombat.transfer-items      | Allows items from the killed player automatically be transferred to the inventory. |
| deluxecombat.potionstack         | Permission to use /potionstack                                                     |
| {% endtab %}                     |                                                                                    |
| {% endtabs %}                    |                                                                                    |

<details>

<summary>deluxecombat.user Children Permission</summary>

```
deluxecombat.view.kill-recaps
deluxecombat.view.leaderboard
deluxecombat.grace.check
deluxecombat.grace.disable
deluxecombat.deathback
deluxecombat.togglepvp
deluxecombat.stattrak
deluxecombat.stattrak.inspect
deluxecombat.stattrak.register
deluxecombat.stats.check
deluxecombat.stats.check.other
deluxecombat.status.check
deluxecombat.status.check.other
deluxecombat.bounty
deluxecombat.bounty.information
deluxecombat.bounty.list
deluxecombat.bounty.compass
```

</details>

## Commands

### DeluxeCombat Sub Commands

{% hint style="info" %}
Required Permission: **deluxecombat.admin**
{% endhint %}

{% tabs %}
{% tab title="Menu CMD" %}

#### The Menu Command

| Usage              | Description                 |
| ------------------ | --------------------------- |
| /deluxecombat menu | Opens the DeluxeCombat Menu |

The menu command is the heart of DeluxeCombat. With this command, you can access the **configuration** menu, with which you will configure the entire plugin. Furthermore, you can choose a **language** via the embedded language list. Additionally, you can click on the support item which will display you support information.
{% endtab %}

{% tab title="Apple CMD" %}

#### The Apple Command

| Usage                          | Description                           |
| ------------------------------ | ------------------------------------- |
| /dc apple                      | Shows the help message                |
| /dc apple effects              | Lists all avaible potion effects      |
| /dc apple (god/gold) recipe    | Opens the recipe editor               |
| /dc apple (god/gold) list      | Lists all applied potion effects      |
| /dc apple (god/gold) clear     | Clears all applied potion effects     |
| /dc apple (god/gold) add\*     | Adds an effect to the apple type      |
| /dc apple (god/gold) remove\*² | Removes an effect from the apple type |

The apple commands allows you to **change the potion effects** you get when you **eat an god / gold apple**. Additionally, you can change the god / gold apple **recipe** with an ingame editor.

\*The following command will add the potion effect "speed" level "1" for "30" seconds when you eat a god apple. Please notice that if you add one custom effect to the effects list, all original potion effects will get removed. To get the original effects back, simply use the clear command that listed above.

{% hint style="info" %}
/dc apple god add SPEED 1 30
{% endhint %}

\*²The following command will remove the potion effect "speed" we  have added before.

{% hint style="info" %}
/dc apple god remove SPEED
{% endhint %}
{% endtab %}

{% tab title="Potion CMD" %}

#### The Potion Command

| Usage             | Description                           |
| ----------------- | ------------------------------------- |
| /dc potion        | Shows the help message                |
| /dc potion list   | Lists all blacklisted potions         |
| /dc potion add    | Adds the potion to the blacklist      |
| /dc potion remove | Removes the potion from the blacklist |
| /dc potion clear  | Clears the potion blacklist           |

The potion command allows you to blacklist potions, which you want to ban from your server.

To use it, simply put the potion you want to ban from your server into your hand and run the add command listed above. Do the same procedure, when you want to remove a potion from your backlist.

{% hint style="info" %}
If you want to ban the blacklisted potions only during combat, simply go to **/dc menu, Settings, Combat, Combat (Extras)** and enable the option "**Ban potions during combat**"
{% endhint %}
{% endtab %}

{% tab title="Totem CMD" %}

#### The Totem Command

| Usage               | Description                       |
| ------------------- | --------------------------------- |
| /dc totem           | Shows the help message            |
| /dc totem effects   | Lists all avaible potion effects  |
| /dc totem list      | Lists all applied potion effects  |
| /dc totem clear     | Clears all applied potion effects |
| /dc totem add\*     | Adds an effect to the totems      |
| /dc totem remove\*² | Removes an effect from the totems |

The totem commands allows you to **change the potion effects** you get when you use an **totem of undying**.

\*The following command will add the potion effect "speed" level "1" for "30" seconds when youuse an totem. Please notice that if you add one custom effect to the effects list, all original potion effects will get removed. To get the original effects back, simply use the clear command that listed above.

{% hint style="info" %}
/dc totem add SPEED 1 30
{% endhint %}

\*²The following command will remove the potion effect "speed" we  have added before.

{% hint style="info" %}
/dc totem remove SPEED
{% endhint %}
{% endtab %}

{% tab title="Spawnpoint CMD" %}

#### The Spawnpoint Command

| Usage                   | Description            |
| ----------------------- | ---------------------- |
| /dc editSP              | Shows the help message |
| /dc editSP (Spawnpoint) | Edit a spawnpoint      |

The spawnpoint command allows you to edit spawnpoints, after you have placed them. To place a spawnpoint, simply put an **obsidian** block on the ground and a **gold** block above. After the spawnpoint has been placed, you will automatically get a help message to the edit the spawnpoint. You can set the **name**, set a **permission** you need to have in order to use the spawnpoint, you can **teleport** yourself to the spawnpoint and you can **delete** the spawnpoint.

{% hint style="info" %}
If you want a specific rotation the player looks at when he gets teleported to the spawnpoint, simply place the gold block facing in the wanted direction. The eye height will be automatically adjusted by DeluxeCombat.
{% endhint %}
{% endtab %}

{% tab title="Clear CMD" %}

#### The Clear Command

| Usage            | Description                 |
| ---------------- | --------------------------- |
| /dc clear (Type) | Clears a specific list type |

| Type   | Desription                              |
| ------ | --------------------------------------- |
| CORPSE | Clears / Removes all corpses            |
| ABUSES | Clears / Removes all active kill abuses |

The clear command is ment to clear certain lists of the plugin.
{% endtab %}

{% tab title="Group CMD" %}

#### The Group Command

| Usage          | Description                                          |
| -------------- | ---------------------------------------------------- |
| /dc group      | Help message                                         |
| /dc group info | Link to the deluxecombat wiki                        |
| /dc group list | Lists all active groups and the current server group |

Groups or Data groups allow you to seperate DeluxeCombat instances into multiple data sets, while using only one database table.

#### Example

You have three servers. One factions server and two minigame servers. On all of those three servers, you have DeluxeCombat installed. To keep the deluxecombat stats seperated, you can create different datagroups for those servers.

This allows you to create leaderboards for the minigame servers and a leaderboard for the factions server.

To setup a datagroup do following steps:

1. Stop your server
2. Open the data.yml in the DeluxeCombat folder
3. Go to the **General** section. And edit the **data-group** setting
4. Repeat steps **1** to **4** for all other server you want to have a different data group
5. Start your servers again
   {% endtab %}
   {% endtabs %}

### Console commands

Those commands can only be executed via the console

| Command                                     | Description                                                                  |
| ------------------------------------------- | ---------------------------------------------------------------------------- |
| /dc untag (Player/All)                      | Untags a player / all players that is currently in combat                    |
| /dc tag (Player) (Seconds)                  | Tag a specific player for the entered amount of seconds.                     |
| /dc clear (abuses/corpses)                  | Remove all active kill-abuses / spawned corpses.                             |
| /togglepvp (Player) true/false              | Toggles the pvp of a player                                                  |
| /pvpstats reset (Player)                    | Reset the pvp stats of a player                                              |
| /pvppoints add (Player) (Amount)            | Adds points to a player                                                      |
| /pvppoints remove (Player) (Amount)         | Removes points from a player                                                 |
| /pvppoints set (Player) (Amount)            | Set the points of a player                                                   |
| /grace give (Player)                        | Adds a grace period to a player                                              |
| /grace give (Player) (Seconds)              | Adds a grace period to a player for (Seconds)                                |
| /grace disable (Player)                     | Removes the grace period from a player                                       |
| /deluxecombat-bounty (Player) (Bounty)      | Sets a bounty on a player. (Bounty) is the money value.                      |
| /deluxecombat-bounty (Player) (Bounty) true | Sets a bounty on a player without printing a broadcast message into the chat |
|                                             |                                                                              |

### PvP Points Command

<table><thead><tr><th width="226">Usage</th><th width="272">Permission</th><th>Description</th></tr></thead><tbody><tr><td>/pvppoints add/remove/set (Player) (Amount) </td><td>deluxecombat.admin</td><td>Add / Remove / Set the pvp points of a player.</td></tr></tbody></table>

### PvP Stats Command

#### Player Commands

<table><thead><tr><th width="208.33333333333331">Usage</th><th width="286">Permission</th><th>Description</th></tr></thead><tbody><tr><td>/pvpstats</td><td>deluxecombat.stats.check</td><td>Shows your pvp statstics</td></tr><tr><td>/pvpstats (Player)</td><td>deluxecombat.stats.check.other</td><td>Shows the pvp statistics of a player</td></tr><tr><td>/pvpstats reset</td><td>deluxecombat.stats.reset</td><td>Resets your pvp statistics</td></tr></tbody></table>

#### Admin Commands

| Usage                           | Permission         | Description                                        |
| ------------------------------- | ------------------ | -------------------------------------------------- |
| /pvpstats reset (Player)        | deluxecombat.admin | Reset the pvp statistics of a player               |
| /pvpstats reset (Player) (Type) | deluxecombat.admin | Resets a specific statistics type of player        |
| /pvpstats reset ALL (Type)      | deluxecombat.admin | Resets a specific statistics type of every player. |

{% hint style="success" %}
Statistics Types are: **KILLS, DEATHS, COMBATLOGS, POINTS, KD, MAXSTREAK**
{% endhint %}

### Potionstack Command

{% hint style="warning" %}
Potionstack has to be enabled in the potion menu! ( /dc menu, Settings, PvP, Potions)
{% endhint %}

<table><thead><tr><th width="157">Usage</th><th width="282">Permission</th><th>Description</th></tr></thead><tbody><tr><td>/potionstack</td><td>deluxecombat.potionstack</td><td>Stacks all potion from inside the inventory to one bigger stack. The maximum stack size can be configured in the /dc menu.</td></tr></tbody></table>

### Grace Command

<table><thead><tr><th width="230">Usage</th><th width="275">Permission</th><th>Description</th></tr></thead><tbody><tr><td>/grace</td><td>deluxecombat.grace.check</td><td>Check your grace status</td></tr><tr><td>/grace disable</td><td>deluxecombat.grace.disable</td><td>Disable your grace period</td></tr><tr><td>/grace (Player)</td><td>deluxecombat.grace.check.other</td><td>Check the grace status of other players</td></tr><tr><td>/grace disable (Player)</td><td>deluxecombat.admin</td><td>Disable the grace period of a player</td></tr><tr><td>/grace disable confirm</td><td>deluxecombat.grace.disable</td><td>Confirm that you want to disable your grace period</td></tr><tr><td>/grace give (Player)</td><td>deluxecombat.grace.give</td><td>Give players a grace period. The time is configurable in the /dc menu</td></tr></tbody></table>

### Tag Command

<table data-full-width="false"><thead><tr><th width="148.33333333333331">Usage</th><th width="307">Permission</th><th>Description</th></tr></thead><tbody><tr><td>/tag</td><td>deluxecombat.status.check</td><td>Shows your current pvp status.</td></tr><tr><td>/tag (Player)</td><td>deluxecombat.status.check.other</td><td>Shows the current pvp status of a player.</td></tr><tr><td>/tag list</td><td>deluxecombat.status.check.check</td><td>Shows all currently tagged players.</td></tr></tbody></table>

### Toggle PvP Command

<table><thead><tr><th width="219">Usage</th><th width="270">Permission</th><th>Description</th></tr></thead><tbody><tr><td>/togglepvp</td><td>deluxecombat.togglepvp</td><td>Toggle your pvp status</td></tr><tr><td>/togglepvp confirm</td><td>deluxecombat.togglepvp</td><td>Confirm that you want to toggle your pvp status</td></tr><tr><td>/togglepvp list</td><td>deluxecombat.togglepvp.list</td><td>List the pvp status of all players.</td></tr><tr><td>/togglepvp (Player)</td><td>deluxecombat.admin</td><td>Force toggle the pvp of a player</td></tr><tr><td>/togglepvp ALL</td><td>deluxecombat.admin</td><td>Force toggle the pvp of all players</td></tr></tbody></table>

### Kill Recaps Command

{% hint style="warning" %}
Kill-Recaps have to be enabled in the settings! ( /dc menu, Settings, Death, Kill-Recaps )
{% endhint %}

<table><thead><tr><th width="209">Usage</th><th width="281">Permission</th><th>Description</th></tr></thead><tbody><tr><td>/killrecaps</td><td>deluxecombat.view.kill-recaps</td><td>Open the kill-recaps list menu.</td></tr><tr><td>/killrecaps (ID)</td><td>deluxecombat.view.kill-recaps</td><td>Open a specific kill-recap</td></tr><tr><td>/killrecaps clear</td><td>deluxecombat.admin</td><td>Remove all kill-recaps</td></tr></tbody></table>

### Sellhead Command

{% hint style="warning" %}
Sellheads need to be activated in the vault options menu! ( /dc menu, Settings, Supported Plugins, Vault).\
\
That means you need to have Vault + an Economy Plugin to be installed on your server.
{% endhint %}

<table data-header-hidden><thead><tr><th width="369">Usage</th><th>Description</th></tr></thead><tbody><tr><td>Usage</td><td>Description</td></tr><tr><td>/sellhead</td><td>Sells the head in your hand.</td></tr></tbody></table>

If the /sellhead should be overridden by another plugin, you can still use /deluxecombat-sellhead! You can change the alias of the command in the menu named above!

### StatTrak Command

{% hint style="warning" %}
StatTraks need to be enabled in the nbtapi options menu! ( /dc menu, Settings, Supported Plugins, NBTAPI)\
\
StatTraks require Vault and an economy plugin to be installed!
{% endhint %}

<table data-header-hidden><thead><tr><th width="354">Usage</th><th>Description</th></tr></thead><tbody><tr><td>Usage</td><td>Description</td></tr><tr><td>/stattrak</td><td>Help message</td></tr><tr><td>/stattrak inspect</td><td>Inspects the stattrak item in your hand</td></tr><tr><td>/stattrak register</td><td>Registers the item you hold in your hand with a new stattrak!</td></tr><tr><td>/stattrak changeOwner (Player)</td><td>Sets a new owner for the stattrak item in your hand</td></tr><tr><td>/stattrak reset</td><td>Resets the stattrak from the item you are holding in your hand</td></tr><tr><td>/stattrak remove</td><td>Removes the stattrak from the item you are holding in your hand</td></tr></tbody></table>

### PvP Interval Command

{% hint style="info" %}
Required Permission: **deluxecombat.admin**
{% endhint %}

| Usage                                                 | Description                      |
| ----------------------------------------------------- | -------------------------------- |
| /pvp-interval list                                    | Lists all active intervals       |
| /pvp-interval remove (World) (Number/ID)              | Removes an interval from a world |
| /pvp-interval add (World) (From) (To) (Reallife Time) | Adds an interval to a world      |

| Parameter       | Description                                                                          |
| --------------- | ------------------------------------------------------------------------------------ |
| (World)         | Thats the world name.                                                                |
| (Number/ID)     | The number / id of an interval can be found with /pvp-interval list                  |
| (From) / (To)   | Ticks / Clock Time on a 24-hour clock base                                           |
| (Reallife Time) | true / false : Decide if you want to use reallife time (true) or world ticks (false) |

#### Example

```
// Following command will add an interval to the world "world"
// from 8:30 am until 16:30 pm.
/pvp-intervall add world 8:30 16:30 true

// Following command will add an interval to the world "factions".
// Here, we use the world ticks from 1000 to 10000.
/pvp-intervall add factions 1000 10000 false
```

With the pvp interval command you can add pvp intervals to your server. PvP Intervals are time intervals in which the pvp is enabled in a certain world. You can decide wether you like to use real world time or the ingame time (world ticks).