> 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/ultimatequest-zhong-wen-wen-dang/pei-zhi/actions.md).

# 动作

动作是菜单按钮和动态内容使用的执行条目。本参考按类型说明 UltimateQuest 实际动作注册表中的参数、默认值、执行上下文和示例。

## 参考页面

* [✨ 文本与视觉动作](/ultimatequest-zhong-wen-wen-dang/pei-zhi/actions/fundamentals.md)
* [🔌 命令与世界动作](/ultimatequest-zhong-wen-wen-dang/pei-zhi/actions/commands-world.md)
* [🧩 控制流动作](/ultimatequest-zhong-wen-wen-dang/pei-zhi/actions/orchestration.md)
* [🧭 菜单导航动作](/ultimatequest-zhong-wen-wen-dang/pei-zhi/actions/navigation.md)
* [📜 任务与领奖动作](/ultimatequest-zhong-wen-wen-dang/pei-zhi/actions/quests.md)

## 公共格式

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

单动作可直接在 actions 下写 type，多项具名动作按 YAML 顺序运行。注册表标准化大小写/短横线。每项动作先检查必填字段；基类不自动提供每条 conditions/chance/cooldown 字段，应使用支持的条件位置或 chance 包装。

## 配置位置与点击方式

items.<符号>.actions 配静态按钮，contents.<符号>.actions 配动态条目。click-actions.LEFT/RIGHT/SHIFT\_LEFT 等替代该点击的通用动作，显式空匹配节点禁止回退。任务动作需要条目或选中成长上下文。

## 动作与奖励

奖励只允许 item、console\_command、message、battlepass-experience、random。sound/title/菜单动作不会自动成为合法奖励类型。随机动作在点击时执行，随机奖励则抽取到实例/已解锁的阶段奖励。

## 类型索引

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