> For the complete documentation index, see [llms.txt](https://voxel-inc.gitbook.io/voxel-inc-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://voxel-inc.gitbook.io/voxel-inc-docs/mechanics/death-events/commands.md).

# • Commands

Scheduling death commands allows you to manage a wide variety of actions, which can become rich with placeholders and other plugins' hooks.

<figure><img src="https://2175010478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FglWNFDJNGZfCxpNMetLw%2Fuploads%2F5y9aCcDGfy2aJWAQkN20%2FCommands.png?alt=media&amp;token=9d97782c-c676-49e4-8c1a-0e0b934c3391" alt="" width="128"><figcaption></figcaption></figure>

### Enable commands

You can adjust your effect's commands by diving into the dedicated **panel** upon <mark style="background-color:green;">creation</mark> or <mark style="background-color:green;">editing</mark>, accessible when clicking on "**Set Death Commands**".

<figure><img src="https://2175010478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FglWNFDJNGZfCxpNMetLw%2Fuploads%2FTcdeGjRFsFX8OPcMqmrB%2FCommandsPanelPR.gif?alt=media&amp;token=382aaa92-b633-4af1-88f5-f9eca1e0b42c" alt="" width="563"><figcaption></figcaption></figure>

The Command Panel offers three main actions:

• 🔃 **Execution Mode**\
• ➕ **Create New Effect**\
• ✅ **Save and go back**

• ❌ Delete command (**secondary**)

{% hint style="info" %}
You can assign up to **27** commands to a <mark style="background-color:green;">single</mark> kill effect, making it incredibly **powerful** and **feature-rich**
{% endhint %}

***

### Execution Mode

The execution mode has **two** main options. It lets you choose what commands to <mark style="background-color:green;">send</mark> once the effect gets <mark style="background-color:green;">triggered</mark>.

{% stepper %}
{% step %}

### Execute All

Sends **all** commands assigned to the kill effect.
{% endstep %}

{% step %}

### Random

Sends **one** <mark style="background-color:green;">random</mark> command among the ones in the panel.
{% endstep %}
{% endstepper %}

<figure><img src="https://2175010478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FglWNFDJNGZfCxpNMetLw%2Fuploads%2FJuLsKsthW537eyjGmJrY%2FECP1.png?alt=media&amp;token=64206369-6a71-4913-96a4-5f9a0847580e" alt="" width="370"><figcaption></figcaption></figure>

***

### Add a new command

To add a **new** command inside the panel just hit the "**Add New Command**" icon and another <mark style="background-color:green;">menu</mark> will pop up, letting you <mark style="background-color:green;">customize</mark> the main aspects of it.

<figure><img src="https://2175010478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FglWNFDJNGZfCxpNMetLw%2Fuploads%2F3uLjZe9hYJ2bXQC30rZO%2FANC.png?alt=media&amp;token=141313aa-656e-4e16-860d-c3496a57166d" alt="" width="350"><figcaption></figcaption></figure>

{% tabs fullWidth="false" %}
{% tab title="Insert Command" %}

<div align="left"><figure><img src="https://2175010478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FglWNFDJNGZfCxpNMetLw%2Fuploads%2FrkU1a4PbfMHcIr4AKOY2%2FANC1.png?alt=media&amp;token=3981a847-9e24-4d2f-9f83-231512d5c09e" alt="" width="375"><figcaption></figcaption></figure></div>

### Insert a command

By clicking the icon you will be asked to insert the command **via chat**. Write it down <mark style="background-color:green;">without</mark> the **/** (slash) before the string. Type **EXIT** to cancel.

{% hint style="info" %}
You can also use <mark style="background-color:green;">placeholders</mark> such as **%player\_name%** or **%player\_balance%** for variables
{% endhint %}
{% endtab %}

{% tab title="Select Execution" %}

<div align="left"><figure><img src="https://2175010478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FglWNFDJNGZfCxpNMetLw%2Fuploads%2FPH0WQ1u2Y5StAcRhnDBO%2FANC2.png?alt=media&amp;token=eb8f17b1-4324-4bb6-b6e8-918fcb9bf5ae" alt="" width="375"><figcaption></figcaption></figure></div>

### Select the executor

You can change the **entity** that's going to <mark style="background-color:green;">execute</mark> the command once the effect is **triggered**.\
By clicking the icon you will **swap** among the available options:

* **CONSOLE** (best): the console of your server will send the command
* **KILLER:** the killer will send the command, works *depending* on permissions
* **VICTIM:** the victim will send the command, works *depending* on permissions
* **KILLER AS OP / VICTIM AS OP:** the victim / killer will send the command *regardless* of permissions, since it will result as 'operator' <mark style="background-color:green;">only</mark> for the execution of the command.

{% hint style="danger" %}
If you're using **F3NPerm** or other plugins for <mark style="background-color:green;">OP safeguard</mark>, we suggest choosing **CONSOLE** as best option to avoid errors. Killer / Victim as op may **not** work depending on the protection.
{% endhint %}
{% endtab %}

{% tab title="Extra Information" %}

### Limited execution

<div align="left"><figure><img src="https://2175010478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FglWNFDJNGZfCxpNMetLw%2Fuploads%2F6SmNE8l4WSbYLJoBinZ5%2FANC3.png?alt=media&amp;token=a453c642-d2fe-4f71-8bd9-6b27a139f291" alt="" width="375"><figcaption></figcaption></figure></div>

Like shown in-game, commands will work **only** if the victim (<mark style="background-color:green;">killed entity</mark>) is a **Player**.

Due to **known exceptions** that may cause errors, we decided to <mark style="background-color:green;">limit</mark> this option since killed mobs or other entities may behave *weirdly*.&#x20;

Reach out in our [Discord Server](https://discord.gg/8ngSDAMTZx) for any kind of **bug report**!
{% endtab %}
{% endtabs %}

***