Initial import of HEROLL source and design documents
This commit is contained in:
toshiocn
@@ -0,0 +1,106 @@
|
||||
# 排行榜与赛季奖励：原作设计与规则
|
||||
|
||||
版本：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)
|
||||
Reference in New Issue
Block a user