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,140 @@
# 每日副本与探索副本:原作设计与规则
版本:HEROLL 2.0.1 原作还原文档 v1.0。
## 1. 功能定位
每日副本与探索副本是两个独立玩法。每日副本按星期和难度给奖励;探索副本有独立门票、背包、装备成长及分解体系,不与巡逻挂机共用进度。
## 2. 主要状态
下面是开发阅读所需的概念状态,属于开发映射,不要求与原作内部字段同名。
| 状态 | 用途 |
| --- | --- |
| 每日副本星期难度 | 选择奖励档 |
| 探索门票和恢复进度 | 控制入场 |
| 探索章节 | 推进地图 |
| 探索背包装备 | 独立于永久装备 |
## 3. 功能规则
### 3.1 每日副本
奖励按星期和难度查询,推荐阶段来自难度配置,战斗属性按难度和层数区分。不能把星期枚举直接假定为从星期一开始的1至7。
### 3.2 探索入场
探索门票初始6、上限12,恢复间隔14400秒,即4小时。背包容量30,原注释明确不包含已装备物。
### 3.3 探索装备
探索装备按等级和类型读取各品质属性;分解表分别保存每品质的回收ID及数量。永久装备的强化成本与合成规则不适用于这套装备。
### 3.4 掉落
掉落权重按当前已掉落数量分档,同时有失败及多个品质数组;它说明候选权重结构,不足以确定完整的掉落保护顺序。
## 4. 操作流程
以下顺序用于拆解功能;涉及未确认的结算时机,以本章末尾具体缺口为准。
1. 选择每日副本或探索副本,进入各自的进度域。
2. 每日副本按星期难度显示奖励,探索副本显示门票和章节。
3. 探索获得的装备进入专用背包,属性与分解按探索表读取。
## 5. 关键数值与计算
| 项目 | 数值 | 状态 |
| --- | --- | --- |
| 探索副本票券每14400秒(4小时)恢复,初始6、上限12;背包30不含已装备物 | ticketChargeTime=14400;maxTicket=12;startTicket=6;maxInvSize=30 | 原作配置确认 |
| 曜日副本解锁阶段配置 | Values=4 | 原作配置确认 |
| 曜日广告奖励百分数配置 | Values=50 | 原作配置确认 |
### 探索门票与背包(全表)
| ID | 名称/键 | 门票恢复时间(单位按表注释) | 门票上限 | 初始门票 | 未装备物容量 |
| --- | --- | --- | --- | --- | --- |
| 100 | DefaultConfig | 14400 | 12 | 6 | 30 |
### 曜日副本奖励(全表)
| ID | 名称/键 | 日序/星期枚举(按表) | difficulty | 道具ID | 道具数量 |
| --- | --- | --- | --- | --- | --- |
| 0 | Monday_0 | 0 | 0 | 100 | 15000 |
| 1 | Tuesday_0 | 1 | 0 | 131,133 | 100,200 |
| 2 | Wednesday_0 | 2 | 0 | 142 | 25 |
| 3 | Thursday_0 | 3 | 0 | 101 | 20 |
| 4 | Friday_0 | 4 | 0 | 131,133 | 100,200 |
| 5 | Saturday_0 | 5 | 0 | 142 | 25 |
| 6 | Sunday_0 | 6 | 0 | 100 | 15000 |
| 7 | Monday_1 | 0 | 1 | 100 | 25000 |
| 8 | Tuesday_1 | 1 | 1 | 131,133 | 150,300 |
| 9 | Wednesday_1 | 2 | 1 | 142 | 50 |
| 10 | Thursday_1 | 3 | 1 | 101 | 30 |
| 11 | Friday_1 | 4 | 1 | 131,133 | 150,300 |
| 12 | Saturday_1 | 5 | 1 | 142 | 50 |
| 13 | Sunday_1 | 6 | 1 | 100 | 25000 |
| 14 | Monday_2 | 0 | 2 | 100 | 30000 |
| 15 | Tuesday_2 | 1 | 2 | 131,133 | 200,500 |
| 16 | Wednesday_2 | 2 | 2 | 142 | 100 |
| 17 | Thursday_2 | 3 | 2 | 101 | 50 |
| 18 | Friday_2 | 4 | 2 | 131,133 | 200,500 |
| 19 | Saturday_2 | 5 | 2 | 142 | 100 |
| 20 | Sunday_2 | 6 | 2 | 100 | 30000 |
| 21 | Monday_3 | 0 | 3 | 100 | 50000 |
| 22 | Tuesday_3 | 1 | 3 | 131,133 | 300,750 |
| 23 | Wednesday_3 | 2 | 3 | 142 | 150 |
| 24 | Thursday_3 | 3 | 3 | 101 | 75 |
| 25 | Friday_3 | 4 | 3 | 131,133 | 300,750 |
| 26 | Saturday_3 | 5 | 3 | 142 | 150 |
| 27 | Sunday_3 | 6 | 3 | 100 | 50000 |
## 6. 原作中文内容
中文名称和效果使用原作文本;{0}、{B}等占位符未确认绑定时保留,文字不能代替参数公式。
本模块主要由数值和键值组成,原作文本对照见同目录CSV。
## 7. 开发权威表
| 配置用途 | 权威原字段表 | 记录数 | 开发阅读表 |
| --- | --- | --- | --- |
| 曜日副本奖励 | [dayoftheweekdungeon.csv](./dayoftheweekdungeon.csv) | 28 | [中文目录](./dayoftheweekdungeon-中文目录.csv) |
| 曜日副本难度推荐 | [dayoftheweekdungeonconfig.csv](./dayoftheweekdungeonconfig.csv) | 1 | [中文目录](./dayoftheweekdungeonconfig-中文目录.csv) |
| 曜日副本层数属性 | [weekdungeonboard.csv](./weekdungeonboard.csv) | 40 | [中文目录](./weekdungeonboard-中文目录.csv) |
| 探索区域内容 | [idledungeon.csv](./idledungeon.csv) | 200 | [中文目录](./idledungeon-中文目录.csv) |
| 探索门票与背包 | [idledungeonconfig.csv](./idledungeonconfig.csv) | 1 | [中文目录](./idledungeonconfig-中文目录.csv) |
| 探索掉落权重 | [idledungeondrop.csv](./idledungeondrop.csv) | 6 | [中文目录](./idledungeondrop-中文目录.csv) |
| 探索装备分解 | [idledungeonequipmentsalvage.csv](./idledungeonequipmentsalvage.csv) | 700 | [中文目录](./idledungeonequipmentsalvage-中文目录.csv) |
| 探索装备等级属性 | [idledungeonequipmentstatus.csv](./idledungeonequipmentstatus.csv) | 2800 | [中文目录](./idledungeonequipmentstatus-中文目录.csv) |
| 探索角色基础属性 | [idledungeonplayerdefaultstat.csv](./idledungeonplayerdefaultstat.csv) | 5 | [中文目录](./idledungeonplayerdefaultstat-中文目录.csv) |
| 探索章节与奖励 | [idledungeonstageinfo.csv](./idledungeonstageinfo.csv) | 200 | [中文目录](./idledungeonstageinfo-中文目录.csv) |
[执行规则](./执行规则.csv) · [状态字段](./状态字段.csv) · [验收样例](./验收样例.csv) · [字段字典](./字段字典.csv) · [关联全局配置](./关联全局配置.csv)
全局键按模块名称关联收录;其具体含义优先以正文已确认的规则为准。
| 配置键 | 原值 |
| --- | --- |
| dayOfWeekDungeonUnlockStage | 4 |
| dayOfWeekDungeonBlock | 0 |
| weekDungeonADRewardPercent | 50 |
| idleDungeonUnlockStage | 1 |
| idleDungeonBlock | 0 |
## 8. 开发验收与禁止误写
| 输入 | 检查内容 | 预期 |
| --- | --- | --- |
| 读取idledungeonconfig中StringId=DefaultConfig | 查询本条配置并核对界面/配置输出 | ticketChargeTime=14400;maxTicket=12;startTicket=6;maxInvSize=30 |
| 读取gameconfig中StringId=dayOfWeekDungeonUnlockStage | 查询本条配置并核对界面/配置输出 | Values=4 |
| 读取gameconfig中StringId=weekDungeonADRewardPercent | 查询本条配置并核对界面/配置输出 | Values=50 |
验收样例覆盖已经确认的值;流程中的未知分支不能以本表通过代替规则确认。数值表内的空值、0和-1分别保留;升级数组不默认使用玩家等级作为索引。
## 9. 当前待补充边界
星期枚举、满票后的恢复处理、探索掉落权重算法和分解操作约束尚待确认。
[返回总纲](../局外玩法设计文档_HEROLL_原作_v1.0.md) · [阅读规范](../文档规范与阅读说明.md)