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,136 @@
+# 抽卡与保底：原作设计与规则
+
+版本：HEROLL 2.0.1 原作还原文档 v1.0。
+
+## 1. 功能定位
+
+抽卡由三个部分组成：玩家点击的抽卡按钮、按钮指向的奖励池、该池的保底规则。它们必须按池类型关联，不能按按钮名称或显示文字推断价格和保底。
+
+## 2. 主要状态
+
+下面是开发阅读所需的概念状态，属于开发映射，不要求与原作内部字段同名。
+
+| 状态 | 用途 |
+| --- | --- |
+| 抽卡池类型 | 决定奖励候选 |
+| 按钮档 | 决定抽数和消费 |
+| 池保底计数 | 按池区分 |
+| 广告周期使用状态 | 独立于付费次数 |
+| 替代道具余额 | 用于展示抵扣 |
+
+## 3. 功能规则
+
+### 3.1 按钮与消费
+
+shopGacha单抽配置钻石30、十连300。替代道具为204，抵扣字段30表示单道具可替代的资源量，不能显示成每抽消耗30张券。另有消耗资源110×35的按钮及每日广告按钮。
+
+### 3.2 奖励池
+
+奖励行同时记录类型、品质、ID、数量和权重。相同池类型才属于同一候选组；奖励ID为-1时表示指定类型全池，仍须保留奖励类型。
+
+### 3.3 保底
+
+高级装备池20次保底、提前命中重置标记False；增强装备池50次、重置标记False；坐骑池400次、重置标记True。坐骑记录名字虽带50，真实次数以400为准。
+
+### 3.4 概率表达
+
+配置权重先按池分组再讨论归一化，不能将某行权重100直接写成100%掉落。十连如何逐次推进保底及命中保底的优先级仍需要原作执行证据。
+
+## 4. 操作流程
+
+以下顺序用于拆解功能；涉及未确认的结算时机，以本章末尾具体缺口为准。
+
+1. 由按钮找到池类型、抽数、成本和免费广告标记。
+2. 读取同池候选与保底规则，展示价格及保底目标。
+3. 抽取结果保留奖励类型、ID、数量，交给对应内容模块展示。
+4. 更新计数的精确时点及十连分支待确认，不把整次十连当作一次保底进度。
+
+## 5. 关键数值与计算
+
+| 项目 | 数值 | 状态 |
+| --- | --- | --- |
+| shopGacha单抽：道具101消耗30，存在替代道具204 | gachaCount=1；needItemID=101；needCount=30；isAlterBtn=True；alterItemID=204；alterCount=30 | 原作配置确认 |
+| shopGacha十连：道具101消耗300；抵扣值并非已确认券消耗数 | gachaCount=10；needItemID=101；needCount=300；alterItemID=204；alterCount=30 | 原作配置确认 |
+| 高级装备保底次数及提前命中重置标记 | type=advancedEquipmentGacha；ceilCount=20；isResetBeforeCeil=False；ceilRewardString=advancedEquipmentGacha_EQUIPMENT_3_-1_FALSE_1 | 原作配置确认 |
+| 增强装备保底次数及提前命中重置标记 | type=enhancedEquipmentGacha；ceilCount=50；isResetBeforeCeil=False；ceilRewardString=enhancedEquipmentGacha_EQUIPMENT_3_-1_TRUE_1 | 原作配置确认 |
+| 坐骑保底必须读取ceilCount=400；StringId尾部50不是实际次数 | type=mount_Gacha；ceilCount=400；isResetBeforeCeil=True；ceilRewardString=mount_Gacha_ITEM_0_169_FALSE_1 | 原作配置确认 |
+
+### 5.A 权重检查公式
+
+对指定池、并假定该池所有记录均按权重参与时，`P(i)=weight(i)/Σweight(pool)`。保底和动态筛选不在此式内，见[条件概率检查](./抽卡条件概率.csv)。
+
+### 抽卡操作与成本（全表）
+
+| ID | 名称/键 | 类型/分组 | 抽取次数 | 免费标记 | 广告按钮标记 | 消耗道具ID | 消耗数量 |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| 1 | shopGacha_0_1 | shopGacha | 1 | False | False | 110 | 35 |
+| 2 | shopGacha_1_1 | shopGacha | 1 | False | False | 101 | 30 |
+| 3 | shopGacha_2_10 | shopGacha | 10 | False | False | 101 | 300 |
+| 4 | shopGacha_3_1 | shopGacha | 1 | False | True |  |  |
+| 5 | relicGacha_0_1 | relicGacha | 1 | False | True |  |  |
+| 6 | relicGacha_1_1 | relicGacha | 1 | False | False | 125 | 100 |
+| 7 | relicGacha_2_5 | relicGacha | 5 | False | False | 125 | 500 |
+| 8 | advancedRelicGacha_0_1 | advancedRelicGacha | 1 | False | True |  |  |
+| 9 | advancedRelicGacha_1_1 | advancedRelicGacha | 1 | False | False | 125 | 500 |
+| 10 | advancedRelicGacha_2_5 | advancedRelicGacha | 5 | False | False | 125 | 2500 |
+| 11 | equipmentGacha_0_1 | equipmentGacha | 1 | False | True |  |  |
+| 12 | equipmentGacha_1_1 | equipmentGacha | 1 | False | False | 101 | 20 |
+| 13 | equipmentGacha_2_5 | equipmentGacha | 5 | False | False | 101 | 100 |
+| 14 | advancedEquipmentGacha_0_1 | advancedEquipmentGacha | 1 | False | True |  |  |
+| 15 | advancedEquipmentGacha_1_1 | advancedEquipmentGacha | 1 | False | False | 101 | 50 |
+| 16 | advancedEquipmentGacha_2_10 | advancedEquipmentGacha | 10 | False | False | 101 | 500 |
+| 17 | enhancedEquipmentGacha_0_1 | enhancedEquipmentGacha | 1 | False | False | 101 | 100 |
+| 18 | enhancedEquipmentGacha_1_10 | enhancedEquipmentGacha | 10 | False | False | 101 | 1000 |
+| 19 | superballNormalGacha_0_1 | superballNormalGacha | 1 | False | True |  |  |
+| 20 | superballAdvancedGacha_0_1 | superballAdvancedGacha | 1 | True | False |  |  |
+| 21 | superballEnhancedGacha_0_1 | superballEnhancedGacha | 1 | False | True |  |  |
+| 22 | mount_Gacha_0_1 | mount_Gacha | 1 | False | False | 167 | 1 |
+| 23 | mount_Gacha_1_10 | mount_Gacha | 10 | False | False | 167 | 10 |
+
+### 抽卡保底（全表）
+
+| ID | 名称/键 | 类型/分组 | 保底次数 | 保底前命中是否重置标记 | 保底奖励Gacha字符串键 |
+| --- | --- | --- | --- | --- | --- |
+| 1 | advancedEquipmentGacha20 | advancedEquipmentGacha | 20 | False | advancedEquipmentGacha_EQUIPMENT_3_-1_FALSE_1 |
+| 2 | enhancedEquipmentGacha50 | enhancedEquipmentGacha | 50 | False | enhancedEquipmentGacha_EQUIPMENT_3_-1_TRUE_1 |
+| 3 | mount_00_Gacha50 | mount_Gacha | 400 | True | mount_Gacha_ITEM_0_169_FALSE_1 |
+
+## 6. 原作中文内容
+
+中文名称和效果使用原作文本；{0}、{B}等占位符未确认绑定时保留，文字不能代替参数公式。
+
+本模块主要由数值和键值组成，原作文本对照见同目录CSV。
+
+## 7. 开发权威表
+
+| 配置用途 | 权威原字段表 | 记录数 | 开发阅读表 |
+| --- | --- | --- | --- |
+| 抽卡操作与成本 | [gachatype.csv](./gachatype.csv) | 23 | [中文目录](./gachatype-中文目录.csv) |
+| 抽卡候选奖励 | [gacha.csv](./gacha.csv) | 60 | [中文目录](./gacha-中文目录.csv) |
+| 抽卡保底 | [gachaceildata.csv](./gachaceildata.csv) | 3 | [中文目录](./gachaceildata-中文目录.csv) |
+
+[执行规则](./执行规则.csv) · [状态字段](./状态字段.csv) · [验收样例](./验收样例.csv) · [字段字典](./字段字典.csv) · [关联全局配置](./关联全局配置.csv)
+
+全局键按模块名称关联收录；其具体含义优先以正文已确认的规则为准。
+
+| 配置键 | 原值 |
+| --- | --- |
+| enhancedGachaUnlockStage | 2 |
+
+## 8. 开发验收与禁止误写
+
+| 输入 | 检查内容 | 预期 |
+| --- | --- | --- |
+| 读取gachatype中StringId=shopGacha_1_1 | 查询本条配置并核对界面/配置输出 | gachaCount=1；needItemID=101；needCount=30；isAlterBtn=True；alterItemID=204；alterCount=30 |
+| 读取gachatype中StringId=shopGacha_2_10 | 查询本条配置并核对界面/配置输出 | gachaCount=10；needItemID=101；needCount=300；alterItemID=204；alterCount=30 |
+| 读取gachaceildata中StringId=advancedEquipmentGacha20 | 查询本条配置并核对界面/配置输出 | type=advancedEquipmentGacha；ceilCount=20；isResetBeforeCeil=False；ceilRewardString=advancedEquipmentGacha_EQUIPMENT_3_-1_FALSE_1 |
+| 读取gachaceildata中StringId=enhancedEquipmentGacha50 | 查询本条配置并核对界面/配置输出 | type=enhancedEquipmentGacha；ceilCount=50；isResetBeforeCeil=False；ceilRewardString=enhancedEquipmentGacha_EQUIPMENT_3_-1_TRUE_1 |
+| 读取gachaceildata中StringId=mount_00_Gacha50 | 查询本条配置并核对界面/配置输出 | type=mount_Gacha；ceilCount=400；isResetBeforeCeil=True；ceilRewardString=mount_Gacha_ITEM_0_169_FALSE_1 |
+
+验收样例覆盖已经确认的值；流程中的未知分支不能以本表通过代替规则确认。数值表内的空值、0和-1分别保留；升级数组不默认使用玩家等级作为索引。
+
+## 9. 当前待补充边界
+
+十连逐抽结算、券抵扣不足时的组合支付、跨池计数以及保底命中顺序尚待确认。
+
+[返回总纲](../局外玩法设计文档_HEROLL_原作_v1.0.md) · [阅读规范](../文档规范与阅读说明.md)