# 任务与成就：原作设计与规则

版本：HEROLL 2.0.1 原作还原文档 v1.0。

## 1. 功能定位

任务描述玩家要完成的目标，任务组决定目标数量和奖励；成就则可通过前置链逐步开放。一个条件模板可以被活动或通行证复用，不应重复定义事件语义。

## 2. 主要状态

下面是开发阅读所需的概念状态，属于开发映射，不要求与原作内部字段同名。

| 状态 | 用途 |
| --- | --- |
| 任务实例与所属组 | 区分同模板的多个目标 |
| 当前计数 | 保存目标进度 |
| 开放状态 | 决定是否展示与是否计数 |
| 领奖状态 | 区分完成与已领取 |
| 成就前置状态 | 连接前置链 |

## 3. 功能规则

### 3.1 任务条件

任务定义表给事件类型、条件键及附加参数。任务组引用该定义后再设置目标次数、领取类型及奖励；“目标完成”与“领取奖励”是两项状态。

### 3.2 锁定时计数

任务组有锁定时是否允许累计的配置，不能统一让所有未开放任务累积进度，也不能统一清空。

### 3.3 成就前置

前置成就未完成时，原注释说明后续成就不会显示。普通装备收集成就目标4，配置每局开始重置进度，奖励道具52000×1；该重置只适用于带此标记的条目。

## 4. 操作流程

以下顺序用于拆解功能；涉及未确认的结算时机，以本章末尾具体缺口为准。

1. 通过任务组或成就ID定位目标。
2. 连接事件定义，读取目标和锁定累计标记。
3. 事件达到目标后显示完成状态及可用奖励。
4. 领取类型和前置链分别处理，避免把UI显示状态当作进度。

## 5. 关键数值与计算

| 项目 | 数值 | 状态 |
| --- | --- | --- |
| 普通装备收集成就：目标4、每局开始重置进度标记True，奖励ITEM 52000×1 | conditionType=COLLECTION_EQUIP_NORMAL；goalCount=4；isPerGameReset=True；rewardType=ITEM；rewardId=52000；rewardValue=1 | 原作配置确认 |

### 成就链（节选前5条与末3条，完整100条见CSV）

| ID | 名称/键 | conditionType | 目标次数 | 每局重置标记 | rewardType | 奖励ID（按奖励类型解析） | rewardValue |
| --- | --- | --- | --- | --- | --- | --- | --- |
| 200 | 一般收藏家 | COLLECTION_EQUIP_NORMAL | 4 | True | ITEM | 52000 | 1 |
| 201 | 稀有收藏家 | COLLECTION_EQUIP_RARE | 4 | True | ITEM | 52001 | 1 |
| 202 | 英雄收藏家 | COLLECTION_EQUIP_HERO | 4 | True | ITEM | 52002 | 1 |
| 203 | 传说收藏家 | COLLECTION_EQUIP_LEGEND | 4 | True | ITEM | 52003 | 1 |
| 204 | 神秘收藏家 | COLLECTION_EQUIP_ARCANE | 4 | True | ITEM | 52004 | 1 |
| 297 | 陌生的天花板 | COLLECTION_WARP_ENEMY | 1 | True | ITEM | 101 | 20 |
| 298 | 老天捉弄我 | COLLECTION_WARP_JAIL | 1 | True | ITEM | 100 | 1500 |
| 299 | 一切靠实力 | COLLECTION_WARP_GOODEVENT | 1 | True | ITEM | 100 | 500 |

## 6. 原作中文内容

中文名称和效果使用原作文本；{0}、{B}等占位符未确认绑定时保留，文字不能代替参数公式。

| 来源表 | ID | 名称 | 效果/条件文本 |
| --- | --- | --- | --- |
| achievement | 200 | 一般收藏家 | 配备4个一般阶级辅助装备 |
| achievement | 201 | 稀有收藏家 | 配备4个稀有阶级辅助装备 |
| achievement | 202 | 英雄收藏家 | 配备4个英雄阶级辅助装备 |
| achievement | 203 | 传说收藏家 | 配备4个传说阶级辅助装备 |
| achievement | 204 | 神秘收藏家 | 配备4个神秘阶级辅助装备 |
| achievement | 205 | 神话收藏家 | 配备4个神话阶级辅助装备 |
| achievement | 206 | 再来一局？ | 游玩关卡{0}次 |
| achievement | 207 | 还不错 | 游玩关卡{0}次 |
| achievement | 208 | 这样才好玩 | 游玩关卡{0}次 |
| achievement | 209 | 玩了觉得不错 | 游玩关卡{0}次 |
| achievement | 210 | Lv99兔子公主 | 游玩关卡{0}次 |
| achievement | 211 | 看到凤珠就忍不住 | 于商店触碰凤珠{0}次 |
| achievement | 212 | 传说中的铁匠 | 【铁匠铺】传说装备製作成功 |
| achievement | 213 | 早知道就算了 | 【铁匠铺】传说装备製作失败 |
| achievement | 214 | 这有暗调吧？ | 【铁匠铺】于首次强化破坏装备 |
| achievement | 215 | 旱地甘霖 | 【恢復】HP低于10%时到达 |
| achievement | 216 | 刻薄人心 | 【恢復】仅获得1个药水 |
| achievement | 217 | 我就是强 | 【勇士遗骸】发现1格的传说宝物 |
| achievement | 218 | 这不对吧？ | 【勇士遗骸】{0}次全都空格 |
| achievement | 219 | 节奏统治者 | 【来点节奏】完美达成所有节奏 |

本节展示前20条中文内容；完整100条有名称或效果的记录见对应中文目录及[中文文本对照](./中文文本对照.csv)。

## 7. 开发权威表

| 配置用途 | 权威原字段表 | 记录数 | 开发阅读表 |
| --- | --- | --- | --- |
| 任务条件定义 | [questdata.csv](./questdata.csv) | 62 | [中文目录](./questdata-中文目录.csv) |
| 任务组目标与奖励 | [groupquestlist.csv](./groupquestlist.csv) | 130 | [中文目录](./groupquestlist-中文目录.csv) |
| 成就链 | [achievement.csv](./achievement.csv) | 100 | [中文目录](./achievement-中文目录.csv) |

[执行规则](./执行规则.csv) · [状态字段](./状态字段.csv) · [验收样例](./验收样例.csv) · [字段字典](./字段字典.csv) · [关联全局配置](./关联全局配置.csv)

## 8. 开发验收与禁止误写

| 输入 | 检查内容 | 预期 |
| --- | --- | --- |
| 读取achievement中StringId=ingameEquip4Normal | 查询本条配置并核对界面/配置输出 | conditionType=COLLECTION_EQUIP_NORMAL；goalCount=4；isPerGameReset=True；rewardType=ITEM；rewardId=52000；rewardValue=1 |

验收样例覆盖已经确认的值；流程中的未知分支不能以本表通过代替规则确认。数值表内的空值、0和-1分别保留；升级数组不默认使用玩家等级作为索引。

## 9. 当前待补充边界

事件计数的精确时机、隐藏成就显示条件和各领取类型枚举语义尚待确认。

[返回总纲](../局外玩法设计文档_HEROLL_原作_v1.0.md) · [阅读规范](../文档规范与阅读说明.md)