Files
HEROLL/HEROLL_OUTGAME_DEV_v1.0/15-任务与成就/设计与规则.md
T

115 lines
6.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 任务与成就:原作设计与规则
版本: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)