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

# 战令

战令提供按赛季进行的成长玩法。玩家完成挑战获得积分，提升等级后领取免费或高级奖励。使用 `/uq battlepass` 浏览战令，选择战令后查看等级奖励和挑战。

## 创建战令

创建 `battlepasses/<id>.yml`。战令含赛季、累计积分、自动分配挑战和免费/高级等级轨道。示例（元数据与任务/奖励段属于同一文件）：

```yaml
enabled: true
name: '{lang:defaults.battlepasses.example.name}'
categories:
- adventure
season: season_1
season-name: '{lang:defaults.battlepasses.example.season-name}'
season-prefix: expedition
rotation:
  enabled: true
  reset-mode: CRON
  reset-time: 0 0 0 1 * ?
premium-by-permission: true
premium-permission: ultimatequest.battlepass.example.premium
cap-experience: true
claim-grace-seconds: 604800
auto-claim: false
paused: false
leveling:
  count: 30
  base: 100
  increment: 10
  multiplier: 1.0
```

```yaml
tasks:
  stone:
    points: 25
    group: daily
    reset: daily
    categories: [gathering]
    unlock-week: 1
    catch-up: true
    premium: false
    source: {quest: miner, amount: 64}
levels:
  '1':
    free:
      food:
        type: item
        item: {material: BREAD, amount: 8}
    premium:
      gem:
        type: item
        item: {material: DIAMOND, amount: 1}
```

## 挑战与等级

每个 `tasks.<id>` 需要正整数 points 和普通 source/objectives。挑战分类独立于战令目录分类。reset 为 daily/weekly/season，默认取 group，未设置则取 season。group/group-name 控制浏览。unlock-week 从 1 开始；catch-up: true 允许后续补做，false 仅限解锁周。premium: true 的挑战需要高级资格。

完成自动结算积分，挑战占 battlepass-task 名额，奖励轨道容器不占名额。按配置顺序分配，释放名额后重试。

`levels.<等级>.required` 是严格递增累计门槛，从 1 连续编号。也可用 leveling，每级增加 `ceil((base + increment * (level - 1)) * multiplier^(level - 1))`。count 为 1–10000，base 正数，increment 非负，multiplier 至少 1 且有限。显式门槛覆盖生成值。cap-experience: true 将积分限制到最终门槛。

高级资格来自管理员持久化授予，或 premium-by-permission 开启时的配置权限。auto-claim 尝试领取符合条件阶段。时间窗口、暂停和领奖宽限均生效。随机阶段奖励在解锁时固定。

## 赛季与倍率

轮换使用[刷新格式](/ultimatequest-zhong-wen-wen-dang/pei-zhi/periods.md)，由 season-prefix 和周期起点生成赛季 ID，首次安装进入当前日历周期。保存赛季用 `<id>@<season>` 打开，结束后停止累计并保留领奖宽限。

```
/uq battlepass season pause example
/uq battlepass season resume example
/uq battlepass season end example
/uq battlepass season start example season_2 2592000
/uq battlepass season schedule example season_3 2026-11-01T00:00:00Z 2026-12-01T00:00:00Z
/uq battlepass season globalboost example 2 3600
```

手动 start/schedule/end 关闭轮换。玩家、全服和权限倍率取最大值，不相乘。权限倍率配置为 `permission-boosters.<id>.permission` 和 `.multiplier`，见[命令](/ultimatequest-zhong-wen-wen-dang/ji-chu-xin-xi/commands-permissions.md)和[奖励](/ultimatequest-zhong-wen-wen-dang/pei-zhi/rewards.md)。