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

版本：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](./seasoneventminigamedata.csv) | 5 | [中文目录](./seasoneventminigamedata-中文目录.csv) |
| 泡泡小游戏关卡模板 | [bubbleshooterminigame.csv](./bubbleshooterminigame.csv) | 37 | [中文目录](./bubbleshooterminigame-中文目录.csv) |
| 拆卡包成本与奖励 | [cardunpackingeventgame.csv](./cardunpackingeventgame.csv) | 3 | [中文目录](./cardunpackingeventgame-中文目录.csv) |
| 抓娃娃奖励配置 | [clawcraneminigame.csv](./clawcraneminigame.csv) | 10 | [中文目录](./clawcraneminigame-中文目录.csv) |
| 骰子投注档 | [dicebeteventgame.csv](./dicebeteventgame.csv) | 11 | [中文目录](./dicebeteventgame-中文目录.csv) |
| 骰子机器奖励组合 | [dicemachine.csv](./dicemachine.csv) | 13 | [中文目录](./dicemachine-中文目录.csv) |
| 拼形小游戏模板 | [herobodyminigame.csv](./herobodyminigame.csv) | 16 | [中文目录](./herobodyminigame-中文目录.csv) |
| 弹珠落点奖励 | [plinko.csv](./plinko.csv) | 8 | [中文目录](./plinko-中文目录.csv) |
| 弹珠广告增益 | [plinkoad.csv](./plinkoad.csv) | 4 | [中文目录](./plinkoad-中文目录.csv) |
| 弹珠容量与恢复 | [plinkolevel.csv](./plinkolevel.csv) | 121 | [中文目录](./plinkolevel-中文目录.csv) |
| 通用转盘奖励池 | [roulettedata.csv](./roulettedata.csv) | 22 | [中文目录](./roulettedata-中文目录.csv) |
| 刮奖活动日奖励 | [spitoeventdailyreward.csv](./spitoeventdailyreward.csv) | 7 | [中文目录](./spitoeventdailyreward-中文目录.csv) |
| 刮奖候选奖励 | [spitoeventreward.csv](./spitoeventreward.csv) | 2 | [中文目录](./spitoeventreward-中文目录.csv) |

[执行规则](./执行规则.csv) · [状态字段](./状态字段.csv) · [验收样例](./验收样例.csv) · [字段字典](./字段字典.csv) · [关联全局配置](./关联全局配置.csv)

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

| 配置键 | 原值 |
| --- | --- |
| 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. 当前待补充边界

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

[返回总纲](../局外玩法设计文档_HEROLL_原作_v1.0.md) · [阅读规范](../文档规范与阅读说明.md)