HEROLL/HEROLL_OUTGAME_2.0.1/25-活动小游戏与奖励池/01-模块设计文档.md

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
bubbleshooterminigame	37	CSV
cardunpackingeventgame	3	CSV
clawcraneminigame	10	CSV
dicebeteventgame	11	CSV
dicemachine	13	CSV
herobodyminigame	16	CSV
plinko	8	CSV
plinkoad	4	CSV
plinkolevel	121	CSV
roulettedata	22	CSV
spitoeventdailyreward	7	CSV
spitoeventreward	2	CSV

规则说明 · 数值说明 · 字段字典 · 数组逐项明细

返回总纲

相关功能模块

模块	关联内容
资源背包与体力	统一道具类型、礼包内容、资源来源以及大厅到局内的资源映射。
排行榜与赛季奖励	配置排行分组、环境排期、业务引用和名次奖励。
赛季活动与超级球	管理活动排期、活动任务、兑换时段、转盘及超级球奖池。