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

# 任务分类

分类为单层、多选。在 `categories/<id>.yml` 创建：

```yaml
enabled: true
name: '{lang:defaults.categories.combat.name}'
description:
- '{lang:defaults.categories.combat.description}'
icon:
  material: IRON_SWORD
order: 10
```

普通任务、卷轴、战令目录、里程碑根节点用 `categories: [combat, gathering]`，挑战用 `tasks.<id>.categories`，周期用 task.categories。目标模板不继承分类。未设/空列表归入 uncategorized；all、uncategorized 为保留 ID。

按 order 升序再按 ID 排序，重复引用去重。未知 ID/非法类型拒绝定义重载并保留原定义。禁用分类不显示入口，任务仍在“全部”中显示。

普通任务/战令取当前分类定义，生成的周期/卷轴保留快照。多分类分别计入各分类限制，类型总数只计一次。

菜单启用 category-filter.enabled 并提供 open\_categories 动作。默认值来自 `config.yml -> category-menu`，各菜单 category-filter 可覆盖 title、layout、item、selected-item、empty-item、items。布局 Q 为分类槽，P/N 翻页，B 返回，C 关闭。

卡片支持 `{category-id}`、`{category-name}`、`{category-description}`、`{category-count}`、`{category-active}`、`{category-claimable}`、`{category-selected}`；任务卡支持 `{categories}`。内容区固定 categories 与玩家选择取交集，可组合状态筛选，切换分类重置页码，返回保留筛选。

`/uq editor category` 编辑分类，任务编辑器提供多选草稿，周期根节点编辑 task.categories，验证后应用。见[菜单](/ultimatequest-zhong-wen-wen-dang/cai-dan/menus-1.md)和[名额](/ultimatequest-zhong-wen-wen-dang/gong-neng/task-limits.md)。

## 🫥 空分类入口

category-filter.hide-empty 默认 false，开启后移除零数量分类入口。默认 main、scroll 开启。全部入口保留，统计范围跟随当前内容/配置分组筛选，重复内容区内同一任务去重。