HEROLL/HEROLL_OUTGAME_DEV_v1.0/25-活动小游戏与奖励池/设计与规则.md

活动小游戏与奖励池：原作设计与规则

版本：HEROLL 2.0.1 原作还原文档 v1.0。

1. 功能定位

活动小游戏包含泡泡模板、拆卡包、抓娃娃、骰子投注、骰子机器、拼形、弹珠和刮奖等。这里统一组织入口与奖励，但每种玩法保留自己的规则参数，不建立一个通用概率替代所有小游戏。

2. 主要状态

下面是开发阅读所需的概念状态，属于开发映射，不要求与原作内部字段同名。

状态	用途
小游戏包及活动键	定位玩法
游玩资源	对应单次消耗
玩法模板或档位	选择布局和奖励
弹珠容量恢复	专用状态
广告增益次数时间	专用状态

3. 功能规则

3.1 入口与资源

小游戏包同时配置初始资源、游玩资源、单次消耗与兑换资源。它们可能不是同一种道具，不能只记录一个“活动币”。

3.2 各类奖励池

拆卡包按包档给成本与奖励概率；抓娃娃还有胶囊档、品质、尺寸参数；刮奖有奖励列表和概率。概率字段相同名称不代表同一归一化范围。

3.3 弹珠

初始容量15，恢复900秒，即15分钟；该行等级原值-1。广告金钉每日最多3次，持续180秒；效果数组150、200、250、300、330保留原档，不自动当百分比。

3.4 布局模板

泡泡和拼形表描述行列布局，不是奖励表。布局配置与活动资源、排行引用分别维护。

4. 操作流程

以下顺序用于拆解功能；涉及未确认的结算时机，以本章末尾具体缺口为准。

1. 根据小游戏包读取入口资源及对应玩法。
2. 加载该玩法的模板、档位或候选奖励。
3. 展示本次收益及活动资源变化，弹珠恢复和广告增益单独显示。

5. 关键数值与计算

项目	数值	状态
Plinko初始球容量15、恢复900秒；level=-1保留原值	maxBallCount=15；chargeSecond=900；adKey=null；level=-1	原作配置确认
Plinko广告金钉：每日3次、buff180秒、升级效果数组	maxADPerDay=3；buffSecond=180；values=150,200,250,300,330	原作配置确认

弹珠容量与恢复（节选前5条与末3条，完整121条见CSV）

ID	名称/键	球容量	恢复秒数	adKey	阶段/等级
0	level0	15	900	null	-1
1	level1	20	900	adGoldPin	0
2	level2	25	900	adMultiplyArea	0
3	level3	30	900	adRewardUp	0
4	level4	35	900	adGoldPin	1
118	level118	65	900	null	-1
119	level119	65	900	null	-1
120	level120	65	900	null	-1

弹珠广告增益（全表）

ID	名称/键	每日广告次数	增益秒数	values
0	超级弹击	3	180	150,200,250,300,330
1	多重弹击	3	180	3,4,5,6,7,8,9,10
2	加速器	3	180	140, 150, 160
3	紧急补给器	3	-1	20,30,40

6. 原作中文内容

中文名称和效果使用原作文本；{0}、{B}等占位符未确认绑定时保留，文字不能代替参数公式。

来源表	ID	名称	效果/条件文本
plinkoad	0	超级弹击	接触到超级弹击的弹珠， / 变为可获得{0}%额外奖励的 / 超级弹珠。
plinkoad	1	多重弹击	经过该领域的弹珠增加{0}个。
plinkoad	2	加速器	奖励增加{0}%。
plinkoad	3	紧急补给器	立即获得{0}个弹珠

7. 开发权威表

配置用途	权威原字段表	记录数	开发阅读表
小游戏资源与活动入口	seasoneventminigamedata.csv	5	中文目录
泡泡小游戏关卡模板	bubbleshooterminigame.csv	37	中文目录
拆卡包成本与奖励	cardunpackingeventgame.csv	3	中文目录
抓娃娃奖励配置	clawcraneminigame.csv	10	中文目录
骰子投注档	dicebeteventgame.csv	11	中文目录
骰子机器奖励组合	dicemachine.csv	13	中文目录
拼形小游戏模板	herobodyminigame.csv	16	中文目录
弹珠落点奖励	plinko.csv	8	中文目录
弹珠广告增益	plinkoad.csv	4	中文目录
弹珠容量与恢复	plinkolevel.csv	121	中文目录
通用转盘奖励池	roulettedata.csv	22	中文目录
刮奖活动日奖励	spitoeventdailyreward.csv	7	中文目录
刮奖候选奖励	spitoeventreward.csv	2	中文目录

执行规则 · 状态字段 · 验收样例 · 字段字典 · 关联全局配置

全局键按模块名称关联收录；其具体含义优先以正文已确认的规则为准。

配置键	原值
MegaDiceRouletteRewardIDs	100,101,117,106,100,101,117,106
MegaDiceRouletteBaseRewardCount	5000,500,5,10,1000,100,10,20
MegaDiceRoulettePlusRewardCount	1000,100,1,2,100,10,1,2
ingameShopSpitoWeight	3,5,10

8. 开发验收与禁止误写

输入	检查内容	预期
读取plinkolevel中StringId=level0	查询本条配置并核对界面/配置输出	maxBallCount=15；chargeSecond=900；adKey=null；level=-1
读取plinkoad中StringId=adGoldPin	查询本条配置并核对界面/配置输出	maxADPerDay=3；buffSecond=180；values=150,200,250,300,330

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

9. 当前待补充边界

各小游戏的胜负判定、碰撞到奖励的映射以及奖励权重处理尚待补充。

返回总纲 · 阅读规范