Initial import of HEROLL source and design documents

HEROLL_OUTGAME_2.0.1/22-药水竞技与段位/01-模块设计文档.md

@@ -0,0 +1,61 @@
+# 22 药水竞技与段位：原作模块设计
+
+## 功能定位
+
+管理竞技药水养成、匹配门票、段位MMR和竞技加成。
+
+## 功能流程
+
+养成竞技药水 → 配置竞技效果与重量 → 使用门票参加竞技 → 按MMR与段位配置形成竞技进度和奖励。
+
+以上按原作配置关系整理功能步骤，具体条件与数值见下文及规则说明。
+
+## 子功能构成
+
+| 子功能 | 设计内容 |
+| --- | --- |
+| 竞技药水成长 | 重量、冷却、主效果和额外效果各有基础与增量字段；needPiece和needCost保留升级投入，isBuff/isPercent区分效果类别和数值标记。 |
+| 竞技角色基础属性 | 以EMonoStatus读取value，形成竞技模式独立基础属性。 |
+| 竞技赛季与门票 | targetSeason决定适用赛季，searchMmrRange/searchRange记录匹配范围参数，门票上限、恢复秒数及商品顺序另列。 |
+| 竞技加成条件 | EPotionBattleBonus/value描述效果，mmrBonus、disapplyTier和bonusKey保存关联条件，isPercent标记百分比属性。 |
+| 竞技加成名称 | StringId连接加成键，titleKey为展示名称引用。 |
+| 段位赛季关联 | gameMode与followingPassId关联模式及通行证，mmrKey选择评分键，resetSeasonAdjustTier保存赛季调整量。 |
+| 竞技积分修正参数 | cpGap及关联键描述战力差档，baseWinMMR/baseLoseMMR给基础变化，gapCorrection/extraCorrection/finalCorrection是分开的修正字段。 |
+| 段位阶梯与奖励 | gameMode和tier定位段位，minMMR/maxMMR/stepMMR配置评分档，properCp、stepPassXP保存对应战力与通行证经验参数。 |
+
+## 功能构成与规则关系
+
+battlepotion 定义重量/冷却/效果基础值与增量、needPiece/needCost；potionbattleconfig 定义匹配范围与门票；ranktier 给出MMR区间和阶梯；rankmmradjust 存储多段修正参数，rankbasedata 关联通行证和赛季重置调整。
+
+## 关键规则与数值
+
+| 原作规则 | 数值 | 来源 |
+| --- | --- | --- |
+| 竞技setting2配置：10张上限、3600秒恢复；限定targetSeason列表 | targetSeason=4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19；searchMmrRange=0,900；searchRange=100；maxTicketCount=10；ticketChargeTime=3600；isRelayProduct=True | E-potionbattleconfig / StringId=setting2 / CSV记录4 |
+| 竞技跟随potionBattlePass赛季；重置调整字段=-5，不直接解释为MMR减少5 | followingPassId=potionBattlePass；mmrKey=potionBattle；resetSeasonAdjustTier=-5 | E-rankbasedata / StringId=potionBattle / CSV记录4 |
+
+## 完整数值表
+
+| 配置表 | 记录数 | 完整数据 |
+| --- | --- | --- |
+| battlepotion | 10 | [CSV](./03-表格/battlepotion.csv) |
+| battleplayerdefaultstat | 13 | [CSV](./03-表格/battleplayerdefaultstat.csv) |
+| potionbattleconfig | 2 | [CSV](./03-表格/potionbattleconfig.csv) |
+| potionbattlebonus | 13 | [CSV](./03-表格/potionbattlebonus.csv) |
+| potionbattlebonuskey | 5 | [CSV](./03-表格/potionbattlebonuskey.csv) |
+| rankbasedata | 1 | [CSV](./03-表格/rankbasedata.csv) |
+| rankmmradjust | 1 | [CSV](./03-表格/rankmmradjust.csv) |
+| ranktier | 6 | [CSV](./03-表格/ranktier.csv) |
+
+[规则说明](./02-规则说明.md) · [数值说明](./03-数值说明.md) · [字段字典](./03-表格/字段字典.csv) · [数组逐项明细](./03-表格/数组逐项明细.csv)
+
+[返回总纲](../00-局外系统模块总纲.md)
+
+## 相关功能模块
+
+| 模块 | 关联内容 |
+| --- | --- |
+| [资源背包与体力](../02-资源背包与体力/01-模块设计文档.md) | 统一道具类型、礼包内容、资源来源以及大厅到局内的资源映射。 |
+| [通行证与赛季](../17-通行证与赛季/01-模块设计文档.md) | 负责通行证经验、任务、奖励轨道和赛季开放。 |
+| [排行榜与赛季奖励](../23-排行榜与赛季奖励/01-模块设计文档.md) | 配置排行分组、环境排期、业务引用和名次奖励。 |
+