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

# 奖励池与引用

奖励池复用加权选项映射，reward-library 复用单条完整奖励，两者都不是目标池。

## 奖励池文件

创建 reward-pools/supplies.yml：

```yaml
enabled: true
rewards:
  food:
    rate: 70
    rewards:
      bread:
        type: item
        item: {material: BREAD, amount: 8}
  mineral:
    rate: 30
    rewards:
      iron:
        type: item
        item: {material: IRON_INGOT, amount: 4}
```

在任务/卷轴/阶段引用：

```yaml
rewards:
  supply:
    type: random
    pool: supplies
    count: 1
    repeat: false
```

ID 使用小写字母、数字、下划线或短横线，读取直接子级 .yml，禁用池不可引用。校验前将池选项展开到 random，不能同时配置 pool 和 random。count/repeat 保留在消费奖励条目上。

## 单条奖励库

config.yml 的 reward-library. 可定义完整奖励。reference: 替换整个条目，包括引用节点的其他字段，不合并覆盖。递归展开池/奖励库，缺失、循环或过深引用拒绝加载。

## 重载与编辑器

/uq editor reward-pool 编辑选项。定义重载校验所有启用奖励池及使用方，编辑池不会重抽已有实例奖励定义和已解锁已解锁的阶段奖励，见[随机奖励](/ultimatequest-zhong-wen-wen-dang/pei-zhi/rewards/random.md)。