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

# 里程碑

里程碑用于奖励长期积累，例如累计挖掘方块或击杀怪物。玩家无需接取，符合要求的行为会自动累计，达到各阶段后解锁对应奖励。使用 `/uq milestone` 查看进度和领奖。

## 创建里程碑

`milestones/<id>.yml` 无需接取即可累计。sources 定义贡献，stages 定义累计门槛/奖励。

```yaml
enabled: true
name: '{lang:defaults.milestones.mining.name}'
description:
- '{lang:defaults.milestones.description}'
icon:
  material: IRON_PICKAXE
categories:
- gathering
sources:
  stone:
    source:
      quest: miner
    value: 1
stages:
  '1':
    required: 64
    rewards:
      emerald:
        type: item
        item:
          material: EMERALD
          amount: 2
        display:
          name: '{lang:defaults.rewards.emerald_2}'
  '2':
    required: 256
    rewards:
      experience_bottle:
        type: item
        item:
          material: EXPERIENCE_BOTTLE
          amount: 6
        display:
          name: '{lang:defaults.rewards.experience_bottle_6}'
  '3':
    required: 1024
    rewards:
      emerald:
        type: item
        item:
          material: EMERALD
          amount: 8
        display:
          name: '{lang:defaults.rewards.emerald_8}'
  '4':
    required: 4096
    rewards:
      diamond:
        type: item
        item:
          material: DIAMOND
          amount: 2
        display:
          name: '{lang:defaults.rewards.diamond_2}'
  '5':
    required: 16384
    rewards:
      diamond:
        type: item
        item:
          material: DIAMOND
          amount: 4
        display:
          name: '{lang:defaults.rewards.diamond_4}'
      experience_bottle:
        type: item
        item:
          material: EXPERIENCE_BOTTLE
          amount: 16
        display:
          name: '{lang:defaults.rewards.experience_bottle_16}'
      scroll:
        type: console_command
        command: uq scroll give {player} veteran
        display:
          name: '{lang:defaults.rewards.scroll_veteran}'
```

来源使用内联/模板目标格式，正整数 value（默认 1）为每次匹配事件贡献。普通 amount 不作为阶段门槛；钓鱼 count: items 乘以物品堆数量，多个匹配来源可同时贡献。

阶段从 1 连续编号，required 为严格递增正整数。内部轨道为 default，配置写在 `stages.<等级>.rewards`。随机奖励在解锁时固定。用 `/uq milestone <id>` 打开，`/uq milestone claim <id> <stage>` 或 claimall 领取。

未设置赛季时永久累计，可选合法 season 隔离保存进度。时间窗口、宽限、paused、auto-claim、图标和分类共用成长字段，奖励容器不占任务名额。