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

# Normal Tasks

Normal tasks are accepted by the player and completed once. You can combine several objectives, require earlier tasks, hide administrative tasks, and give rewards after completion. Players use `/uq` to browse tasks.

## Creating a task

Create `tasks/<id>.yml`. Players accept, complete all objectives, then claim once. Example:

```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}'
```

| Field                         | Default / meaning                                                    |
| ----------------------------- | -------------------------------------------------------------------- |
| `type`                        | `normal`; other gameplay types use their own folders.                |
| `name`, `description`, `icon` | Display metadata; description is a list.                             |
| `categories`                  | Explicit category ID list, empty by default.                         |
| `accept-mode`                 | `player`; `admin` disables self-acceptance.                          |
| `listed`                      | `true`; false hides unassigned tasks.                                |
| `prerequisites`               | Task IDs whose rewards must already be claimed.                      |
| `conditions`                  | Acceptance conditions; use `target: PLAYER` for player-state checks. |
| `auto-claim`                  | `false`; attempt claiming on completion.                             |
| `starts-at`, `ends-at`        | Optional ISO-8601 instants, e.g. `'2026-11-01T00:00:00Z'`.           |
| `claim-grace-seconds`         | `0`; extra claiming time after the end.                              |
| `paused`                      | `false`; pause activity/claiming.                                    |

Root `source` is shorthand for one objective. Administrators can dispatch hidden/admin-only tasks with `/uq accept <task> <player>`. `-b` skips acceptance prerequisites, conditions, and activity checks; slots and duplicate rules remain.

Acceptance stores resolved objectives/rewards. Prior actions are not retroactive. Completion changes `ACTIVE` to `COMPLETED`; successful claiming changes it to `CLAIMED`. Completed tasks still occupy slots. Abandoning an eligible normal task discards its progress. See [limits](/for-ultimatequest/features/task-limits.md) and [rewards](/for-ultimatequest/configuration/rewards.md).