# Actions

This section is used for dialogues and actions. You can use PlaceholderAPI variables on actions.

<table data-header-hidden><thead><tr><th>Action</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>Action</td><td>Description</td><td>Example</td></tr><tr><td><strong>console_command</strong></td><td>Executes a command from the console.</td><td><code>console_command: eco give %player% 5000</code></td></tr><tr><td><strong>player_command</strong></td><td>Executes a command from the player.</td><td><code>player_command: warp survival</code></td></tr><tr><td><strong>player_command_as_op</strong></td><td>Executes a command from the player as OP. (Not recommended)</td><td><code>player_command_as_op: help</code></td></tr><tr><td><strong>teleport</strong></td><td>Teleports the player. Use this format: <br>"teleport: world;x;y;z;yaw;pitch"</td><td><code>teleport: lobby;0;60;0;90;0</code></td></tr><tr><td><strong>give_potion_effect</strong></td><td>Gives a potion effect to the player. Use this format: <br>"give_potion_effect: effect;duration_in_ticks;level;particles"<br>You can find a list of potion effects here: <a href="https://hub.spigotmc.org/javadocs/spigot/org/bukkit/potion/PotionEffectType.html">https://hub.spigotmc.org/javadocs/spigot/org/bukkit/potion/PotionEffectType.html</a></td><td><code>give_potion_effect: BLINDNESS;180;1;false</code></td></tr><tr><td><strong>remove_potion_effect</strong></td><td>Removes a potion effect from the player.</td><td><code>remove_potion_effect: BLINDNESS</code></td></tr><tr><td><strong>playsound</strong></td><td>Plays a sound to the player. Use this format:<br>"playsound: sound;volume;pitch"<br>You can find a list of sounds here: <a href="https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html">https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html</a><br>Use this list instead when using 1.8: <a href="https://helpch.at/docs/1.8.8/index.html?org/bukkit/Sound.html">https://helpch.at/docs/1.8.8/index.html?org/bukkit/Sound.html</a></td><td><code>playsound: BLOCK_NOTE_BLOCK_PLING;10;0.1</code></td></tr><tr><td><strong>playsound_resource_pack</strong></td><td>Plays a resource pack sound to the player. Uses the same format of the playsound action.</td><td><p><code>playsound_resource_pack:</code></p><p><code>my_custom_sound;10;1</code></p></td></tr><tr><td><strong>stopsound</strong></td><td>Stops a sound for the player.<br><br>Use <code>stopsound: &#x3C;sound></code> for specific sound. Only works on 1.10+. <br><br>Use <code>stopsound: all</code> for stopping all sounds. Only works on 1.17+.</td><td><p></p><p><code>stopsound: BLOCK_NOTE_BLOCK_PLING</code><br><code>stopsound: all</code></p></td></tr><tr><td><strong>stopsound_resource_pack</strong></td><td>Stops a resource pack sound for the player.</td><td><code>stopsound_resource_pack: scorpions:custom.test</code></td></tr><tr><td><strong>title</strong></td><td>Sends a title and subtitle message to the player. Use this format: <br>"title: fadeIn;stay;fadeOut;title;subtitle" fadeIn, stay and fadeOut must be in ticks, 20ticks = 1second <br>If you want just a title, or just subtitle write "none"</td><td><code>title: 20;40;20;&#x26;6This is a title;none</code></td></tr><tr><td><strong>actionbar</strong></td><td>Sends an actionbar message to the player. Use this format: <br>"actionbar: message;duration" (The duration must be in ticks, 20ticks = 1second)</td><td><code>actionbar: &#x26;6Starting conversation...;60</code></td></tr><tr><td><strong>remove_item</strong></td><td>Removes X amount of items from the player inventory. You can check the format <a href="#remove-item"><strong>HERE</strong></a>.</td><td><code>remove_item: DIAMOND;10</code></td></tr><tr><td><strong>firework</strong></td><td>Spawns a firework from the player location. You can check the format <a href="#undefined"><strong>HERE</strong></a>.</td><td><code>firework: colors:YELLOW,RED type:BALL fade:AQUA power:0</code></td></tr><tr><td><strong>wait</strong></td><td>Waits X amount of seconds before executing more actions.</td><td><code>wait: 2</code></td></tr><tr><td><strong>wait_ticks</strong></td><td>Waits X amount of ticks before executing more actions. (20ticks = 1 second)</td><td><code>wait_ticks: 10</code></td></tr><tr><td><strong>influence</strong></td><td>Sets, adds or removes influence from the current conversation entity for the player.</td><td><code>influence: set;5</code><br><code>influence: add;2</code><br><code>influence: remove;2</code></td></tr><tr><td><strong>send_to_server</strong></td><td>Sends the player to a bungee server.</td><td><pre><code><strong>send_to_server: lobby
</strong></code></pre></td></tr></tbody></table>

### Remove Item

This is the format for the **remove\_item** action:\
`remove_item: <type>;<amount>;datavalue: <datavalue>;name: <name>;lorecontains: <lore_line>`

{% hint style="warning" %}
Datavalue, name and lorecontains attributes are OPTIONAL. Don't use color formatting.
{% endhint %}

{% hint style="info" %}
You can find a list of valid types of items here:\
For latest versions:\
[https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html)\
For 1.8:\
[https://helpch.at/docs/1.8/org/bukkit/Material.html](https://helpch.at/docs/1.8/org/bukkit/Material.html)
{% endhint %}

You can also use the CheckItem expansion of PlaceholderAPI ([https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders#checkitem](https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders#checkitem)) to remove items, following this format:\
`remove_item: %checkitem_remove_,,<...>%`

{% tabs %}
{% tab title="Example 1" %}
```yaml
# This will remove x5 Diamonds from the player inventory.
remove_item: DIAMOND;5
```
{% endtab %}

{% tab title="Example 2" %}
```yaml
# This will remove x5 Diamonds named 'Unique Diamond' 
# from the player inventory.
remove_item: "DIAMOND;5;name: Unique Diamond"
```
{% endtab %}

{% tab title="Example 3" %}
```yaml
# This will remove x1 Coal Block named "Burst Turret"
# from the player inventory.
remove_item: "%checkitem_remove_mat:COAL_BLOCK,nameequals:&aBurst &6Turret,amt:1%"
```
{% endtab %}
{% endtabs %}

### Firework

This is the format for the **firework** action:\
`firework: colors:<color1>,<color2> type:<type> fade:<color1>,<color2> power:<power>`

{% hint style="warning" %}
The fade property is optional, the rest are necessary. You can add more than 2 colors.
{% endhint %}

{% hint style="info" %}
Firework Colors: [https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Color.html](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Color.html)\
Firework Types: [https://hub.spigotmc.org/javadocs/spigot/org/bukkit/FireworkEffect.Type.html](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/FireworkEffect.Type.html)
{% endhint %}

{% tabs %}
{% tab title="Example 1" %}
```yaml
firework: colors:YELLOW,RED type:BALL fade:AQUA power:0
```
{% endtab %}

{% tab title="Example 2" %}
```yaml
firework: colors:BLACK,WHITE type:BURST power:1
```
{% endtab %}
{% endtabs %}

