> For the complete documentation index, see [llms.txt](https://enchantedmobs.superiormc.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://enchantedmobs.superiormc.cn/for-ultimatequest/configuration/actions/fundamentals.md).

# Text and Visual Actions

Configure these entries under a menu button/entry actions node. See the [common action format](/for-ultimatequest/configuration/actions.md).

## `message`

Sends chat text to the clicking player.

| Field     | Default  | Description   |
| --------- | -------- | ------------- |
| `message` | Required | Text to send. |

```yaml
type: message
message: '&aHello {player}.'
```

Language/text placeholders depend on the action context.

## `action_bar`

Sends text above the hotbar.

| Field     | Default  | Description      |
| --------- | -------- | ---------------- |
| `message` | Required | Action-bar text. |

```yaml
type: action_bar
message: '&e{claimable} rewards ready.'
```

## `announcement`

Sends a chat announcement to online players.

| Field     | Default  | Description        |
| --------- | -------- | ------------------ |
| `message` | Required | Announcement text. |

```yaml
type: announcement
message: '&e{player} is viewing quests.'
```

Text is parsed using the acting player/context before delivery.

## `title`

Displays a title and subtitle.

| Field        | Default  | Description     |
| ------------ | -------- | --------------- |
| `main-title` | Required | Main text.      |
| `sub-title`  | Required | Subtitle text.  |
| `fade-in`    | Required | Fade-in ticks.  |
| `stay`       | Required | Display ticks.  |
| `fade-out`   | Required | Fade-out ticks. |

```yaml
type: title
main-title: '&aQuests'
sub-title: '&7Choose a task'
fade-in: 10
stay: 40
fade-out: 10
```

All timing fields are required, even if zero.

## `sound`

Plays a sound at the player location.

| Field    | Default  | Description     |
| -------- | -------- | --------------- |
| `sound`  | Required | Sound key/name. |
| `volume` | 1        | Volume.         |
| `pitch`  | 1        | Pitch.          |

```yaml
type: sound
sound: minecraft:entity.player.levelup
volume: 1
pitch: 1
```

## `particle`

Spawns particles one block above the player.

| Field                            | Default  | Description                     |
| -------------------------------- | -------- | ------------------------------- |
| `particle`                       | Required | Server particle name.           |
| `count`                          | Required | Particle count.                 |
| `offset-x / offset-y / offset-z` | Required | Three spread components.        |
| `speed`                          | Required | Particle extra/speed parameter. |

```yaml
type: particle
particle: HAPPY_VILLAGER
count: 8
offset-x: 0.3
offset-y: 0.3
offset-z: 0.3
speed: 0
```

Particle names/data requirements depend on the server version.

## `effect`

Applies a potion effect to the player.

| Field                        | Default  | Description                   |
| ---------------------------- | -------- | ----------------------------- |
| `potion`                     | Required | Registered potion-effect key. |
| `duration`                   | Required | Duration in ticks.            |
| `level`                      | Required | Zero-based amplifier.         |
| `ambient / particles / icon` | true     | Display flags.                |

```yaml
type: effect
potion: minecraft:speed
duration: 200
level: 0
particles: true
```

level: 0 means level I.