Initial import of HEROLL source and design documents

This commit is contained in:
toshiocn
2026-10-26 16:05:39 +08:00
commit fdb55672c1
1846 changed files with 290692 additions and 0 deletions
@@ -0,0 +1,135 @@
# 主线进度与星级挑战:原作设计与规则
版本: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. 操作流程
以下顺序用于拆解功能;涉及未确认的结算时机,以本章末尾具体缺口为准。
1. 选关时读取模式与阶段,显示已开放进度。
2. 完成局内玩法后,分别更新通关状态与星级条件。
3. 按星数定位奖励档,按关卡结算条件定位通关奖励。
## 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条有名称或效果的记录见对应中文目录及[中文文本对照](./中文文本对照.csv)。
## 7. 开发权威表
| 配置用途 | 权威原字段表 | 记录数 | 开发阅读表 |
| --- | --- | --- | --- |
| 关卡入口及模式 | [stageinfo.csv](./stageinfo.csv) | 53 | [中文目录](./stageinfo-中文目录.csv) |
| 关卡结算奖励 | [stagerewardinfo.csv](./stagerewardinfo.csv) | 159 | [中文目录](./stagerewardinfo-中文目录.csv) |
| 层数奖励 | [loopreward.csv](./loopreward.csv) | 30 | [中文目录](./loopreward-中文目录.csv) |
| 星级挑战条件参数 | [starchallenge.csv](./starchallenge.csv) | 3 | [中文目录](./starchallenge-中文目录.csv) |
| 星数奖励档 | [starchallengereward.csv](./starchallengereward.csv) | 201 | [中文目录](./starchallengereward-中文目录.csv) |
[执行规则](./执行规则.csv) · [状态字段](./状态字段.csv) · [验收样例](./验收样例.csv) · [字段字典](./字段字典.csv) · [关联全局配置](./关联全局配置.csv)
全局键按模块名称关联收录;其具体含义优先以正文已确认的规则为准。
| 配置键 | 原值 |
| --- | --- |
| 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. 当前待补充边界
生命百分比和秒数条件的精确比较边界、星级能否跨次累计及奖励重复领取条件尚待确认。
[返回总纲](../局外玩法设计文档_HEROLL_原作_v1.0.md) · [阅读规范](../文档规范与阅读说明.md)