refactor(game): 移除已弃用的事件常量
- 删除 UpdateHero 和 UpdateFightHero 事件 - 移除 MISSION_UPDATE 事件常量 - 优化游戏事件枚举定义
This commit is contained in:
panw
342
.qoder/repowiki/zh/content/地图系统/肉鸽关卡配置/随机事件系统.md
Normal file
342
.qoder/repowiki/zh/content/地图系统/肉鸽关卡配置/随机事件系统.md
Normal file
@@ -0,0 +1,342 @@
|
||||
# 随机事件系统
|
||||
|
||||
<cite>
|
||||
**本文档引用的文件**
|
||||
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts)
|
||||
- [MissionMonComp.ts](file://assets/script/game/map/MissionMonComp.ts)
|
||||
- [GameEvent.ts](file://assets/script/game/common/config/GameEvent.ts)
|
||||
- [HeroAttrs.ts](file://assets/script/game/common/config/HeroAttrs.ts)
|
||||
- [GameUIConfig.ts](file://assets/script/game/common/config/GameUIConfig.ts)
|
||||
</cite>
|
||||
|
||||
## 目录
|
||||
1. [概述](#概述)
|
||||
2. [项目结构](#项目结构)
|
||||
3. [核心组件](#核心组件)
|
||||
4. [架构概览](#架构概览)
|
||||
5. [详细组件分析](#详细组件分析)
|
||||
6. [依赖关系分析](#依赖关系分析)
|
||||
7. [性能考虑](#性能考虑)
|
||||
8. [故障排除指南](#故障排除指南)
|
||||
9. [结论](#结论)
|
||||
|
||||
## 概述
|
||||
|
||||
随机事件系统是肉鸽模式（Roguelike）游戏的核心机制之一，它为玩家提供了不可预测的游戏体验。本文档详细分析了RogueConfig.ts中实现的随机事件机制，包括事件类型定义、概率配置、触发逻辑以及与游戏流程的集成方式。
|
||||
|
||||
该系统通过EventType枚举定义了四种基本事件类型：宝箱事件（Treasure）、陷阱事件（Trap）、增益事件（Buff）和减益事件（Debuff），并通过EventConfig配置对象实现了灵活的概率控制和效果描述。
|
||||
|
||||
## 项目结构
|
||||
|
||||
随机事件系统的核心文件位于游戏的地图模块中，主要包含以下关键组件：
|
||||
|
||||
```mermaid
|
||||
graph TB
|
||||
subgraph "随机事件系统架构"
|
||||
RogueConfig["RogueConfig.ts<br/>核心配置与算法"]
|
||||
MissionMonComp["MissionMonComp.ts<br/>事件处理控制器"]
|
||||
GameEvent["GameEvent.ts<br/>事件通信系统"]
|
||||
HeroAttrs["HeroAttrs.ts<br/>属性系统"]
|
||||
end
|
||||
subgraph "UI反馈系统"
|
||||
GameUIConfig["GameUIConfig.ts<br/>界面配置"]
|
||||
MessageSystem["消息系统"]
|
||||
end
|
||||
RogueConfig --> MissionMonComp
|
||||
MissionMonComp --> GameEvent
|
||||
MissionMonComp --> HeroAttrs
|
||||
GameEvent --> MessageSystem
|
||||
MessageSystem --> GameUIConfig
|
||||
```
|
||||
|
||||
**图表来源**
|
||||
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L1-L311)
|
||||
- [MissionMonComp.ts](file://assets/script/game/map/MissionMonComp.ts#L1-L240)
|
||||
|
||||
**章节来源**
|
||||
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L1-L50)
|
||||
- [MissionMonComp.ts](file://assets/script/game/map/MissionMonComp.ts#L1-L30)
|
||||
|
||||
## 核心组件
|
||||
|
||||
### EventType枚举定义
|
||||
|
||||
系统定义了四种基本的随机事件类型，每种类型都有明确的业务含义：
|
||||
|
||||
| 事件类型 | 描述 | 业务含义 |
|
||||
|---------|------|----------|
|
||||
| TREASURE | 宝箱事件 | 提供额外奖励，增加玩家收益 |
|
||||
| TRAP | 陷阱事件 | 造成伤害，增加游戏风险 |
|
||||
| BUFF | 增益事件 | 提供临时能力提升，改善玩家状态 |
|
||||
| DEBUFF | 减益事件 | 降低玩家能力，增加挑战难度 |
|
||||
|
||||
### EventConfig配置对象
|
||||
|
||||
每个事件类型都通过EventConfig对象进行详细配置，包含触发概率和效果描述：
|
||||
|
||||
| 配置项 | 宝箱事件 | 陷阱事件 | 增益事件 | 减益事件 |
|
||||
|--------|----------|----------|----------|----------|
|
||||
| 触发概率 | 30% | 25% | 25% | 20% |
|
||||
| 效果描述 | 获得额外奖励 | 受到一定伤害 | 获得临时增益效果 | 受到临时减益效果 |
|
||||
|
||||
### StageType事件关卡
|
||||
|
||||
事件关卡（StageType.EVENT）作为特殊的关卡类型，具有独特的触发条件和游戏流程融合方式。
|
||||
|
||||
**章节来源**
|
||||
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L40-L85)
|
||||
|
||||
## 架构概览
|
||||
|
||||
随机事件系统采用分层架构设计，确保了良好的模块化和可扩展性：
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant Player as "玩家"
|
||||
participant MissionComp as "MissionMonComp"
|
||||
participant RogueConfig as "RogueConfig"
|
||||
participant GameEvent as "GameEvent系统"
|
||||
participant UI as "UI反馈"
|
||||
Player->>MissionComp : 进入关卡
|
||||
MissionComp->>RogueConfig : getStageType()
|
||||
RogueConfig-->>MissionComp : 返回关卡类型
|
||||
MissionComp->>RogueConfig : getRandomEvent()
|
||||
RogueConfig-->>MissionComp : 返回事件类型
|
||||
MissionComp->>MissionComp : processRandomEvent()
|
||||
MissionComp->>GameEvent : 触发事件
|
||||
GameEvent->>UI : 显示事件效果
|
||||
Note over Player,UI : 随机事件处理流程
|
||||
```
|
||||
|
||||
**图表来源**
|
||||
- [MissionMonComp.ts](file://assets/script/game/map/MissionMonComp.ts#L102-L136)
|
||||
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L280-L311)
|
||||
|
||||
## 详细组件分析
|
||||
|
||||
### getRandomEvent函数实现
|
||||
|
||||
getRandomEvent函数是随机事件系统的核心算法，基于累积概率算法实现加权随机选择：
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
Start([开始随机事件选择]) --> InitRandom["生成随机数<br/>random = Math.random()"]
|
||||
InitRandom --> ResetCumulative["重置累积概率<br/>cumulativeProbability = 0"]
|
||||
ResetCumulative --> LoopEvents["遍历EventConfig中的事件类型"]
|
||||
LoopEvents --> AddProbability["累积概率<br/>cumulativeProbability += probability"]
|
||||
AddProbability --> CheckCondition{"random <= cumulativeProbability?"}
|
||||
CheckCondition --> |是| ReturnEvent["返回事件类型"]
|
||||
CheckCondition --> |否| NextEvent["检查下一个事件"]
|
||||
NextEvent --> LoopEvents
|
||||
ReturnEvent --> End([结束])
|
||||
style Start fill:#e1f5fe
|
||||
style End fill:#e8f5e8
|
||||
style ReturnEvent fill:#fff3e0
|
||||
```
|
||||
|
||||
**图表来源**
|
||||
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L280-L311)
|
||||
|
||||
该算法的关键特性：
|
||||
- **累积概率计算**：通过逐步累加各事件的概率，实现加权随机选择
|
||||
- **边界条件处理**：确保所有事件都有被选中的机会
|
||||
- **性能优化**：O(n)时间复杂度，其中n为事件类型数量
|
||||
|
||||
### getStageType关卡类型判断
|
||||
|
||||
关卡类型判断逻辑实现了复杂的触发条件：
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
Start([开始关卡类型判断]) --> CheckStageNumber{"stageNumber % 5 == 0?"}
|
||||
CheckStageNumber --> |是| CheckLevel{"level == 3?"}
|
||||
CheckLevel --> |是| ReturnEvent["返回EVENT类型"]
|
||||
CheckLevel --> |否| ContinueCheck["继续检查"]
|
||||
CheckStageNumber --> |否| CheckTen{"stageNumber % 10 == 0?"}
|
||||
CheckTen --> |是| CheckTenLevel{"level == 5?"}
|
||||
CheckTenLevel --> |是| ReturnBoss["返回BOSS类型"]
|
||||
CheckTenLevel --> |否| CheckFour{"level == 4?"}
|
||||
CheckFour --> |是| ReturnElite["返回ELITE类型"]
|
||||
CheckFour --> |否| ReturnNormal["返回NORMAL类型"]
|
||||
CheckTen --> |否| CheckOneToNine{"1 <= stageNumber <= 9?"}
|
||||
CheckOneToNine --> |是| CheckFive{"level == 5?"}
|
||||
CheckFive --> |是| ReturnElite2["返回ELITE类型"]
|
||||
CheckFive --> |否| ReturnNormal2["返回NORMAL类型"]
|
||||
ContinueCheck --> CheckTen
|
||||
ReturnEvent --> End([结束])
|
||||
ReturnBoss --> End
|
||||
ReturnElite --> End
|
||||
ReturnNormal --> End
|
||||
ReturnElite2 --> End
|
||||
ReturnNormal2 --> End
|
||||
style Start fill:#e1f5fe
|
||||
style End fill:#e8f5e8
|
||||
style ReturnEvent fill:#fff3e0
|
||||
```
|
||||
|
||||
**图表来源**
|
||||
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L140-L170)
|
||||
|
||||
### 事件处理流程
|
||||
|
||||
事件处理通过MissionMonComp组件实现，包含完整的生命周期管理：
|
||||
|
||||
```mermaid
|
||||
classDiagram
|
||||
class MissionMonComp {
|
||||
-currentEvent : EventType | null
|
||||
-eventProcessed : boolean
|
||||
+do_mon_wave() : void
|
||||
+processRandomEvent() : void
|
||||
-generateMonstersFromStageConfig() : void
|
||||
-addToStageSpawnQueue() : void
|
||||
}
|
||||
class EventType {
|
||||
<<enumeration>>
|
||||
TREASURE
|
||||
TRAP
|
||||
BUFF
|
||||
DEBUFF
|
||||
}
|
||||
class RogueConfig {
|
||||
+getRandomEvent() : EventType | null
|
||||
+getStageType() : StageType
|
||||
+calculateMonsterCount() : number
|
||||
+calculateMonsterStrengthMultiplier() : number
|
||||
}
|
||||
MissionMonComp --> EventType : "使用"
|
||||
MissionMonComp --> RogueConfig : "调用"
|
||||
RogueConfig --> EventType : "返回"
|
||||
```
|
||||
|
||||
**图表来源**
|
||||
- [MissionMonComp.ts](file://assets/script/game/map/MissionMonComp.ts#L15-L35)
|
||||
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L40-L85)
|
||||
|
||||
**章节来源**
|
||||
- [MissionMonComp.ts](file://assets/script/game/map/MissionMonComp.ts#L102-L169)
|
||||
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L280-L311)
|
||||
|
||||
## 依赖关系分析
|
||||
|
||||
随机事件系统的依赖关系体现了清晰的分层架构：
|
||||
|
||||
```mermaid
|
||||
graph LR
|
||||
subgraph "外部依赖"
|
||||
ECS[ECS框架]
|
||||
OopsFramework[Oops Framework]
|
||||
GameEngine[Cocos Creator引擎]
|
||||
end
|
||||
subgraph "核心模块"
|
||||
RogueConfig[RogueConfig.ts]
|
||||
MissionMonComp[MissionMonComp.ts]
|
||||
GameEvent[GameEvent.ts]
|
||||
end
|
||||
subgraph "配置模块"
|
||||
HeroAttrs[HeroAttrs.ts]
|
||||
GameUIConfig[GameUIConfig.ts]
|
||||
end
|
||||
ECS --> MissionMonComp
|
||||
OopsFramework --> GameEvent
|
||||
GameEngine --> ECS
|
||||
RogueConfig --> MissionMonComp
|
||||
MissionMonComp --> GameEvent
|
||||
GameEvent --> GameUIConfig
|
||||
HeroAttrs --> MissionMonComp
|
||||
style RogueConfig fill:#e3f2fd
|
||||
style MissionMonComp fill:#f3e5f5
|
||||
style GameEvent fill:#e8f5e8
|
||||
```
|
||||
|
||||
**图表来源**
|
||||
- [MissionMonComp.ts](file://assets/script/game/map/MissionMonComp.ts#L1-L15)
|
||||
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L1-L20)
|
||||
|
||||
**章节来源**
|
||||
- [MissionMonComp.ts](file://assets/script/game/map/MissionMonComp.ts#L1-L20)
|
||||
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L1-L20)
|
||||
|
||||
## 性能考虑
|
||||
|
||||
随机事件系统在设计时充分考虑了性能优化：
|
||||
|
||||
### 算法复杂度分析
|
||||
- **getRandomEvent函数**：O(n)时间复杂度，其中n为事件类型数量
|
||||
- **getStageType函数**：O(1)时间复杂度，固定条件判断
|
||||
- **事件处理**：单次事件处理时间复杂度为O(1)
|
||||
|
||||
### 内存使用优化
|
||||
- 事件配置采用静态常量定义，避免运行时内存分配
|
||||
- 事件类型使用枚举，减少字符串比较开销
|
||||
- 事件状态管理简洁，避免不必要的状态保存
|
||||
|
||||
### 扩展性设计
|
||||
- 新增事件类型只需修改EventType枚举和EventConfig配置
|
||||
- 事件效果处理采用switch语句，便于添加新的处理逻辑
|
||||
- 关卡类型判断逻辑支持未来扩展新的触发条件
|
||||
|
||||
## 故障排除指南
|
||||
|
||||
### 常见问题及解决方案
|
||||
|
||||
#### 事件触发概率异常
|
||||
**问题描述**：事件触发概率不符合预期
|
||||
**可能原因**：
|
||||
- EventConfig中的概率设置错误
|
||||
- 累积概率计算逻辑异常
|
||||
|
||||
**解决方案**：
|
||||
1. 检查EventConfig中各事件的概率总和是否为1
|
||||
2. 验证getRandomEvent函数的累积概率计算逻辑
|
||||
3. 添加调试日志输出随机数和累积概率值
|
||||
|
||||
#### 事件关卡触发时机错误
|
||||
**问题描述**：事件关卡在非预期关卡触发
|
||||
**可能原因**：
|
||||
- getStageType函数的关卡判断逻辑错误
|
||||
- 关卡参数传递不正确
|
||||
|
||||
**解决方案**：
|
||||
1. 检查关卡号和等级参数的传递
|
||||
2. 验证getStageType函数中的模运算逻辑
|
||||
3. 添加关卡类型判断的日志输出
|
||||
|
||||
#### 事件效果未生效
|
||||
**问题描述**：事件发生但效果未体现
|
||||
**可能原因**：
|
||||
- 事件处理逻辑缺失
|
||||
- UI反馈未正确触发
|
||||
|
||||
**解决方案**：
|
||||
1. 检查MissionMonComp中的processRandomEvent函数
|
||||
2. 验证GameEvent系统的事件分发机制
|
||||
3. 确认UI层的消息接收和处理逻辑
|
||||
|
||||
**章节来源**
|
||||
- [MissionMonComp.ts](file://assets/script/game/map/MissionMonComp.ts#L120-L169)
|
||||
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L280-L311)
|
||||
|
||||
## 结论
|
||||
|
||||
随机事件系统通过精心设计的架构和算法，为肉鸽模式游戏提供了丰富且可控的随机体验。系统的主要优势包括：
|
||||
|
||||
### 设计优势
|
||||
- **模块化架构**：清晰的职责分离，便于维护和扩展
|
||||
- **灵活的概率控制**：支持动态调整事件触发概率
|
||||
- **完善的事件处理**：从触发到效果呈现的完整流程
|
||||
- **良好的性能表现**：高效的算法实现和内存使用
|
||||
|
||||
### 扩展建议
|
||||
1. **新增事件类型**：可以轻松添加复活、传送等新事件类型
|
||||
2. **概率动态调整**：可以根据游戏进程动态调整事件概率
|
||||
3. **事件效果增强**：支持更复杂的事件效果和组合效果
|
||||
4. **UI反馈完善**：集成更丰富的视觉和音效反馈
|
||||
|
||||
### 最佳实践
|
||||
- 保持事件概率的平衡性，避免过于极端的结果
|
||||
- 提供清晰的事件效果说明，帮助玩家理解游戏机制
|
||||
- 实现事件历史记录功能，增加游戏的策略深度
|
||||
- 建立完善的测试机制，确保事件系统的稳定性
|
||||
|
||||
该随机事件系统为肉鸽游戏提供了坚实的基础，通过合理的扩展和优化，可以进一步提升游戏的趣味性和挑战性。
|
||||
Reference in New Issue
Block a user