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

# 自由菜单配置

menus/ 直接子级 .yml 文件名为菜单 ID，通过 `/uq menu <id>` 打开。enabled 默认 true，permission 默认空；禁用菜单不能打开，控制台 -b 可跳过菜单权限。文案支持语言变量和颜色。

layout 为 1–6 行，每行 9 个符号；每个符号对应 contents 内容区或 items 静态按钮，重复符号分配多个位置。该布局不使用条目 slot/slots 字段。例如：

```yaml
enabled: true
permission: ultimatequest.use
title: '&8Quests {page}/{pages}'
layout:
- FFFFFFFFF
- FQQQQQQQF
- PKFFCRFFN
category-filter:
  enabled: true
contents:
  Q:
    type: quests
    filterable: true
    sort: actionable
    use-quest-icon: true
    item:
      name: '&a{name}'
      lore: ['{objectives}', '{rewards}', '{hint}']
    click-actions:
      LEFT:
        type: quest
      RIGHT:
        type: abandon_quest
        confirm: true
        confirm-seconds: 5
items:
  F:
    item: {material: BLACK_STAINED_GLASS_PANE, name: ' '}
  P:
    item: {material: ARROW, name: '&ePrevious'}
    actions: {type: previous_page}
  N:
    item: {material: ARROW, name: '&eNext'}
    actions: {type: next_page}
  K:
    category-button: true
    item: {material: CHEST, name: '&eCategories'}
    actions: {type: open_categories}
  R:
    item: {material: COMPASS, name: '&eRefresh'}
    actions: {type: refresh}
  C:
    item: {material: BARRIER, name: '&cClose'}
    actions: {type: close}
```

内容类型：quests（普通任务）、period、scroll、challenge、battlepass、milestone。include/exclude 筛选定义 ID，categories 固定分类范围，filterable 开启状态筛选。sort: actionable 优先可操作项，natural 使用普通顺序。use-quest-icon 默认 true；保留定义图标应省略 item.material。

战令/里程碑目录与详情使用 catalog-title/catalog-layout、detail-title/detail-layout；战令另有 challenge-title/challenge-layout。contents.<符号>.display 限制 catalog/detail/challenges 视图，track 筛选 free/premium/default 阶段。目录使用 catalog-item，其他条目使用对应 state-items，缺省回退 item。

state-items.<状态> 覆盖外观，empty-item/empty-slot 控制空区域提示。静态按钮支持 hide-on-first-page、hide-on-last-page、hidden-item、view-items.、category-button。见[菜单选项](/ultimatequest-zhong-wen-wen-dang/cai-dan/menus/builtin-options.md)、[动作](/ultimatequest-zhong-wen-wen-dang/cai-dan/menus/actions.md)、[分类](/ultimatequest-zhong-wen-wen-dang/pei-zhi/categories.md)。

## 周期分组筛选

period 菜单 period-filter.enabled 默认 true。period-filter.groups 可将列表限制为现有配置 ID 加 all；省略时包含启用配置和已分配分组。cycle\_period\_group 循环切换，set\_period\_group 用 group 字段指定分组。items.<符号>.period-items. 可按所选分组定义按钮，{period-id} 为 ID，{period-group} 为本地化名称，可与分类/状态筛选组合。

## 🎛️ 状态与卷轴筛选

view-filter.values 控制合法状态选项及顺序，scroll-filter.enabled/groups 控制卷轴配置筛选。静态分组按钮支持 scroll-button 与 scroll-items.<配置>，category-filter.hide-empty 可隐藏零数量分类。当前默认值见[逐文件参考](/ultimatequest-zhong-wen-wen-dang/cai-dan/menus/builtin-options.md)，动作见[导航动作](/ultimatequest-zhong-wen-wen-dang/pei-zhi/actions/navigation.md)。