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,9 @@
# 09-收藏与图鉴
收藏以装备组合为目标。每条收藏要求特定装备达到指定等级与品质,完成后对应一项永久属性收益。开发需要把“拥有装备”“达到组合条件”“获得收藏收益”作为不同判断。
[设计与规则](./设计与规则.md)是本模块正文。数值和规则CSV与正文同目录,原作中文目录用于开发阅读。
| 配置用途 | 权威原字段表 | 记录数 | 开发阅读表 |
| --- | --- | --- | --- |
| 收藏组合条件 | [collection.csv](./collection.csv) | 8 | [中文目录](./collection-中文目录.csv) |
@@ -0,0 +1,9 @@
原作中文名称,原作效果文本,Id,StringId,isEnabled,order,title,equipmentIds,equipmentLevels,equipmentGrades,EMonoStatus,value
冒险的开始,,1,collection_001,True,1,title_collection_001,"103,111,118","1,1,1","1,1,1",ATTACK_POWER,0.4
斧头帮,,2,collection_002,True,2,title_collection_002,"104,105","5,5","2,2",ATTACK_POWER,2.0
大自然力量I,,3,collection_003,True,3,title_collection_003,"107,115,123","1,1,1","1,1,1",HEALTH,3.0
秘密敢死队,,5,collection_005,True,5,title_collection_005,"101,109,117","2,3,3","2,2,2",AIM,3.0
骑士誓言I,,6,collection_006,True,6,title_collection_006,"100,122","1,1","2,1",DEFENSE,0.1
忠于基本,,7,collection_007,True,11,title_collection_007,"110,114,119","2,3,2","3,3,3",HEALTH,15.0
苦行者,,8,collection_008,True,8,title_collection_008,"108,120,124","4,4,1","2,3,3",DEFENSE,0.9
弓箭手传说,,10,collection_010,True,10,title_collection_010,"110,116,119","1,1,1","0,1,0",AIM,0.5
1 原作中文名称 原作效果文本 Id StringId isEnabled order title equipmentIds equipmentLevels equipmentGrades EMonoStatus value
2 冒险的开始 1 collection_001 True 1 title_collection_001 103,111,118 1,1,1 1,1,1 ATTACK_POWER 0.4
3 斧头帮 2 collection_002 True 2 title_collection_002 104,105 5,5 2,2 ATTACK_POWER 2.0
4 大自然力量I 3 collection_003 True 3 title_collection_003 107,115,123 1,1,1 1,1,1 HEALTH 3.0
5 秘密敢死队 5 collection_005 True 5 title_collection_005 101,109,117 2,3,3 2,2,2 AIM 3.0
6 骑士誓言I 6 collection_006 True 6 title_collection_006 100,122 1,1 2,1 DEFENSE 0.1
7 忠于基本 7 collection_007 True 11 title_collection_007 110,114,119 2,3,2 3,3,3 HEALTH 15.0
8 苦行者 8 collection_008 True 8 title_collection_008 108,120,124 4,4,1 2,3,3 DEFENSE 0.9
9 弓箭手传说 10 collection_010 True 10 title_collection_010 110,116,119 1,1,1 0,1,0 AIM 0.5
@@ -0,0 +1,9 @@
Id,StringId,isEnabled,order,title,equipmentIds,equipmentLevels,equipmentGrades,EMonoStatus,value
1,collection_001,True,1,title_collection_001,"103,111,118","1,1,1","1,1,1",ATTACK_POWER,0.4
2,collection_002,True,2,title_collection_002,"104,105","5,5","2,2",ATTACK_POWER,2.0
3,collection_003,True,3,title_collection_003,"107,115,123","1,1,1","1,1,1",HEALTH,3.0
5,collection_005,True,5,title_collection_005,"101,109,117","2,3,3","2,2,2",AIM,3.0
6,collection_006,True,6,title_collection_006,"100,122","1,1","2,1",DEFENSE,0.1
7,collection_007,True,11,title_collection_007,"110,114,119","2,3,2","3,3,3",HEALTH,15.0
8,collection_008,True,8,title_collection_008,"108,120,124","4,4,1","2,3,3",DEFENSE,0.9
10,collection_010,True,10,title_collection_010,"110,116,119","1,1,1","0,1,0",AIM,0.5
1 Id StringId isEnabled order title equipmentIds equipmentLevels equipmentGrades EMonoStatus value
2 1 collection_001 True 1 title_collection_001 103,111,118 1,1,1 1,1,1 ATTACK_POWER 0.4
3 2 collection_002 True 2 title_collection_002 104,105 5,5 2,2 ATTACK_POWER 2.0
4 3 collection_003 True 3 title_collection_003 107,115,123 1,1,1 1,1,1 HEALTH 3.0
5 5 collection_005 True 5 title_collection_005 101,109,117 2,3,3 2,2,2 AIM 3.0
6 6 collection_006 True 6 title_collection_006 100,122 1,1 2,1 DEFENSE 0.1
7 7 collection_007 True 11 title_collection_007 110,114,119 2,3,2 3,3,3 HEALTH 15.0
8 8 collection_008 True 8 title_collection_008 108,120,124 4,4,1 2,3,3 DEFENSE 0.9
9 10 collection_010 True 10 title_collection_010 110,116,119 1,1,1 0,1,0 AIM 0.5
@@ -0,0 +1,9 @@
表,Id,StringId,源字段,文本键,原作中文,来源
collection,1,collection_001,title,title_collection_001,冒险的开始,原作本地化/zh-cn
collection,2,collection_002,title,title_collection_002,斧头帮,原作本地化/zh-cn
collection,3,collection_003,title,title_collection_003,大自然力量I,原作本地化/zh-cn
collection,5,collection_005,title,title_collection_005,秘密敢死队,原作本地化/zh-cn
collection,6,collection_006,title,title_collection_006,骑士誓言I,原作本地化/zh-cn
collection,7,collection_007,title,title_collection_007,忠于基本,原作本地化/zh-cn
collection,8,collection_008,title,title_collection_008,苦行者,原作本地化/zh-cn
collection,10,collection_010,title,title_collection_010,弓箭手传说,原作本地化/zh-cn
1 表 Id StringId 源字段 文本键 原作中文 来源
2 collection 1 collection_001 title title_collection_001 冒险的开始 原作本地化/zh-cn
3 collection 2 collection_002 title title_collection_002 斧头帮 原作本地化/zh-cn
4 collection 3 collection_003 title title_collection_003 大自然力量I 原作本地化/zh-cn
5 collection 5 collection_005 title title_collection_005 秘密敢死队 原作本地化/zh-cn
6 collection 6 collection_006 title title_collection_006 骑士誓言I 原作本地化/zh-cn
7 collection 7 collection_007 title title_collection_007 忠于基本 原作本地化/zh-cn
8 collection 8 collection_008 title title_collection_008 苦行者 原作本地化/zh-cn
9 collection 10 collection_010 title title_collection_010 弓箭手传说 原作本地化/zh-cn
@@ -0,0 +1,3 @@
Id,StringId,Values
108,BaseCollectionRewardNeed,5
180,CollectionUnlockStage,6
1 Id StringId Values
2 108 BaseCollectionRewardNeed 5
3 180 CollectionUnlockStage 6
@@ -0,0 +1,11 @@
表,字段,含义,原类型,原注释
collection,Id,数值主键,Key<int>,
collection,StringId,字符串主键,Key<string>,
collection,isEnabled,配置启用标志,bool,
collection,order,按本模块功能规则与原注释解释,int,
collection,title,按本模块功能规则与原注释解释,string,
collection,equipmentIds,按本模块功能规则与原注释解释,string,
collection,equipmentLevels,按本模块功能规则与原注释解释,string,
collection,equipmentGrades,按本模块功能规则与原注释解释,string,
collection,EMonoStatus,属性枚举,EMonoStatus,
collection,value,数值(单位按表),float,
1 表 字段 含义 原类型 原注释
2 collection Id 数值主键 Key<int>
3 collection StringId 字符串主键 Key<string>
4 collection isEnabled 配置启用标志 bool
5 collection order 按本模块功能规则与原注释解释 int
6 collection title 按本模块功能规则与原注释解释 string
7 collection equipmentIds 按本模块功能规则与原注释解释 string
8 collection equipmentLevels 按本模块功能规则与原注释解释 string
9 collection equipmentGrades 按本模块功能规则与原注释解释 string
10 collection EMonoStatus 属性枚举 EMonoStatus
11 collection value 数值(单位按表) float
@@ -0,0 +1,6 @@
规则ID,规则项目,执行说明,规则状态,来源,边界
O09-01,组合条件,收藏001要求装备103、111、118,其等级要求均为1、品质要求均为1。三组数组一一对应;不能把所有装备要求的最高等级应用到整个组合。,原作部分确认,collection,是否要求同时持有、是否消耗收藏装备、领取方式与收益单位尚待确认。
O09-02,收藏收益,收藏001的攻击收益配置为0.4,收藏002为2.0。该表没有统一百分比开关,不能仅凭数值大小把它们转换成40%或2%。,原作部分确认,collection,是否要求同时持有、是否消耗收藏装备、领取方式与收益单位尚待确认。
O09-03,开放,收藏功能开放阶段配置为6;每条收藏还保留自身启用与展示顺序。,原作部分确认,collection,是否要求同时持有、是否消耗收藏装备、领取方式与收益单位尚待确认。
O09-N01,收藏001的装备组合、级别品质与属性值,"equipmentIds=103,111,118;equipmentLevels=1,1,1;equipmentGrades=1,1,1;EMonoStatus=ATTACK_POWER;value=0.4",原作配置确认,collection.csv/StringId=collection_001,原字段值;复合公式以正文边界为准
O09-N02,收藏开放阶段配置,Values=6,原作配置确认,gameconfig.csv/StringId=CollectionUnlockStage,原字段值;复合公式以正文边界为准
1 规则ID 规则项目 执行说明 规则状态 来源 边界
2 O09-01 组合条件 收藏001要求装备103、111、118,其等级要求均为1、品质要求均为1。三组数组一一对应;不能把所有装备要求的最高等级应用到整个组合。 原作部分确认 collection 是否要求同时持有、是否消耗收藏装备、领取方式与收益单位尚待确认。
3 O09-02 收藏收益 收藏001的攻击收益配置为0.4,收藏002为2.0。该表没有统一百分比开关,不能仅凭数值大小把它们转换成40%或2%。 原作部分确认 collection 是否要求同时持有、是否消耗收藏装备、领取方式与收益单位尚待确认。
4 O09-03 开放 收藏功能开放阶段配置为6;每条收藏还保留自身启用与展示顺序。 原作部分确认 collection 是否要求同时持有、是否消耗收藏装备、领取方式与收益单位尚待确认。
5 O09-N01 收藏001的装备组合、级别品质与属性值 equipmentIds=103,111,118;equipmentLevels=1,1,1;equipmentGrades=1,1,1;EMonoStatus=ATTACK_POWER;value=0.4 原作配置确认 collection.csv/StringId=collection_001 原字段值;复合公式以正文边界为准
6 O09-N02 收藏开放阶段配置 Values=6 原作配置确认 gameconfig.csv/StringId=CollectionUnlockStage 原字段值;复合公式以正文边界为准
@@ -0,0 +1,4 @@
状态,用途,规则状态
收藏条目状态,区分未满足与满足,开发映射
装备组合进度,逐项核对身份等级品质,开发映射
收藏属性,记录目标属性及收益,开发映射
1 状态 用途 规则状态
2 收藏条目状态 区分未满足与满足 开发映射
3 装备组合进度 逐项核对身份等级品质 开发映射
4 收藏属性 记录目标属性及收益 开发映射
@@ -0,0 +1,104 @@
# 收藏与图鉴:原作设计与规则
版本:HEROLL 2.0.1 原作还原文档 v1.0。
## 1. 功能定位
收藏以装备组合为目标。每条收藏要求特定装备达到指定等级与品质,完成后对应一项永久属性收益。开发需要把“拥有装备”“达到组合条件”“获得收藏收益”作为不同判断。
## 2. 主要状态
下面是开发阅读所需的概念状态,属于开发映射,不要求与原作内部字段同名。
| 状态 | 用途 |
| --- | --- |
| 收藏条目状态 | 区分未满足与满足 |
| 装备组合进度 | 逐项核对身份等级品质 |
| 收藏属性 | 记录目标属性及收益 |
## 3. 功能规则
### 3.1 组合条件
收藏001要求装备103、111、118,其等级要求均为1、品质要求均为1。三组数组一一对应;不能把所有装备要求的最高等级应用到整个组合。
### 3.2 收藏收益
收藏001的攻击收益配置为0.4,收藏002为2.0。该表没有统一百分比开关,不能仅凭数值大小把它们转换成40%或2%。
### 3.3 开放
收藏功能开放阶段配置为6;每条收藏还保留自身启用与展示顺序。
## 4. 操作流程
以下顺序用于拆解功能;涉及未确认的结算时机,以本章末尾具体缺口为准。
1. 读取收藏条目,将三组条件按位置组成要求列表。
2. 逐项展示玩家装备与条件的差异。
3. 显示该收藏对应的属性收益及满足状态。
## 5. 关键数值与计算
| 项目 | 数值 | 状态 |
| --- | --- | --- |
| 收藏001的装备组合、级别品质与属性值 | equipmentIds=103,111,118;equipmentLevels=1,1,1;equipmentGrades=1,1,1;EMonoStatus=ATTACK_POWER;value=0.4 | 原作配置确认 |
| 收藏开放阶段配置 | Values=6 | 原作配置确认 |
### 收藏组合条件(全表)
| ID | 名称/键 | equipmentIds | equipmentLevels | equipmentGrades | 属性枚举 | 数值(单位按表) |
| --- | --- | --- | --- | --- | --- | --- |
| 1 | 冒险的开始 | 103,111,118 | 1,1,1 | 1,1,1 | ATTACK_POWER | 0.4 |
| 2 | 斧头帮 | 104,105 | 5,5 | 2,2 | ATTACK_POWER | 2.0 |
| 3 | 大自然力量I | 107,115,123 | 1,1,1 | 1,1,1 | HEALTH | 3.0 |
| 5 | 秘密敢死队 | 101,109,117 | 2,3,3 | 2,2,2 | AIM | 3.0 |
| 6 | 骑士誓言I | 100,122 | 1,1 | 2,1 | DEFENSE | 0.1 |
| 7 | 忠于基本 | 110,114,119 | 2,3,2 | 3,3,3 | HEALTH | 15.0 |
| 8 | 苦行者 | 108,120,124 | 4,4,1 | 2,3,3 | DEFENSE | 0.9 |
| 10 | 弓箭手传说 | 110,116,119 | 1,1,1 | 0,1,0 | AIM | 0.5 |
## 6. 原作中文内容
中文名称和效果使用原作文本;{0}、{B}等占位符未确认绑定时保留,文字不能代替参数公式。
| 来源表 | ID | 名称 | 效果/条件文本 |
| --- | --- | --- | --- |
| collection | 1 | 冒险的开始 | |
| collection | 2 | 斧头帮 | |
| collection | 3 | 大自然力量I | |
| collection | 5 | 秘密敢死队 | |
| collection | 6 | 骑士誓言I | |
| collection | 7 | 忠于基本 | |
| collection | 8 | 苦行者 | |
| collection | 10 | 弓箭手传说 | |
## 7. 开发权威表
| 配置用途 | 权威原字段表 | 记录数 | 开发阅读表 |
| --- | --- | --- | --- |
| 收藏组合条件 | [collection.csv](./collection.csv) | 8 | [中文目录](./collection-中文目录.csv) |
[执行规则](./执行规则.csv) · [状态字段](./状态字段.csv) · [验收样例](./验收样例.csv) · [字段字典](./字段字典.csv) · [关联全局配置](./关联全局配置.csv)
全局键按模块名称关联收录;其具体含义优先以正文已确认的规则为准。
| 配置键 | 原值 |
| --- | --- |
| BaseCollectionRewardNeed | 5 |
| CollectionUnlockStage | 6 |
## 8. 开发验收与禁止误写
| 输入 | 检查内容 | 预期 |
| --- | --- | --- |
| 读取collection中StringId=collection_001 | 查询本条配置并核对界面/配置输出 | equipmentIds=103,111,118;equipmentLevels=1,1,1;equipmentGrades=1,1,1;EMonoStatus=ATTACK_POWER;value=0.4 |
| 读取gameconfig中StringId=CollectionUnlockStage | 查询本条配置并核对界面/配置输出 | Values=6 |
验收样例覆盖已经确认的值;流程中的未知分支不能以本表通过代替规则确认。数值表内的空值、0和-1分别保留;升级数组不默认使用玩家等级作为索引。
## 9. 当前待补充边界
是否要求同时持有、是否消耗收藏装备、领取方式与收益单位尚待确认。
[返回总纲](../局外玩法设计文档_HEROLL_原作_v1.0.md) · [阅读规范](../文档规范与阅读说明.md)
@@ -0,0 +1,3 @@
用例ID,输入,检查动作,预期,验收范围
T09-01,读取collection中StringId=collection_001,查询本条配置并核对界面/配置输出,"equipmentIds=103,111,118;equipmentLevels=1,1,1;equipmentGrades=1,1,1;EMonoStatus=ATTACK_POWER;value=0.4",配置数值与显示;不覆盖未知执行分支
T09-02,读取gameconfig中StringId=CollectionUnlockStage,查询本条配置并核对界面/配置输出,Values=6,配置数值与显示;不覆盖未知执行分支
1 用例ID 输入 检查动作 预期 验收范围
2 T09-01 读取collection中StringId=collection_001 查询本条配置并核对界面/配置输出 equipmentIds=103,111,118;equipmentLevels=1,1,1;equipmentGrades=1,1,1;EMonoStatus=ATTACK_POWER;value=0.4 配置数值与显示;不覆盖未知执行分支
3 T09-02 读取gameconfig中StringId=CollectionUnlockStage 查询本条配置并核对界面/配置输出 Values=6 配置数值与显示;不覆盖未知执行分支