> 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.md).

# Actions

Actions are the reusable execution entries used by menu buttons and dynamic content. The reference documents the action registry present in UltimateQuest, with parameters, defaults, execution context, and examples for each type.

## Reference pages

* [✨ Text and visual actions](/for-ultimatequest/configuration/actions/fundamentals.md)
* [🔌 Commands and world actions](/for-ultimatequest/configuration/actions/commands-world.md)
* [🧩 Control-flow actions](/for-ultimatequest/configuration/actions/orchestration.md)
* [🧭 Menu navigation actions](/for-ultimatequest/configuration/actions/navigation.md)
* [📜 Quest and reward actions](/for-ultimatequest/configuration/actions/quests.md)

## Common format

```yaml
items:
  R:
    item:
      material: COMPASS
      name: '&eRefresh'
    actions:
      reload_view:
        type: refresh
      feedback:
        type: sound
        sound: minecraft:ui.button.click
```

A single action may put type directly under actions; multiple named actions run in YAML order. Registry lookup normalizes case and hyphens. Each action checks its required fields before running. The base action does not automatically implement per-entry conditions/chance/cooldown fields: use supported condition locations or the chance wrapper.

## Click routing

items..actions configures static buttons; contents..actions configures dynamic entries. click-actions.LEFT/RIGHT/SHIFT\_LEFT etc. overrides the general action mapping for that click. An explicitly empty matching section suppresses the fallback. Quest-entry actions need a selected entry or progression context.

## Actions and rewards

Reward validation accepts only item, console\_command, message, battlepass-experience, random. A sound/title/menu action is not automatically a valid reward type. Random actions execute at click time; random rewards are drawn into instance/stage snapshots.

## Type index

| Type                    | Reference                                                                                               |
| ----------------------- | ------------------------------------------------------------------------------------------------------- |
| `message`               | [message](/for-ultimatequest/configuration/actions/fundamentals.md#message)                             |
| `action_bar`            | [action\_bar](/for-ultimatequest/configuration/actions/fundamentals.md#action_bar)                      |
| `announcement`          | [announcement](/for-ultimatequest/configuration/actions/fundamentals.md#announcement)                   |
| `title`                 | [title](/for-ultimatequest/configuration/actions/fundamentals.md#title)                                 |
| `sound`                 | [sound](/for-ultimatequest/configuration/actions/fundamentals.md#sound)                                 |
| `particle`              | [particle](/for-ultimatequest/configuration/actions/fundamentals.md#particle)                           |
| `effect`                | [effect](/for-ultimatequest/configuration/actions/fundamentals.md#effect)                               |
| `console_command`       | [console\_command](/for-ultimatequest/configuration/actions/commands-world.md#console_command)          |
| `player_command`        | [player\_command](/for-ultimatequest/configuration/actions/commands-world.md#player_command)            |
| `op_command`            | [op\_command](/for-ultimatequest/configuration/actions/commands-world.md#op_command)                    |
| `command`               | [command](/for-ultimatequest/configuration/actions/commands-world.md#command)                           |
| `teleport`              | [teleport](/for-ultimatequest/configuration/actions/commands-world.md#teleport)                         |
| `entity_spawn`          | [entity\_spawn](/for-ultimatequest/configuration/actions/commands-world.md#entity_spawn)                |
| `chance`                | [chance](/for-ultimatequest/configuration/actions/orchestration.md#chance)                              |
| `any`                   | [any](/for-ultimatequest/configuration/actions/orchestration.md#any)                                    |
| `delay`                 | [delay](/for-ultimatequest/configuration/actions/orchestration.md#delay)                                |
| `previous_page`         | [previous\_page](/for-ultimatequest/configuration/actions/navigation.md#previous_page)                  |
| `next_page`             | [next\_page](/for-ultimatequest/configuration/actions/navigation.md#next_page)                          |
| `refresh`               | [refresh](/for-ultimatequest/configuration/actions/navigation.md#refresh)                               |
| `close`                 | [close](/for-ultimatequest/configuration/actions/navigation.md#close)                                   |
| `open_menu`             | [open\_menu](/for-ultimatequest/configuration/actions/navigation.md#open_menu)                          |
| `open_categories`       | [open\_categories](/for-ultimatequest/configuration/actions/navigation.md#open_categories)              |
| `cycle_view`            | [cycle\_view](/for-ultimatequest/configuration/actions/navigation.md#cycle_view)                        |
| `cycle_challenge_group` | [cycle\_challenge\_group](/for-ultimatequest/configuration/actions/navigation.md#cycle_challenge_group) |
| `cycle_period_group`    | [cycle\_period\_group](/for-ultimatequest/configuration/actions/navigation.md#cycle_period_group)       |
| `set_period_group`      | [set\_period\_group](/for-ultimatequest/configuration/actions/navigation.md#set_period_group)           |
| `quest`                 | [quest](/for-ultimatequest/configuration/actions/quests.md#quest)                                       |
| `quest_info`            | [quest\_info](/for-ultimatequest/configuration/actions/quests.md#quest_info)                            |
| `abandon_quest`         | [abandon\_quest](/for-ultimatequest/configuration/actions/quests.md#abandon_quest)                      |
| `claim_all`             | [claim\_all](/for-ultimatequest/configuration/actions/quests.md#claim_all)                              |
| `open_challenges`       | [open\_challenges](/for-ultimatequest/configuration/actions/quests.md#open_challenges)                  |
| `cycle_scroll_group`    | [cycle\_scroll\_group](/for-ultimatequest/configuration/actions/navigation.md#cycle_scroll_group)       |
| `set_scroll_group`      | [set\_scroll\_group](/for-ultimatequest/configuration/actions/navigation.md#set_scroll_group)           |