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

# 普通任务

普通任务由玩家主动接取，完成后领取一次奖励。一个任务可以包含多个目标，也可以要求先完成其他任务，或设置为只由管理员发放。玩家通过 `/uq` 浏览任务。

## 创建任务

创建 `tasks/<id>.yml`。玩家接取、完成所有目标，再领取一次奖励。例如：

```yaml
enabled: true
name: '{lang:defaults.tasks.forest_adventure.name}'
description:
- '{lang:defaults.tasks.forest_adventure.description}'
icon:
  material: IRON_AXE
categories:
- combat
- gathering
auto-claim: false
prerequisites:
- miner
objectives:
  hunter:
    source:
      quest: hunter
      amount: 10
  veteran:
    source:
      quest: veteran
      amount: 32
rewards:
  emerald:
    type: item
    item:
      material: EMERALD
      amount: 5
    display:
      name: '{lang:defaults.rewards.emerald_5}'
  bread:
    type: item
    item:
      material: BREAD
      amount: 8
    display:
      name: '{lang:defaults.rewards.bread_8}'
```

| 字段                          | 默认值/含义                                      |
| --------------------------- | ------------------------------------------- |
| `type`                      | `normal`，其他玩法使用自己的文件夹。                      |
| `name`、`description`、`icon` | 显示信息，description 为列表。                       |
| `categories`                | 显式分类 ID 列表，默认空。                             |
| `accept-mode`               | `player`，设为 `admin` 禁止自行接取。                 |
| `listed`                    | `true`，false 隐藏未派发任务。                       |
| `prerequisites`             | 必须已领奖的前置任务 ID。                              |
| `conditions`                | 接取条件，玩家状态使用 `target: PLAYER`。               |
| `auto-claim`                | `false`，完成时尝试自动领奖。                          |
| `starts-at`、`ends-at`       | 可选 ISO-8601 时间点，如 `'2026-11-01T00:00:00Z'`。 |
| `claim-grace-seconds`       | `0`，结束后的额外领奖秒数。                             |
| `paused`                    | `false`，暂停活动/领奖。                            |

根节点 source 简写单目标。管理员可用 `/uq accept <task> <player>` 派发隐藏/管理员任务。`-b` 跳过接取前置、条件和活动检查，仍检查名额与重复。

接取保存目标/已确定的奖励，不追溯接取前行为。完成由 `ACTIVE` 变为 `COMPLETED`，领奖成功变为 `CLAIMED`。完成仍占名额，放弃符合条件的普通任务会丢弃进度，见[名额](/ultimatequest-zhong-wen-wen-dang/gong-neng/task-limits.md)和[奖励](/ultimatequest-zhong-wen-wen-dang/pei-zhi/rewards.md)。