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

# 任务卷轴

任务卷轴是一件带有目标和奖励的实体物品。玩家携带卷轴完成目标，再通过 `/uq scroll` 将已完成的卷轴兑换成奖励。可以通过其他任务奖励、活动或管理命令发放卷轴。

## 创建卷轴

`scrolls/<profile>.yml` 生成绑定存储记录的物品。固定 `tasks` 与根节点 `source`（内联/模板/池）合并为一个任务，全部完成后通过 `/uq scroll` 领奖并消耗卷轴。默认示例：

```yaml
enabled: true
name: '{lang:defaults.scrolls.novice.name}'
description:
- '{lang:defaults.scrolls.carry}'
- '{lang:defaults.scrolls.novice.duration}'
- '{lang:defaults.scrolls.reward-note}'
- '{lang:defaults.scrolls.claim}'
categories:
- adventure
item:
  material: MAP
  lore:
  - '{lang:defaults.scrolls.carry}'
  - '{lang:defaults.scrolls.novice.duration}'
  - '{lang:defaults.scrolls.reward-note}'
  - '{lang:defaults.scrolls.claim}'
icon:
  material: MAP
source:
  pool: daily
  count: 1
tasks:
  required_veteran:
    source:
      quest: veteran
      amount: 8
duration-seconds: 86400
rarity: common
difficulty: easy
rewards:
  supply:
    type: random
    pool: scroll_novice
    count: 3
    repeat: false
    display:
      name: '{lang:defaults.rewards.scroll_pack_novice}'
```

通过 `/uq scroll give <online-player> <profile> [rarity] [difficulty]` 发放，需要 `ultimatequest.admin`。item 控制实体物品，icon 控制菜单图标。可选 `rarities`/`difficulties` 为正整数权重映射，未指定时抽取，指定值必须存在于映射；无映射使用标量标签。标签本身不放大数量/奖励。

背包/副手携带时统计，移出暂停进度，激活后到期时间仍继续流逝。`duration-seconds` 为非负整数，省略/0 表示不限时。有效期在首次激活建立，之后随保存实例恢复。目标和奖励定义在发放时固定，随机结果在玩家首次携带并激活卷轴时抽取，之后重新登录或重载不会重新抽取。

无论目标数，一张卷轴只占一个名额，激活检查[名额](/ultimatequest-zhong-wen-wen-dang/gong-neng/task-limits.md)。只有名称/lore、没有匹配存储记录的物品不能成为新有效卷轴。

## 发放卷轴

```
/uq scroll give Steve novice
```

此命令按照 `scrolls/novice.yml` 向在线玩家 Steve 发放一张卷轴，需要 `ultimatequest.admin` 权限，也可以由控制台执行。请将 `novice` 替换成你的卷轴配置文件名，不带 `.yml`。

玩家携带卷轴完成目标后，通过 `/uq scroll` 查看进度和领奖。包含多个目标的卷轴需要全部完成才能兑换奖励。