6.1 KiB
6.1 KiB
任务与成就：原作设计与规则
版本：HEROLL 2.0.1 原作还原文档 v1.0。
1. 功能定位
任务描述玩家要完成的目标，任务组决定目标数量和奖励；成就则可通过前置链逐步开放。一个条件模板可以被活动或通行证复用，不应重复定义事件语义。
2. 主要状态
下面是开发阅读所需的概念状态，属于开发映射，不要求与原作内部字段同名。
| 状态 | 用途 |
|---|---|
| 任务实例与所属组 | 区分同模板的多个目标 |
| 当前计数 | 保存目标进度 |
| 开放状态 | 决定是否展示与是否计数 |
| 领奖状态 | 区分完成与已领取 |
| 成就前置状态 | 连接前置链 |
3. 功能规则
3.1 任务条件
任务定义表给事件类型、条件键及附加参数。任务组引用该定义后再设置目标次数、领取类型及奖励；“目标完成”与“领取奖励”是两项状态。
3.2 锁定时计数
任务组有锁定时是否允许累计的配置，不能统一让所有未开放任务累积进度，也不能统一清空。
3.3 成就前置
前置成就未完成时，原注释说明后续成就不会显示。普通装备收集成就目标4，配置每局开始重置进度，奖励道具52000×1；该重置只适用于带此标记的条目。
4. 操作流程
以下顺序用于拆解功能；涉及未确认的结算时机，以本章末尾具体缺口为准。
- 通过任务组或成就ID定位目标。
- 连接事件定义，读取目标和锁定累计标记。
- 事件达到目标后显示完成状态及可用奖励。
- 领取类型和前置链分别处理，避免把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条有名称或效果的记录见对应中文目录及中文文本对照。
7. 开发权威表
| 配置用途 | 权威原字段表 | 记录数 | 开发阅读表 |
|---|---|---|---|
| 任务条件定义 | questdata.csv | 62 | 中文目录 |
| 任务组目标与奖励 | groupquestlist.csv | 130 | 中文目录 |
| 成就链 | achievement.csv | 100 | 中文目录 |
执行规则 · 状态字段 · 验收样例 · 字段字典 · 关联全局配置
8. 开发验收与禁止误写
| 输入 | 检查内容 | 预期 |
|---|---|---|
| 读取achievement中StringId=ingameEquip4Normal | 查询本条配置并核对界面/配置输出 | conditionType=COLLECTION_EQUIP_NORMAL；goalCount=4；isPerGameReset=True；rewardType=ITEM；rewardId=52000；rewardValue=1 |
验收样例覆盖已经确认的值；流程中的未知分支不能以本表通过代替规则确认。数值表内的空值、0和-1分别保留；升级数组不默认使用玩家等级作为索引。
9. 当前待补充边界
事件计数的精确时机、隐藏成就显示条件和各领取类型枚举语义尚待确认。