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

# Actions

Actions can be used when claiming a kit. More info [**HERE**](/playerkits-2/kits-tutorial.md#actions). 

## Message

Sends a message to the player.

```yaml
message: &aOpening the main menu

# Only if use_minimessage option is enabled in the config
message: <green>Opening the main menu
```

## Console Command

Executes a command from the console. Use `%player%` variable for player name. You can use PlaceholderAPI variables.

```yaml
console_command: eco take %player% 1500
```

## Player Command

Executes a command from the player. You can use PlaceholderAPI variables.

```yaml
player_command: spawn
```

## Play Sound

Plays a sound to the player. Use this format: `<sound>;<volume>;<pitch>`\
You can find a list of sounds here: \
Latest Versions: <https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html>\
Legacy Versions: <https://helpch.at/docs/1.8.8/index.html?org/bukkit/Sound.html>

```yaml
playsound: BLOCK_NOTE_BLOCK_PLING;10;0.1
```

## Play Sound Resource Pack

Plays a resource pack sound to the player. The format is the same as `playsound` action.

```yaml
playsound_resource_pack: scorpions:custom.my_custom_sound;10;1
```

## Actionbar

Sends an actionbar message to the player. Use this format: \
`"actionbar: message;duration"` (The duration must be in ticks, 20ticks = 1second)

```yaml
actionbar: &6Kit Claimed!;120
```

## Title

Sends a title and subtitle message to the player. Use this format: \
`"title: fadeIn;stay;fadeOut;title;subtitle"` (The duration of fadeIn, stay and fadeOut must be in ticks, 20ticks = 1second) If you want just a title, or just subtitle write "none".

```yaml
title: 20;40;20;&c&lDIAMOND KIT &cclaimed!;&7Enjoy your new kit.
```

## Firework

Spawns a firework from the player location. Use this format:\
`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>\
Firework Types: <https://hub.spigotmc.org/javadocs/spigot/org/bukkit/FireworkEffect.Type.html>
{% endhint %}

{% tabs %}
{% tab title="First Tab" %}

```yaml
firework: colors:YELLOW,RED type:BALL fade:AQUA power:0
```

{% endtab %}

{% tab title="Second Tab" %}

```yaml
firework: colors:BLACK,WHITE type:BURST power:1
```

{% endtab %}
{% endtabs %}

## Close Inventory

Closes the player inventory.

```yaml
close_inventory
```


---

# 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, and the optional `goal` query parameter:

```
GET https://ajneb97.gitbook.io/playerkits-2/actions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.