> For the complete documentation index, see [llms.txt](https://tchat.tect.host/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tchat.tect.host/general/actions.md).

# Actions

Actions are configurable operations that can be attached to certain modules. When triggered, the plugin executes the configured actions in the order they are defined. Actions can perform various tasks such as sending messages, playing sounds, applying effects, executing commands, modifying player data, and more.

***

## Messaging

#### \[MESSAGE]

Sends a chat message to the player.

```yml
actions:
- "[MESSAGE] &aWelcome to the server!"
```

#### \[BROADCAST]

Sends a message to all online players.

```yaml
actions:
- "[BROADCAST] &6A special event has started!"
```

## Debug

#### \[DEBUG]

Writes a message to the console log. You can specify the log level.

```yaml
actions:
- "[DEBUG] INFO Player joined the server"
- "[DEBUG] WARN Invalid configuration detected"
- "[DEBUG] WARNING Invalid configuration detected"
- "[DEBUG] SEVERE Database connection failed"
- "[DEBUG] ERROR Database connection failed"
- "[DEBUG] FINE Processing message from player %player_name%"
- "[DEBUG] DEBUG Processing message from player %player_name%"
```

## Visual

#### \[TITLE]

Displays a title and optional subtitle on the player's screen.

Format: title;subtitle

```yaml
actions:
- "[TITLE] &aWelcome!;&7Enjoy your stay."
```

#### \[ACTION\_BAR]

Displays a message in the player's action bar.

```yaml
actions:
- "[ACTION_BAR] &eYou are in a safe zone."
```

## Commands

#### \[PLAYER\_COMMAND]

Executes a command as the player.

```yaml
actions:
- "[PLAYER_COMMAND] spawn"
- "[PLAYER_COMMAND] kit starter"
```

#### \[CONSOLE\_COMMAND]

Executes a command from the server console.

```yaml
actions:
- "[CONSOLE_COMMAND] give %player_name% diamond 1"
```

## World

#### \[SOUND]

Plays a Minecraft sound for the player.

```yaml
actions:
- "[SOUND] entity_player_levelup"
```

#### \[PARTICLE]

Spawns particles at the player's location.

```yaml
actions:
- "[PARTICLE] flame"
```

#### \[TELEPORT]

Teleports the player to a specific location.

Format: world;x;y;z

```yaml
actions:
- "[TELEPORT] world;100;64;200"
```

## Inventory

#### \[INVENTORY]

Modifies the player's inventory.

* ADD
  * Adds items to the player's inventory.
* REMOVE
  * Removes items from the player's inventory.
* CHANGE
  * Removes one item and gives another.

```yaml
actions:
- "[INVENTORY] ADD DIAMOND 5"
- "[INVENTORY] REMOVE DIAMOND 5"
- "[INVENTORY] CHANGE COAL 10 DIAMOND 1"
```

## Potion Effects

#### \[POTION\_EFFECT]

Adds or removes potion effects.

Format: TYPE:duration:amplifier

* ADD
  * Applies a potion effect.
* REMOVE
  * Removes a potion effect.

```yaml
actions:
- "[POTION_EFFECT] ADD SPEED:1200:1"
- "[POTION_EFFECT] ADD REGENERATION:200:2"
- "[POTION_EFFECT] REMOVE SPEED"
```