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,71 @@
+# 25 活动小游戏与奖励池：原作模块设计
+
+## 功能定位
+
+归档活动小游戏入场资源、玩法模板、概率奖励和广告增益。
+
+## 功能流程
+
+进入对应活动小游戏 → 消耗指定资源或等待恢复 → 按游戏模板参与 → 获得对应奖励池收益；部分功能可获得广告增益。
+
+以上按原作配置关系整理功能步骤，具体条件与数值见下文及规则说明。
+
+## 子功能构成
+
+| 子功能 | 设计内容 |
+| --- | --- |
+| 小游戏资源与活动入口 | gamePackIndex定位玩法包，初始资源、游玩资源和消费量分别记录；兑换资源、排行榜及商品兑换组连接活动外围。 |
+| 泡泡小游戏关卡模板 | templateKey分组，isUse标记模板使用，rowOrder与bubbles描述关卡行序和布局。 |
+| 拆卡包成本与奖励 | packIndex区分包档，cost记录消耗，spriteTier描述展示档，rewardCount/prob保存奖励数量和概率参数。 |
+| 抓娃娃奖励配置 | goodProb/Prob保存概率参数，capsuleTier和grade区分胶囊品质，rewardType/rewardValue记录奖励，minSize/maxSize保留尺寸范围。 |
+| 骰子投注档 | setNumber、rewardCount和gap记录每档骰子目标、收益数量和间隔参数，胜负语义不从字段名补造。 |
+| 骰子机器奖励组合 | diceValues定义骰子组合，itemKey与rewardKey/rewardValue关联资源和奖励，value保存附加配置。 |
+| 拼形小游戏模板 | shapeName、ColumnSort和shapeRow记录形状及列行布局，imageName为图形资源引用。 |
+| 弹珠落点奖励 | ratio保存奖励权重参数，itemID/itemCount记录落点收益。 |
+| 弹珠广告增益 | maxADPerDay和buffSecond记录每日次数与持续秒数，values数组描述该增益不同档参数。 |
+| 弹珠容量与恢复 | maxBallCount和chargeSecond记录球容量与恢复秒数，adKey连接广告增益，level保存原等级索引。 |
+| 通用转盘奖励池 | rouletteKey分组，itemID/itemCount给奖励，tier和weight描述档位及候选权重。 |
+| 刮奖活动日奖励 | day定义奖励日序，rewardID/rewardCount给对应道具及数量。 |
+| 刮奖候选奖励 | itemIDList与itemCountList为并列奖励数组，percent为概率字段原值。 |
+
+## 功能构成与规则关系
+
+seasoneventminigamedata 描述 gamePackIndex 与 playItemUseCount；Plinko 独立配置球上限/恢复和广告buff；抓娃娃、拆卡包、刮奖、转盘等分别保留自己的概率字段和模板，不能混成统一抽卡池。
+
+## 关键规则与数值
+
+| 原作规则 | 数值 | 来源 |
+| --- | --- | --- |
+| Plinko初始球容量15、恢复900秒；level=-1保留原值 | maxBallCount=15；chargeSecond=900；adKey=null；level=-1 | E-plinkolevel / StringId=level0 / CSV记录4 |
+| Plinko广告金钉：每日3次、buff180秒、升级效果数组 | maxADPerDay=3；buffSecond=180；values=150,200,250,300,330 | E-plinkoad / StringId=adGoldPin / CSV记录4 |
+
+## 完整数值表
+
+| 配置表 | 记录数 | 完整数据 |
+| --- | --- | --- |
+| seasoneventminigamedata | 5 | [CSV](./03-表格/seasoneventminigamedata.csv) |
+| bubbleshooterminigame | 37 | [CSV](./03-表格/bubbleshooterminigame.csv) |
+| cardunpackingeventgame | 3 | [CSV](./03-表格/cardunpackingeventgame.csv) |
+| clawcraneminigame | 10 | [CSV](./03-表格/clawcraneminigame.csv) |
+| dicebeteventgame | 11 | [CSV](./03-表格/dicebeteventgame.csv) |
+| dicemachine | 13 | [CSV](./03-表格/dicemachine.csv) |
+| herobodyminigame | 16 | [CSV](./03-表格/herobodyminigame.csv) |
+| plinko | 8 | [CSV](./03-表格/plinko.csv) |
+| plinkoad | 4 | [CSV](./03-表格/plinkoad.csv) |
+| plinkolevel | 121 | [CSV](./03-表格/plinkolevel.csv) |
+| roulettedata | 22 | [CSV](./03-表格/roulettedata.csv) |
+| spitoeventdailyreward | 7 | [CSV](./03-表格/spitoeventdailyreward.csv) |
+| spitoeventreward | 2 | [CSV](./03-表格/spitoeventreward.csv) |
+
+[规则说明](./02-规则说明.md) · [数值说明](./03-数值说明.md) · [字段字典](./03-表格/字段字典.csv) · [数组逐项明细](./03-表格/数组逐项明细.csv)
+
+[返回总纲](../00-局外系统模块总纲.md)
+
+## 相关功能模块
+
+| 模块 | 关联内容 |
+| --- | --- |
+| [资源背包与体力](../02-资源背包与体力/01-模块设计文档.md) | 统一道具类型、礼包内容、资源来源以及大厅到局内的资源映射。 |
+| [排行榜与赛季奖励](../23-排行榜与赛季奖励/01-模块设计文档.md) | 配置排行分组、环境排期、业务引用和名次奖励。 |
+| [赛季活动与超级球](../24-赛季活动与超级球/01-模块设计文档.md) | 管理活动排期、活动任务、兑换时段、转盘及超级球奖池。 |
+