7.1 KiB
7.1 KiB
主线进度与星级挑战：原作设计与规则
版本：HEROLL 2.0.1 原作还原文档 v1.0。
1. 功能定位
主线入口负责选关、进度展示和通关奖励。星级挑战则在完成关卡之外增加目标，按累计星数提供额外奖励；关卡中的战斗细节不在此重复定义。
2. 主要状态
下面是开发阅读所需的概念状态，属于开发映射，不要求与原作内部字段同名。
| 状态 | 用途 |
|---|---|
| 当前及已通关阶段 | 决定选关进度 |
| 模式 | 区分普通等玩法 |
| 各挑战完成状态 | 累计星数 |
| 星数奖励领取档 | 独立于通关奖励 |
3. 功能规则
3.1 主线关卡
关卡以模式和阶段识别，不能只用一个数字混合所有模式。关卡目录保留Boss与场景等入口信息。
3.2 通关与层数奖励
关卡奖励可能按模式、阶段、层数、进度和是否通关区分；层数奖励是另一张表。两种来源不能因奖励道具相同就合并成一次领取。
3.3 星级条件
原作中文文本确认挑战0为游戏通关、挑战1为以指定百分比以上生命值通关、挑战2为指定秒数内击杀首领；对应参数0、70、5。因此后两项可显示为70%生命、5秒击杀首领，边界是否包含仍需验证。
3.4 星数收益
累计1星档奖励钻石50，奖励2与3的ID为-1，不能把该占位ID作为实际道具发放。
4. 操作流程
以下顺序用于拆解功能；涉及未确认的结算时机，以本章末尾具体缺口为准。
- 选关时读取模式与阶段，显示已开放进度。
- 完成局内玩法后，分别更新通关状态与星级条件。
- 按星数定位奖励档，按关卡结算条件定位通关奖励。
5. 关键数值与计算
| 项目 | 数值 | 状态 |
|---|---|---|
| 星级挑战开放阶段配置 | Values=2 | 原作配置确认 |
| 星数1对应道具101×50；其他奖励ID=-1保留哨兵值 | starCount=1；rewardID1=101；value1=50；rewardID2=-1；rewardID3=-1 | 原作配置确认 |
星级挑战条件参数（全表）
| ID | 名称/键 | 挑战描述 | 数值（单位按表） |
|---|---|---|---|
| 0 | 0 | 游戏通关 | 0 |
| 1 | 1 | 以{0}%以上生命值通关 | 70 |
| 2 | 2 | 于{0}秒内击杀首领 | 5 |
星数奖励档（节选前5条与末3条，完整201条见CSV）
| ID | 名称/键 | 星数 | rewardID1 | 奖励1数量 | rewardID2 | 奖励2数量 |
|---|---|---|---|---|---|---|
| 0 | 0 | 1 | 101 | 50 | -1 | |
| 1 | 1 | 2 | 101 | 50 | -1 | |
| 2 | 2 | 3 | 101 | 50 | -1 | |
| 3 | 3 | 4 | 101 | 50 | -1 | |
| 4 | 4 | 5 | 101 | 50 | -1 | |
| 198 | 198 | 199 | 101 | 50 | -1 | |
| 199 | 199 | 200 | 101 | 100 | -1 | |
| 200 | 200 | 201 | 101 | 50 | -1 |
6. 原作中文内容
中文名称和效果使用原作文本；{0}、{B}等占位符未确认绑定时保留，文字不能代替参数公式。
| 来源表 | ID | 名称 | 效果/条件文本 |
|---|---|---|---|
| stageinfo | 0 | 黑暗军团长 | 被黑暗军团长占领的村庄， / 已找不回以前的面貌。 |
| stageinfo | 1 | 王者石剑 | 任何人都拔不起的王者之剑， / 最终达到极限并攻击冒险家。 |
| stageinfo | 2 | 赤龙 | 根据预示，赤龙的族群将导致世界灭亡。 |
| stageinfo | 3 | 矿山小镇 | 半兽人正用矿山里的矿石 / 打造出巨大的斧头。 |
| stageinfo | 4 | 巨大的半兽人 | 直到半兽人统治世界， / 展厅不会停歇。 |
| stageinfo | 5 | 冰封之海 | 随着冰雪的融化， / 海底深处的封印正逐渐苏醒。 |
| stageinfo | 6 | 海妖女王 | 受到诅咒的女王将引发巨大的海啸， / 对人类进行复仇。 |
| stageinfo | 7 | 噬骨沙漠 | 沙漠中的所有生命， / 都正在被某个庞然大物吞噬。 |
| stageinfo | 8 | 贪食王子 | 即使下整个世界， / 仍然无法吞饱肚子。 |
| stageinfo | 9 | 赌徒村庄 | 在他造访之后， / 村里的居民一个接一个地发疯。 |
| stageinfo | 10 | 东亚人 | 只要遇见他， / 就只能靠掷铜板决定一切。 |
| stageinfo | 11 | 被遗忘的村庄 | 村庄英雄的记录被全数抹去， / 周围开始聚集起哥布林。 |
| stageinfo | 12 | 被遗忘的勇士 | 放弃勇士之路成为哥布林的他， / 打算让全世界都变成哥布林。 |
| stageinfo | 13 | 太初之村 | 在太初勇士建立的村庄里， / 出现了已故军团长的士兵。 |
| stageinfo | 14 | 雪白军团长 | 从死亡深重回渊归来， / 只为向勇士复仇。 |
| stageinfo | 15 | 冰封神兽的摇篮 | 神兽之蛋纷纷静止， / 整座摇篮正逐渐变得冰冷。 |
| stageinfo | 16 | 冰霜行者 | 远古神兽为了结束勇士与魔王的战争， / 决定冰冻世上的一切。 |
| stageinfo | 17 | 笛音沙漠 | 伴随着笛声离去的人们， / 没有人再回来。 |
| stageinfo | 18 | 哀声石山 | 整座石山正像巨大的乐器般发出共鸣。 |
| stageinfo | 19 | 终极指挥家 | 无尽的毁灭与破坏， / 只是完成乐章的旋律。 |
本节展示前20条中文内容；完整55条有名称或效果的记录见对应中文目录及中文文本对照。
7. 开发权威表
| 配置用途 | 权威原字段表 | 记录数 | 开发阅读表 |
|---|---|---|---|
| 关卡入口及模式 | stageinfo.csv | 53 | 中文目录 |
| 关卡结算奖励 | stagerewardinfo.csv | 159 | 中文目录 |
| 层数奖励 | loopreward.csv | 30 | 中文目录 |
| 星级挑战条件参数 | starchallenge.csv | 3 | 中文目录 |
| 星数奖励档 | starchallengereward.csv | 201 | 中文目录 |
执行规则 · 状态字段 · 验收样例 · 字段字典 · 关联全局配置
全局键按模块名称关联收录；其具体含义优先以正文已确认的规则为准。
| 配置键 | 原值 |
|---|---|
| needEnergy | 5 |
| starChallengeUnlockStage | 2 |
8. 开发验收与禁止误写
| 输入 | 检查内容 | 预期 |
|---|---|---|
| 读取gameconfig中StringId=starChallengeUnlockStage | 查询本条配置并核对界面/配置输出 | Values=2 |
| 读取starchallengereward中StringId=0 | 查询本条配置并核对界面/配置输出 | starCount=1；rewardID1=101；value1=50；rewardID2=-1；rewardID3=-1 |
验收样例覆盖已经确认的值；流程中的未知分支不能以本表通过代替规则确认。数值表内的空值、0和-1分别保留；升级数组不默认使用玩家等级作为索引。
9. 当前待补充边界
生命百分比和秒数条件的精确比较边界、星级能否跨次累计及奖励重复领取条件尚待确认。