Initial import of HEROLL source and design documents

2026-10-26 16:05:39 +08:00
commit fdb55672c1
1846 changed files with 290692 additions and 0 deletions
@@ -0,0 +1,51 @@
+# 23 排行榜与赛季奖励：原作模块设计
+
+## 功能定位
+
+配置排行分组、环境排期、业务引用和名次奖励。
+
+## 功能流程
+
+玩法成绩关联对应排行 → 形成名次 → 按名次区间确定奖励 → 随关联赛季进入下一周期。
+
+以上按原作配置关系整理功能步骤，具体条件与数值见下文及规则说明。
+
+## 子功能构成
+
+| 子功能 | 设计内容 |
+| --- | --- |
+| 排行榜赛季配置 | isSeasonRanking/isAutoSeason描述周期类型，不同环境下的赛季、分组天数和键分别记录。 |
+| 玩法与排行榜关联 | RankKey连接排行，ERefType/referenceKey描述来源玩法或活动引用。 |
+| 名次区间奖励 | rankingDataKey定位榜单，minRank/maxRank确定名次范围，rewardId/rewardCount数组按位置记录奖励。 |
+
+## 功能构成与规则关系
+
+rankingdata 分别记录QA/Dev/Prod分组和赛季字段；rankingreferencedata 通过 RankKey/ERefType/referenceKey 关联业务；rankingrewarddata 以 minRank/maxRank 关联奖励。
+
+## 关键规则与数值
+
+| 原作规则 | 数值 | 来源 |
+| --- | --- | --- |
+| 历史万圣节活动第1名档：道具101×100、100×10000；奖励数组须按位置配对 | rankingDataKey=halloween2025Event；minRank=1；maxRank=1；rewardId=101,100；rewardCount=100,10000 | E-rankingrewarddata / StringId=halloween2025Event1-1_rankReward / CSV记录4 |
+
+## 完整数值表
+
+| 配置表 | 记录数 | 完整数据 |
+| --- | --- | --- |
+| rankingdata | 64 | [CSV](./03-表格/rankingdata.csv) |
+| rankingreferencedata | 8 | [CSV](./03-表格/rankingreferencedata.csv) |
+| rankingrewarddata | 25 | [CSV](./03-表格/rankingrewarddata.csv) |
+
+[规则说明](./02-规则说明.md) · [数值说明](./03-数值说明.md) · [字段字典](./03-表格/字段字典.csv) · [数组逐项明细](./03-表格/数组逐项明细.csv)
+
+[返回总纲](../00-局外系统模块总纲.md)
+
+## 相关功能模块
+
+| 模块 | 关联内容 |
+| --- | --- |
+| [通行证与赛季](../17-通行证与赛季/01-模块设计文档.md) | 负责通行证经验、任务、奖励轨道和赛季开放。 |
+| [Raid讨伐](../21-Raid讨伐/01-模块设计文档.md) | 管理讨伐门票、赛季预设、试用宠物、分数奖励与最高分档。 |
+| [药水竞技与段位](../22-药水竞技与段位/01-模块设计文档.md) | 管理竞技药水养成、匹配门票、段位MMR和竞技加成。 |
+| [赛季活动与超级球](../24-赛季活动与超级球/01-模块设计文档.md) | 管理活动排期、活动任务、兑换时段、转盘及超级球奖池。 |
+