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

# 菜单类型

插件内置菜单位于 `plugins/UltimateQuest/menus/`。除 `settings.yml` 外，YAML 文件名就是菜单 ID，可以通过以下命令打开：

```
/uq menu <菜单ID>
```

菜单中的名称、描述、材质、布局和按钮均可修改。编辑后执行 `/uq reload` 即可重载。

查阅顺序：[内置菜单选项](/ultimatequest-zhong-wen-wen-dang/cai-dan/menus/builtin-options.md)说明每项设置和占位符；[自由菜单配置](/ultimatequest-zhong-wen-wen-dang/cai-dan/menus-1.md)提供布局示例；[菜单动作](/ultimatequest-zhong-wen-wen-dang/cai-dan/menus/actions.md)说明按钮的行为和参数。

## 内置菜单

| 菜单 ID        | 配置文件             | 用途                           | 打开方式                  |
| ------------ | ---------------- | ---------------------------- | --------------------- |
| `main`       | `main.yml`       | 浏览普通任务、接取任务、查看进度、领取奖励和放弃任务。  | `/uq`                 |
| `period`     | `period.yml`     | 查看自动分配的周期任务，可按周期配置筛选。        | `/uq period`          |
| `scroll`     | `scroll.yml`     | 查看携带的任务卷轴、目标进度，并将已完成卷轴兑换为奖励。 | `/uq scroll`          |
| `battlepass` | `battlepass.yml` | 浏览战令、等级奖励和挑战任务。              | `/uq battlepass [ID]` |
| `milestone`  | `milestone.yml`  | 浏览里程碑并领取已解锁的阶段奖励。            | `/uq milestone [ID]`  |

任务列表中，默认左键行为会随任务状态变化：接取可用任务、查看进行中的任务，或领取已完成任务的奖励。右键可以配置为放弃允许放弃的普通任务。这些点击行为都可以修改。

## 自由菜单

在 `menus/` 下直接新增一个 `.yml` 文件即可创建其他菜单。例如，`profile.yml` 可以通过 `/uq menu profile` 打开。

自由菜单可以包含静态按钮和动态任务列表。按钮可以打开菜单、翻页、切换筛选、执行命令或发送消息。完整示例见[自由菜单配置](/ultimatequest-zhong-wen-wen-dang/cai-dan/menus-1.md)。

## 权限和控制台命令

每个菜单都支持 `enabled` 和 `permission`。禁用的菜单无法打开；填写权限后，会检查打开菜单的玩家是否拥有该权限。玩家命令的基础权限为 `ultimatequest.use`。

控制台可以为在线玩家打开菜单：

```
uq menu main Steve
uq menu main Steve -b
```

`-b` 可以跳过菜单自身的权限检查，但不会跳过任务要求和领奖资格。详见[命令与权限](/ultimatequest-zhong-wen-wen-dang/ji-chu-xin-xi/commands-permissions.md)。

## 公共设置

`settings.yml` 不是可打开的菜单，用于保存所有菜单共用的设置：

| 配置项                 | 默认值    | 说明                       |
| ------------------- | ------ | ------------------------ |
| `anti-dupe-checker` | `true` | 启用 GUI 防复制检查，正常使用时请保持开启。 |

## 内容和翻译

主菜单读取 `tasks/`；周期任务使用 `periods/`；卷轴使用 `scrolls/`；战令和里程碑使用各自的配置文件夹。任务的 `icon` 提供默认菜单图标。菜单文本支持语言占位符、颜色，以及[内置菜单选项](/ultimatequest-zhong-wen-wen-dang/cai-dan/menus/builtin-options.md)中列出的动态占位符。