# 砸罐子活动配置表说明

## 目录

- [配置文件清单](#配置文件清单)
- [配置字段说明](#配置字段说明)
- [代码架构](#代码架构)
- [核心逻辑流程](#核心逻辑流程)
- [主要类说明](#主要类说明)
- [配置生效步骤](#配置生效步骤)

---

## 配置文件清单

| 文件名 | 说明 |
|--------|------|
| `EventSmashMain.json` | 主配置表 - 活动基础配置、礼包配置 |
| `EventSmashReward.json` | 奖励配置表 - 奖励掉落和权重 |
| `EventSmashCollection.json` | 收集配置表 - 收集品系统配置 |
| `FishingEvent_SmashPot.json` | 活动注册配置 - 在FishingEvent表中添加活动入口 |

## EventSmashMain.json 字段说明

| 字段 | 类型 | 必填 | 说明 | 示例值 |
|------|------|------|------|--------|
| ID | int | 是 | 活动ID | 1 |
| ItemID | int | 是 | 活动道具ID (公式: 70600+MOD(ID,1000)) | 70601 |
| UIPanel | string | 是 | 活动主面板 | EventSmashPotPanel |
| InfoPanel | string | 是 | 活动信息面板 | EventSmashPotInfoPanel |
| GuidePanel | string | 是 | 引导面板 | EventSmashPotGuidePanel |
| Icon | string | 是 | 道具图标资源 | icon_smash_pot#res=img |
| ChainPackID | int | 是 | 链式礼包ID (对应shop.packagemanager) | 1 |
| PackPackID | int | 是 | 直购礼包ID (对应shop.packagemanager) | 2 |
| ChainPackPanel | string | 是 | 链式礼包Panel | ChainPackPanel |
| PackPanel | string | 是 | 直购礼包Panel | PackPanel |
| AdPackId | int | 是 | 广告礼包ID (对应shop表) | 3 |
| CollectionIcon | list#sep=,),int | 是 | 收集品icon列表 | [1001,1002,1003] |

## EventSmashReward.json 字段说明

| 字段 | 类型 | 必填 | 说明 | 示例值 |
|------|------|------|------|--------|
| Id | int | 是 | 奖励ID | 1 |
| Drop | int | 是 | 奖励掉落 (对应Drop表) | 10001 |
| Weight | int | 是 | 权重 | 100 |

## EventSmashCollection.json 字段说明

| 字段 | 类型 | 必填 | 说明 | 示例值 |
|------|------|------|------|--------|
| ID | int | 是 | 收集ID (公式: stageID*100 + level) | 101 |
| CollectingRequirement | int | 是 | 收集要求数量 | 10 |
| CollectingRewardList | list#sep=,),int | 是 | 收集奖励列表 | [20001,20002] |
| FixedStageDropProb | float | 是 | 固定关卡掉落概率 | 0.5 |
| NormalStageDropProb | float | 是 | 普通关卡掉落概率 | 0.3 |
| DropCount | list#sep=,),int | 是 | 掉落数量 | [1,2,3] |

## FishingEvent 配置说明

需要在FishingEvent表中添加记录：

| 字段 | 说明 | 示例值 |
|------|------|--------|
| ID | 活动唯一ID | 9 |
| Type | 活动大类（7=特殊活动） | 7 |
| SubType | 活动小类（需分配） | 10 |
| RedirectID | 指向EventSmashMain表ID | 1 |
| TimeDefinition | 活动时间配置 | 见下方 |

### TimeDefinition 配置

```json
{
  "Type": "LimitedTime",
  "StartTime": "2024-01-01 00:00:00",
  "EndTime": "2024-12-31 23:59:59"
}
```

Type可选值：
- `Forever` - 永久活动
- `LimitedTime` - 限时活动
- `UserRegistration` - 用户注册时间
- `Daily` - 日活动
- `Weekly` - 周活动

## 配置示例

### 主配置 (EventSmashMain.json)
```json
[
  {
    "ID": 1,
    "ItemID": 70601,
    "UIPanel": "EventSmashPotPanel",
    "InfoPanel": "EventSmashPotInfoPanel",
    "GuidePanel": "EventSmashPotGuidePanel",
    "Icon": "icon_smash_pot#res=img",
    "ChainPackID": 1,
    "PackPackID": 2,
    "ChainPackPanel": "ChainPackPanel",
    "PackPanel": "PackPanel",
    "AdPackId": 3,
    "CollectionIcon": [1001,1002,1003]
  }
]
```

### 奖励配置 (EventSmashReward.json)
```json
[
  {
    "Id": 1,
    "Drop": 10001,
    "Weight": 100
  },
  {
    "Id": 2,
    "Drop": 10002,
    "Weight": 200
  }
]
```

### 收集配置 (EventSmashCollection.json)
```json
[
  {
    "ID": 101,
    "CollectingRequirement": 10,
    "CollectingRewardList": [20001,20002],
    "FixedStageDropProb": 0.5,
    "NormalStageDropProb": 0.3,
    "DropCount": [1,2,3]
  }
]
```

## Drop表配置说明

EventSmashReward中的Drop字段指向Drop表，需要在Drop表中配置对应的奖励道具。

EventSmashCollection中的CollectingRewardList指向Drop表，配置收集奖励。

## 配置生效步骤

1. 在FishingEvent表中添加活动记录（ID=9, Type=7, SubType=10, RedirectID=1）
2. 在EventSmashMain表中添加主配置（ID=1）
3. 在EventSmashReward表中添加奖励配置
4. 在EventSmashCollection表中添加收集配置
5. 在Drop表中配置奖励道具
6. 在shop.packagemanager表中配置链式礼包和直购礼包
7. 在shop表中配置广告礼包
8. 重新编译客户端代码

---

## 代码架构

### 文件结构

```
EventSmashPot/
├── Manager/
│   ├── EventSmashPotManager.cs      # 核心管理器
│   ├── EventSmashPotData.cs         # 活动数据类
│   ├── EventSmashPotDataEx.cs      # 数据扩展(预留)
│   └── EventSmashPotSentry.cs       # 哨兵检查
├── Data/
│   └── EventSmashCollectionData.cs # 收集品数据类
├── UIPanel/
│   ├── EventSmashPotPanel.cs        # 主面板
│   ├── EventSmashPotCell.cs         # 罐子格子组件
│   └── EventSmashPotInfoPanel.cs    # 信息面板(预留)
├── EventSmashPotEntranceButton.cs   # 活动入口按钮
└── README.md                        # 本说明文档
```

### 类说明

#### 1. EventSmashPotManager (核心管理器)

**继承**: `Activity.AEventDataManager<EventSmashPotData>`

**职责**:
- 活动数据刷新与管理
- Token(代币)管理
- 关卡奖励生成与发放
- 砸罐子核心逻辑
- 收集系统逻辑
- 礼包面板展示
- 红点状态管理

**核心方法**:

| 方法 | 说明 |
|------|------|
| `RefreshData()` | 刷新活动数据，触发关卡奖励生成 |
| `AddTokenToData()` | 添加代币 |
| `RemoveTokenFromData()` | 移除代币 |
| `GetCurrentTokenCount()` | 获取当前代币数量 |
| `SmashSingle()` | 砸单个罐子 |
| `SmashAll()` | 一键全砸(批量打开) |
| `GenerateStageRewards()` | 生成关卡奖励(核心算法) |
| `ShowFestPackPanel()` | 展示礼包面板 |
| `SetRedPoint()` | 设置红点状态 |

#### 2. EventSmashPotData (活动数据)

**继承**: `AEventData`, 实现 `IHasChainPack`

**核心属性**:

| 属性 | 类型 | 说明 |
|------|------|------|
| `CompletedStageCount` | int | 已完成关卡数量 |
| `OpenedGrids` | List<int> | 已打开的格子索引列表 |
| `StageRewardList` | List<int> | 当前关卡奖励ID列表 |
| `CollectionProgressPairs` | Dictionary<int, EventSmashCollectionData> | 收集进度映射 |
| `ChainProgress` | int | 链式礼包进度 |
| `ChainPackID` | int | 当前使用的礼包ID |
| `MainConfig` | EventSmashMain | 主配置(通过RedirectID获取) |

**核心方法**:

| 方法 | 说明 |
|------|------|
| `GetCollectionData()` | 获取指定收集ID的进度数据 |
| `GetAllCollectionConfigs()` | 获取所有收集配置 |
| `GetAllRewardConfigs()` | 获取所有奖励配置 |
| `RefreshCache()` | 刷新缓存，重置数据 |
| `SetChainPackID()` | 根据是否充值设置礼包ID |

#### 3. EventSmashCollectionData (收集品数据)

**核心属性**:

| 属性 | 类型 | 说明 |
|------|------|------|
| `CollectionID` | int | 收集品ID |
| `Amount` | int | 当前收集数量 |
| `Round` | int | 已完成轮次数 |
| `CollectionConfig` | EventSmashCollection | 收集配置(缓存) |

**核心方法**:

| 方法 | 说明 |
|------|------|
| `GetRewardDropID()` | 获取当前轮次对应的奖励DropID |

#### 4. EventSmashPotPanel (主面板)

**职责**: UI展示与交互

**核心组件**:

| 组件 | 说明 |
|------|------|
| `m_TokenText` | 代币数量显示 |
| `m_ProgressSliders` | 进度条数组 |
| `m_GridContainer` | 格子容器(GridLayoutGroup) |
| `m_CellPrefab` | 格子预制体 |
| `m_BtnSmashAll` | 一键全砸按钮 |
| `m_RoundText` | 关卡显示 |

**核心方法**:

| 方法 | 说明 |
|------|------|
| `InitManager()` | 初始化管理器 |
| `RefreshData()` | 刷新界面数据 |
| `UpdateGrids()` | 更新格子显示 |
| `OnCellClick()` | 格子点击事件 |
| `OnSmashAllClick()` | 一键全砸点击事件 |

#### 5. EventSmashPotCell (格子组件)

**职责**: 单个罐子格子的显示与交互

**核心组件**:

| 组件 | 说明 |
|------|------|
| `m_PotImage` | 罐子图片 |
| `m_ClickButton` | 点击按钮 |
| `m_OpenedObj` | 已打开状态显示对象 |
| `m_UnopenedObj` | 未打开状态显示对象 |
| `m_RewardIcon` | 奖励图标 |
| `m_RewardCountText` | 奖励数量文本 |

---

## 核心逻辑流程

### 1. 活动数据初始化流程

```
Start/进入活动
    ↓
EventSmashPotManager.RefreshData()
    ↓
EventSmashPotData.IsActive 检查
    ↓
GenerateStageRewards() 生成关卡奖励
    ↓
返回数据 → UI展示
```

### 2. 关卡奖励生成算法 (GenerateStageRewards)

```
1. 获取收集配置和奖励配置
2. 判断是第一关(isFirstStage = CompletedStageCount == 0)
3. 遍历收集配置:
   - 根据关卡类型选择概率(FixedStageDropProb / NormalStageDropProb)
   - 随机判定是否生成收集奖励
   - 根据Round循环获取CollectingRewardList中的DropID
   - 随机获取DropCount中的数量
4. 剩余格子从EventSmashReward按权重随机抽取
5. 打乱顺序(Shuffle)
6. 保存到StageRewardList
```

**概率说明**:
- 第一关(CompletedStageCount==0): 使用 `FixedStageDropProb`
- 后续关卡: 使用 `NormalStageDropProb`
- 每个收集配置独立判定，最多生成3个收集奖励

### 3. 砸罐子流程 (SmashSingle)

```
点击格子
    ↓
检查是否已打开 → 已打开则跳过
    ↓
检查代币是否足够(TokenCost)
    ↓
不足 → ShowFestPackPanel() 展示礼包
    ↓
足够:
    1. 扣除代币
    2. 标记格子为已打开
    3. 发放奖励(通过Drop获取道具)
    4. 检查收集品
    5. 检查关卡完成
    6. 保存数据
    7. 设置红点
    ↓
刷新UI
```

### 4. 一键全砸流程 (SmashAll)

```
点击一键全砸
    ↓
计算未打开格子数量 * 单价 = 总花费
    ↓
检查代币是否足够
    ↓
不足 → 提示
    ↓
足够:
    1. 扣除总代币
    2. 遍历所有未打开格子:
       - 标记为已打开
       - 发放奖励
       - 检查收集品
    3. 发送一次奖励显示
    4. 检查关卡完成
    5. 保存数据
    6. 设置红点
    ↓
刷新UI
```

### 5. 关卡完成逻辑 (CheckStageComplete)

```
打开格子数 >= 9
    ↓
CompletedStageCount++
    ↓
清空OpenedGrids
    ↓
清空StageRewardList
    ↓
GenerateStageRewards() 生成下一关奖励
```

### 6. 收集奖励领取逻辑

```
获得收集品
    ↓
Amount++
    ↓
检查是否达到要求(CollectingRequirement)
    ↓
达到要求:
    1. 领取奖励(通过Round获取CollectingRewardList中的DropID)
    2. Amount -= CollectingRequirement
    3. Round++
```

### 7. 礼包逻辑

**链式礼包/广告礼包选择**:

```
SetChainPackID()
    ↓
判断Condition_NoRechargeDay()是否满足
    ↓
满足(未充值) → ChainPackID = MainConfig.AdPackId
    ↓
不满足(已充值) → ChainPackID = MainConfig.ChainPackID
```

**礼包面板显示**:

```
ShowFestPackPanel()
    ↓
获取链式礼包数据
    ↓
判断ChainProgress >= ChainListCount(满)
    ↓
满 → 显示直购礼包面板(PackPanel)
    ↓
未满 → 显示链式礼包面板(ChainPackPanel)
```

### 8. 红点逻辑

**活动红点**:
- 条件: `IsActive && TokenCount > 0`

**礼包红点**:
- 条件: `chainPackData.RedPointIndex > 0`

---

## 关键配置对应关系

| 配置表 | 代码引用 | 说明 |
|--------|----------|------|
| EventSmashMain | `data.MainConfig` | 主配置，包含UI Panel名称、礼包ID等 |
| EventSmashReward | `data.GetAllRewardConfigs()` | 奖励池，按权重抽取 |
| EventSmashCollection | `data.GetAllCollectionConfigs()` | 收集系统配置 |
| FishingEvent | `data.FishingEvent` | 活动注册信息 |
| Drop表 | `PlayerItemData.GetItemDataByDropId()` | 奖励道具 |
| shop.packagemanager | `TbEventPackManager` | 链式礼包配置 |
| shop | `TbPack` | 直购礼包配置 |