# 奖励触发机制

<cite>
**本文档引用的文件**
- [MissionComp.ts](file://assets/script/game/map/MissionComp.ts)
- [GameEvent.ts](file://assets/script/game/common/config/GameEvent.ts)
- [VictoryComp.ts](file://assets/script/game/map/VictoryComp.ts)
- [MissionHeroComp.ts](file://assets/script/game/map/MissionHeroComp.ts)
- [HeroViewComp.ts](file://assets/script/game/hero/HeroViewComp.ts)
- [Mon.ts](file://assets/script/game/hero/Mon.ts)
- [Mission.ts](file://assets/script/game/common/config/Mission.ts)
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts)
</cite>

## 目录
1. [简介](#简介)
2. [事件监听注册机制](#事件监听注册机制)
3. [战斗事件响应逻辑](#战斗事件响应逻辑)
4. [奖励发放触发流程](#奖励发放触发流程)
5. [失败情况下的奖励处理](#失败情况下的奖励处理)
6. [事件派发与数据更新链条](#事件派发与数据更新链条)
7. [常见异常排查方案](#常见异常排查方案)
8. [结论](#结论)

## 简介
本文档深入分析基于事件驱动的奖励触发机制，重点解析`MissionComp.ts`中`onLoad`方法注册的事件监听器。详细说明`do_mon_dead`、`do_hero_dead`等方法如何响应战斗事件并累积奖励数据，以及`fight_end`和`to_end_fight`方法中奖励发放的触发时机与条件判断逻辑。

**Section sources**
- [MissionComp.ts](file://assets/script/game/map/MissionComp.ts#L1-L20)

## 事件监听注册机制
在`MissionComp`组件的`onLoad`方法中，系统注册了多个关键的游戏事件监听器，包括`GameEvent.FightEnd`、`GameEvent.MonDead`、`GameEvent.HeroDead`等。这些监听器构成了奖励触发系统的核心基础，确保在特定游戏事件发生时能够及时响应并执行相应的奖励逻辑。

```mermaid
flowchart TD
A[onLoad] --> B[注册GameEvent.MissionStart]
A --> C[注册GameEvent.MonDead]
A --> D[注册GameEvent.HeroDead]
A --> E[注册GameEvent.FightEnd]
A --> F[注册GameEvent.MissionEnd]
A --> G[注册GameEvent.DO_AD_BACK]
```

**Diagram sources**
- [MissionComp.ts](file://assets/script/game/map/MissionComp.ts#L15-L21)

**Section sources**
- [MissionComp.ts](file://assets/script/game/map/MissionComp.ts#L15-L21)
- [GameEvent.ts](file://assets/script/game/common/config/GameEvent.ts#L1-L70)

## 战斗事件响应逻辑
当怪物死亡或英雄死亡事件发生时，系统会通过相应的事件处理器更新战斗状态数据。`do_mon_dead`方法在接收到`GameEvent.MonDead`事件后，会减少当前关卡中的怪物数量计数；而`do_hero_dead`方法在处理`GameEvent.HeroDead`事件时，会减少英雄数量，并在英雄全部阵亡时触发战斗结束事件。

```mermaid
sequenceDiagram
participant Mon as 怪物
participant HeroViewComp as HeroViewComp
participant MissionComp as MissionComp
Mon->>HeroViewComp : 被击败
HeroViewComp->>HeroViewComp : do_dead()
HeroViewComp->>HeroViewComp : 调度HeroDead事件
HeroViewComp->>MissionComp : dispatchEvent(GameEvent.HeroDead)
MissionComp->>MissionComp : do_hero_dead()
MissionComp->>MissionComp : 更新英雄数量
MissionComp->>MissionComp : 检查是否全部阵亡
```

**Diagram sources**
- [HeroViewComp.ts](file://assets/script/game/hero/HeroViewComp.ts#L570-L580)
- [MissionComp.ts](file://assets/script/game/map/MissionComp.ts#L58-L67)

**Section sources**
- [MissionComp.ts](file://assets/script/game/map/MissionComp.ts#L58-L67)
- [HeroViewComp.ts](file://assets/script/game/hero/HeroViewComp.ts#L570-L580)

## 奖励发放触发流程
奖励发放的触发主要通过`fight_end`和`to_end_fight`方法实现。当战斗结束条件满足时，系统会调度`GameEvent.FightEnd`事件，进而触发`fight_end`方法执行。该方法会在0.5秒延迟后清理战斗组件并重置游戏状态，确保奖励发放过程的稳定性和完整性。

```mermaid
flowchart TD
A[战斗结束条件满足] --> B[dispatchEvent(FightEnd)]
B --> C[fight_end方法执行]
C --> D[延迟0.5秒]
D --> E[设置smc.mission.play=false]
D --> F[设置smc.mission.pause=false]
D --> G[cleanComponents()]
G --> H[销毁HeroViewComp]
G --> I[销毁AtkConCom]
G --> J[销毁SkillViewCom]
```

**Diagram sources**
- [MissionComp.ts](file://assets/script/game/map/MissionComp.ts#L99-L114)

**Section sources**
- [MissionComp.ts](file://assets/script/game/map/MissionComp.ts#L99-L114)

## 失败情况下的奖励处理
在战斗失败的情况下，系统会通过`do_hero_dead`方法中的逻辑判断来处理奖励。当英雄数量减至零或以下时，系统会立即派发`GameEvent.FightEnd`事件，并携带`{victory:false}`参数，同时打开胜利/失败界面，传递当前累积的奖励数据和游戏数据。

```mermaid
flowchart TD
A[英雄死亡] --> B[do_hero_dead执行]
B --> C[英雄数量减1]
C --> D{英雄数量<=0?}
D --> |是| E[派发FightEnd事件]
D --> |否| F[继续战斗]
E --> G[打开胜利界面]
G --> H[传递rewards数组]
G --> I[传递game_data对象]
```

**Diagram sources**
- [MissionComp.ts](file://assets/script/game/map/MissionComp.ts#L62-L67)

**Section sources**
- [MissionComp.ts](file://assets/script/game/map/MissionComp.ts#L62-L67)
- [VictoryComp.ts](file://assets/script/game/map/VictoryComp.ts#L1-L74)

## 事件派发与数据更新链条
整个奖励触发系统依赖于清晰的事件派发与数据更新链条。从怪物死亡到最终奖励展示，每个环节都有明确的数据流转路径。系统使用`smc.vmdata.mission_data`作为共享数据存储，确保各个组件之间能够同步最新的战斗状态信息。

```mermaid
erDiagram
MONSTER ||--o{ MISSION_DATA : "死亡时"
HERO ||--o{ MISSION_DATA : "死亡时"
MISSION_DATA ||--o{ REWARDS : "累积"
MISSION_DATA ||--o{ GAME_DATA : "累积"
REWARDS ||--o{ VICTORY_UI : "显示"
GAME_DATA ||--o{ VICTORY_UI : "显示"
class MISSION_DATA {
int mon_num
int hero_num
float fight_time
int level
}
class REWARDS {
array rewards[]
}
class GAME_DATA {
int exp
int gold
int diamond
}
```

**Diagram sources**
- [MissionComp.ts](file://assets/script/game/map/MissionComp.ts#L23-L24)
- [VictoryComp.ts](file://assets/script/game/map/VictoryComp.ts#L19-L20)

**Section sources**
- [MissionComp.ts](file://assets/script/game/map/MissionComp.ts#L23-L24)
- [VictoryComp.ts](file://assets/script/game/map/VictoryComp.ts#L19-L20)

## 常见异常排查方案
在实际运行过程中，可能会遇到一些常见的异常情况。以下是针对这些异常的排查方案：

1. **事件未正确触发**：检查事件名称是否拼写正确，确认事件监听器是否已正确注册。
2. **奖励数据丢失**：验证`rewards`数组和`game_data`对象的初始化时机，确保在战斗开始前已完成初始化。
3. **界面显示异常**：检查`VictoryComp`组件的`onAdded`方法中数据接收逻辑，确保参数传递正确。
4. **性能问题**：监控`update`方法的执行频率，避免不必要的计算开销。

```mermaid
flowchart LR
A[问题现象] --> B{问题类型}
B --> |事件问题| C[检查事件名称]
B --> |数据问题| D[检查数据初始化]
B --> |界面问题| E[检查参数传递]
B --> |性能问题| F[优化update逻辑]
```

**Section sources**
- [MissionComp.ts](file://assets/script/game/map/MissionComp.ts#L133-L135)
- [VictoryComp.ts](file://assets/script/game/map/VictoryComp.ts#L32-L33)

## 结论
通过对`MissionComp.ts`中奖励触发逻辑的深入分析，我们了解到该系统采用事件驱动架构，通过注册和监听关键游戏事件来实现奖励的累积和发放。系统设计合理，各组件职责分明，数据流转清晰，为游戏的战斗奖励机制提供了可靠的支撑。