> 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/cai-dan/menus/actions.md).

# 菜单动作

静态按钮用 items.<符号>.actions，动态条目用 contents.<符号>.actions。支持直接 type 或具名子动作，按 YAML 顺序执行。click-actions.LEFT/RIGHT/SHIFT\_LEFT 等覆盖该点击的通用动作，空匹配节点禁止回退。条目动作需要对应点击对象。

| 类型                                              | 参数/行为                                               |
| ----------------------------------------------- | --------------------------------------------------- |
| `previous_page / next_page / refresh`           | 切换/刷新当前页。                                           |
| `close`                                         | 关闭背包。                                               |
| `open_menu`                                     | menu 默认 main，保留菜单权限绕过。                              |
| `open_categories`                               | 打开已启用分类选择页。                                         |
| `cycle_view`                                    | 循环配置的 view-filter.values，默认值取决于菜单。                  |
| `cycle_scroll_group`                            | 循环卷轴配置。                                             |
| `set_scroll_group`                              | group 为卷轴配置 ID 或 all。                               |
| `cycle_period_group`                            | 循环可用周期配置。                                           |
| `set_period_group`                              | group 为周期 ID 或 all。                                 |
| `cycle_challenge_group`                         | 循环挑战分组。                                             |
| `quest`                                         | 按条目状态接取、查看、领奖或打开成长详情。                               |
| `quest_info`                                    | 查看点击任务信息。                                           |
| `abandon_quest`                                 | 符合条件普通任务，confirm 默认 true，confirm-seconds 默认 5。      |
| `claim_all`                                     | 领取选中成长的全部可领奖阶段。                                     |
| `open_challenges`                               | 打开选中战令挑战。                                           |
| `message / action_bar / announcement`           | message 文案。                                         |
| `title`                                         | main-title、sub-title、fade-in、stay、fade-out。         |
| `sound`                                         | sound；volume/pitch 默认 1。                            |
| `particle`                                      | particle、count、offset-x/y/z、speed。                  |
| `effect`                                        | potion、duration（tick）、level；ambient/particles/icon。 |
| `console_command / player_command / op_command` | 不带斜线的 command。                                      |
| `command`                                       | command；as-console 默认 true。                         |
| `teleport`                                      | world、x、y、z，可选 yaw/pitch。                           |
| `entity_spawn`                                  | entity 和位置字段。                                       |
| `chance`                                        | rate 百分比和嵌套 actions。                                |
| `any`                                           | 嵌套 actions，amount 默认 1。                             |
| `delay`                                         | time 为 tick，嵌套 actions，执行时玩家需在线。                    |

[配置示例](/ultimatequest-zhong-wen-wen-dang/cai-dan/menus-1.md)。菜单权限绕过不会跳过任务/奖励校验。

## 完整动作参考

各动作参数、默认值、执行上下文和完整示例见[动作](/ultimatequest-zhong-wen-wen-dang/pei-zhi/actions.md)。