HEROLL/HEROLL_OUTGAME_DEV_v1.0/23-排行榜与赛季奖励/设计与规则.md

排行榜与赛季奖励：原作设计与规则

版本：HEROLL 2.0.1 原作还原文档 v1.0。

1. 功能定位

排行榜连接玩法成绩和名次奖励。不同榜单可以按赛季或自动周期运行；奖励应按榜单键和名次区间读取，不按界面标题匹配。

2. 主要状态

下面是开发阅读所需的概念状态，属于开发映射，不要求与原作内部字段同名。

状态	用途
榜单键和赛季	确定排行榜实例
当前名次	用于奖励区间匹配
玩法引用	确定成绩来源
奖励档	定位内容

3. 功能规则

3.1 榜单关联

引用表以排行键、引用类型和来源键连接玩法或活动。名字相近的活动不自动共用同一榜。

3.2 名次奖励

奖励按榜单键和最小最大名次配置；ID与数量为并列数组，必须按位置配对。2025万圣节活动第1名配置钻石100和金币10000。

3.3 周期

是否赛季排行与是否自动赛季是独立标记；不同环境排期字段完整保留，开发展示以明确选定的排期域为准。

4. 操作流程

以下顺序用于拆解功能；涉及未确认的结算时机，以本章末尾具体缺口为准。

1. 由玩法或活动找到对应榜单键。
2. 显示当前榜单赛季和名次。
3. 按本榜名次区间展示奖励预览。

5. 关键数值与计算

项目	数值	状态
历史万圣节活动第1名档：道具101×100、100×10000；奖励数组须按位置配对	rankingDataKey=halloween2025Event；minRank=1；maxRank=1；rewardId=101,100；rewardCount=100,10000	原作配置确认

名次区间奖励（全表）

ID	名称/键	rankingDataKey	名次区间下界	名次区间上界	奖励ID（按奖励类型解析）	奖励数量
100	halloween2025Event1-1_rankReward	halloween2025Event	1	1	101,100	100,10000
101	halloween2025Event2-2_rankReward	halloween2025Event	2	2	101,100	80,8000
102	halloween2025Event3-3_rankReward	halloween2025Event	3	3	101,100	60,6000
103	halloween2025Event4-10_rankReward	halloween2025Event	4	10	101,100	30,3000
104	halloween2025Event11-100_rankReward	halloween2025Event	11	100	101,100	10,1000
105	christmas2025Event1-1_rankReward	christmas2025Event	1	1	101,100	150,30000
106	christmas2025Event2-2_rankReward	christmas2025Event	2	2	101,100	120,25000
107	christmas2025Event3-3_rankReward	christmas2025Event	3	3	101,100	100,20000
108	christmas2025Event4-10_rankReward	christmas2025Event	4	10	101,100	50,15000
109	christmas2025Event11-100_rankReward	christmas2025Event	11	100	101,100	10,10000
110	firstAnniversary2026Event1-1_rankReward	firstAnniversary2026Event	1	1	101,100	150,30000
111	firstAnniversary2026Event2-2_rankReward	firstAnniversary2026Event	2	2	101,100	120,25000
112	firstAnniversary2026Event3-3_rankReward	firstAnniversary2026Event	3	3	101,100	100,20000
113	firstAnniversary2026Event4-10_rankReward	firstAnniversary2026Event	4	10	101,100	50,15000
114	firstAnniversary2026Event11-100_rankReward	firstAnniversary2026Event	11	100	101,100	10,10000
115	patrick2026Event1-1_rankReward	patrick2026Event	1	1	101,100	150,30000
116	patrick2026Event2-2_rankReward	patrick2026Event	2	2	101,100	120,25000
117	patrick2026Event3-3_rankReward	patrick2026Event	3	3	101,100	100,20000
118	patrick2026Event4-10_rankReward	patrick2026Event	4	10	101,100	50,15000
119	patrick2026Event11-100_rankReward	patrick2026Event	11	100	101,100	10,10000
120	summer2026Event1-1_rankReward	summer2026Event	1	1	101,100	150,30000
121	summer2026Event2-2_rankReward	summer2026Event	2	2	101,100	120,25000
122	summer2026Event3-3_rankReward	summer2026Event	3	3	101,100	100,20000
123	summer2026Event4-10_rankReward	summer2026Event	4	10	101,100	50,15000
124	summer2026Event11-100_rankReward	summer2026Event	11	100	101,100	10,10000

6. 原作中文内容

中文名称和效果使用原作文本；{0}、{B}等占位符未确认绑定时保留，文字不能代替参数公式。

本模块主要由数值和键值组成，原作文本对照见同目录CSV。

7. 开发权威表

配置用途	权威原字段表	记录数	开发阅读表
排行榜赛季配置	rankingdata.csv	64	中文目录
玩法与排行榜关联	rankingreferencedata.csv	8	中文目录
名次区间奖励	rankingrewarddata.csv	25	中文目录

执行规则 · 状态字段 · 验收样例 · 字段字典 · 关联全局配置

8. 开发验收与禁止误写

输入	检查内容	预期
读取rankingrewarddata中StringId=halloween2025Event1-1_rankReward	查询本条配置并核对界面/配置输出	rankingDataKey=halloween2025Event；minRank=1；maxRank=1；rewardId=101,100；rewardCount=100,10000

验收样例覆盖已经确认的值；流程中的未知分支不能以本表通过代替规则确认。数值表内的空值、0和-1分别保留；升级数组不默认使用玩家等级作为索引。

9. 当前待补充边界

同分排序、名次端点及周期结算时刻尚待确认。

返回总纲 · 阅读规范