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

版本：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](./rankingdata.csv) | 64 | [中文目录](./rankingdata-中文目录.csv) |
| 玩法与排行榜关联 | [rankingreferencedata.csv](./rankingreferencedata.csv) | 8 | [中文目录](./rankingreferencedata-中文目录.csv) |
| 名次区间奖励 | [rankingrewarddata.csv](./rankingrewarddata.csv) | 25 | [中文目录](./rankingrewarddata-中文目录.csv) |

[执行规则](./执行规则.csv) · [状态字段](./状态字段.csv) · [验收样例](./验收样例.csv) · [字段字典](./字段字典.csv) · [关联全局配置](./关联全局配置.csv)

## 8. 开发验收与禁止误写

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

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

## 9. 当前待补充边界

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

[返回总纲](../局外玩法设计文档_HEROLL_原作_v1.0.md) · [阅读规范](../文档规范与阅读说明.md)