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

# 周期任务

周期任务会自动分配，并按设定时间刷新。可以用来制作每日、每周、每月或自定义周期的委托。玩家通过 `/uq period` 查看任务和领取奖励，无需逐项手动接取。

## 创建周期任务

`periods/<id>.yml` 定义从目标池自动分配的任务。每个抽中目标成为独立委托，`task` 提供分类、设置与每项奖励。

```yaml
enabled: true
name: '{lang:defaults.periods.daily.name}'
reset-mode: CRON
reset-time: 0 0 0 * * ?
claim-grace-seconds: 3600
source:
  pool: daily
  count: 3
task:
  auto-claim: false
  description:
  - '{lang:defaults.periods.daily.description}'
  - '{lang:defaults.periods.reward-note}'
  - '{lang:defaults.periods.claim-note}'
  rewards:
    supply:
      type: random
      pool: period_daily
      count: 3
      repeat: false
      display:
        name: '{lang:defaults.periods.daily-pack}'
```

周期结束停止累计，完成任务在 `claim-grace-seconds` 内可领奖，宽限不延长进度时间。生成按整批检查名额，不足时保留已有任务，之后使用固定抽取结果重试。

## 刷新格式

使用服务端 JVM 系统时区，战令轮换共用该解析器。

| 模式       | `reset-time`                                                                |
| -------- | --------------------------------------------------------------------------- |
| `CRON`   | 含秒的 Quartz Cron：每日 `'0 0 0 * * ?'`、每周 `'0 0 0 ? * MON'`、每月 `'0 0 0 1 * ?'`。 |
| `TIMED`  | 本地时间以 `;;` 分隔，如 `'00:00:00;;12:00:00'`。                                     |
| `TIMER`  | 正间隔 `[天:]时:分:秒`，如 `'1:00:00:00'`。                                           |
| `CUSTOM` | 本地结束日期 `yyyy-MM-dd HH:mm:ss`，`reset-anchor` 为开始。                            |

`reset-anchor` 默认 `'1970-01-01 00:00:00'`。可选 `starts-at`/`ends-at` 使用 ISO-8601 时间点限制活动范围，与本地刷新日期格式不同。`paused: true` 暂停，见[名额](/ultimatequest-zhong-wen-wen-dang/gong-neng/task-limits.md)。

周期也可用单个 source.trigger/source.amount 内联目标或 source.quest 模板替代目标池，每周期生成一项委托。