# Types

### Action Format

To add actions to the totem, you must use the format of a list, e.g.

```yaml
actions:
  - action1
  - action2
  - action3
```

Actions must be written like this `<action>: <content>` to work correctly. See action list for examples

### Action List

<table data-view="cards"><thead><tr><th>Action</th><th></th></tr></thead><tbody><tr><td><strong>Action Bar</strong></td><td>Send an action bar to the player</td></tr><tr><td><strong>Bossbar</strong></td><td>Send a bossbar to the player</td></tr><tr><td><strong>Broadcast</strong></td><td>Send a broadcast to the server</td></tr><tr><td><strong>Command</strong></td><td>Execute a command as the player</td></tr><tr><td><strong>Console</strong></td><td>Execute a command in the console</td></tr><tr><td><strong>Effect</strong></td><td>Send an entity effect to the player</td></tr><tr><td><strong>Fire</strong></td><td>Sets the player on fire</td></tr><tr><td><strong>Frozen</strong></td><td>Freezes player</td></tr><tr><td><strong>Message</strong></td><td>Send a message to the player</td></tr><tr><td><strong>Particle</strong></td><td>Spawn particles at player's location</td></tr><tr><td><strong>Sound</strong></td><td>Play a sound</td></tr><tr><td><strong>Title</strong></td><td>Send a title to the player</td></tr><tr><td><strong>Lang</strong></td><td>Send a language message (You can add your own message to the language file)</td></tr><tr><td><strong>MiniMessage</strong></td><td>Send a message with the mini message format</td></tr></tbody></table>

<details>

<summary>Examples</summary>

#### () = optional, <> = required

#### [Action Bar](https://i.imgur.com/mW7zyfL.mp4)

```yaml
# actionbar: <text>
actionbar: &6You have used the Example Totem!
```

#### [Boss Bar](https://i.imgur.com/f5tWCQw.mp4)

```yaml
# bossbar: <text> | <color> | <style> | (duration)
bossbar: &6Example Totem | BLUE | SOLID | 5
```

#### [Broadcast](https://i.imgur.com/PqeoUhH.mp4)

```yaml
# broadcast: <text>
broadcast: &6{player} has used the Example Totem!
```

#### [Command](https://i.imgur.com/iKbAm4F.mp4)

```yaml
# command: <text>
command: gamemode creative
```

#### [Console](https://i.imgur.com/zzpHcIq.mp4)

```yaml
# console: <text>
console: gamemode creative {player}
```

#### [Effect](https://i.imgur.com/aE2VM12.mp4)

```yaml
# effect: <text>
effect: TELEPORT_ENDER
```

#### [Fire](https://i.imgur.com/DP3By19.mp4)

```yaml
# fire: <duration>
fire: 5
```

#### [Frozen](https://i.imgur.com/32m8BD3.mp4)

```yaml
# frozen: <duration>
frozen: 5
```

#### [Message](https://i.imgur.com/W69SPV4.mp4)

```yaml
# message: <text>
message: &6You have used the Example Totem!
```

#### [Particle](https://i.imgur.com/wqGM4AC.mp4)

```yaml
# particle: <particle> | <amount> | <X> | <Y> | <Z> | <Speed>
particle: DAMAGE_INDICATOR | 100| 0 | 1 | 0 | 0.3
```

#### [Sound](https://i.imgur.com/rWFsYzO.mp4)

```yaml
# sound: <sound>-<volume>-<pitch>
sound: ENTITY_VILLAGER_YES-1-1
```

#### [Title](https://i.imgur.com/mlT4cwW.mp4)

```yaml
# title: <title> | <subtitle> | (fadeIn) | (fadeOut) | (stay)
title: &6Example Totem | &7You have used the Example Totem!
```

#### [Lang](https://i.imgur.com/0PqozcA.mp4)

```yaml
# lang: <string>
lang: Totem-Chance-Failed
```

#### [Mini Message](https://i.imgur.com/025n5si.mp4)

```yaml
# minimessage: <text>
minimessage: <gold>You have used the Example Totem!</gold>
```

</details>

### Useful Links

* [Entity Effects](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/EntityEffect.html)
* [Mini Message](https://docs.adventure.kyori.net/minimessage/format.html)


---

# Agent Instructions: 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:

```
GET https://plupport.gitbook.io/plutotems/features/actions/types.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
