# 肉鸽关卡配置系统

<cite>
**本文档引用的文件**
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts)
- [GameMap.ts](file://assets/script/game/map/GameMap.ts)
- [MissionMonComp.ts](file://assets/script/game/map/MissionMonComp.ts)
- [heroSet.ts](file://assets/script/game/common/config/heroSet.ts)
- [Mon.ts](file://assets/script/game/hero/Mon.ts)
- [MissionComp.ts](file://assets/script/game/map/MissionComp.ts)
- [MapModelComp.ts](file://assets/script/game/map/model/MapModelComp.ts)
- [MapViewComp.ts](file://assets/script/game/map/view/MapViewComp.ts)
</cite>

## 目录
1. [系统概述](#系统概述)
2. [核心架构](#核心架构)
3. [关卡类型系统](#关卡类型系统)
4. [怪物类型体系](#怪物类型体系)
5. [关卡配置规则](#关卡配置规则)
6. [随机事件系统](#随机事件系统)
7. [动态难度计算](#动态难度计算)
8. [关卡生成流程](#关卡生成流程)
9. [实际调用机制](#实际调用机制)
10. [扩展指南](#扩展指南)
11. [性能优化建议](#性能优化建议)
12. [总结](#总结)

## 系统概述

肉鸽关卡配置系统是一个高度程序化的关卡生成框架，专为Roguelike游戏设计。该系统通过智能算法动态生成具有递增难度的关卡，支持多种怪物类型、随机事件和平衡性调整。

### 主要特性

- **程序化关卡生成**：基于关卡号和等级自动计算关卡配置
- **动态难度曲线**：怪物数量和强度随关卡递增而增强
- **多样化关卡类型**：普通关卡、精英关卡、Boss关卡、事件关卡
- **随机事件系统**：包含奖励、陷阱、增益、减益等多种事件
- **灵活配置管理**：支持快速调整难度曲线和平衡性

## 核心架构

```mermaid
graph TB
subgraph "配置层"
A[RogueConfig.ts] --> B[StageType枚举]
A --> C[MonsterType枚举]
A --> D[EventType枚举]
A --> E[StageConfigRules]
A --> F[EventConfig]
end
subgraph "逻辑层"
G[getStageType] --> H[calculateMonsterCount]
G --> I[calculateMonsterStrengthMultiplier]
H --> J[generateStageConfig]
I --> J
J --> K[getStageMonsterConfigs]
end
subgraph "应用层"
L[MissionMonComp.ts] --> M[GameMap.ts]
L --> N[Mon.ts]
L --> O[MapModelComp.ts]
end
A --> G
K --> L
M --> O
```

**图表来源**
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L1-L311)
- [MissionMonComp.ts](file://assets/script/game/map/MissionMonComp.ts#L1-L240)
- [GameMap.ts](file://assets/script/game/map/GameMap.ts#L1-L36)

**章节来源**
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L1-L50)
- [MissionMonComp.ts](file://assets/script/game/map/MissionMonComp.ts#L1-L40)

## 关卡类型系统

系统定义了四种主要的关卡类型，每种类型都有独特的配置特征和挑战性。

### StageType枚举结构

```mermaid
classDiagram
class StageType {
<<enumeration>>
+NORMAL : "normal"
+ELITE : "elite"
+BOSS : "boss"
+EVENT : "event"
}
class StageConfigRules {
+NORMAL : NormalConfig
+ELITE : EliteConfig
+BOSS : BossConfig
+EVENT : EventConfig
}
class NormalConfig {
+description : "普通关卡"
+monsters : MonsterGroup[]
}
class EliteConfig {
+description : "精英关卡"
+monsters : MonsterGroup[]
}
class BossConfig {
+description : "Boss关卡"
+monsters : MonsterGroup[]
}
class EventConfig {
+description : "事件关卡"
+monsters : MonsterGroup[]
}
StageType --> StageConfigRules : "映射到"
StageConfigRules --> NormalConfig : "包含"
StageConfigRules --> EliteConfig : "包含"
StageConfigRules --> BossConfig : "包含"
StageConfigRules --> EventConfig : "包含"
```

**图表来源**
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L35-L86)

### 关卡类型特征对比

| 关卡类型 | 怪物组成 | 数量范围 | 特殊规则 |
|---------|---------|---------|---------|
| 普通关卡 | 普通怪物 | 2-6只 | 基础难度，适合新手 |
| 精英关卡 | 精英+普通 | 3-9只 | 中等难度，包含精英怪物 |
| Boss关卡 | Boss+精英+普通 | 4-8只 | 高难度，包含Boss |
| 事件关卡 | 普通怪物 | 1-4只 | 包含随机事件 |

**章节来源**
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L47-L86)

## 怪物类型体系

系统采用分层的怪物分类体系，支持不同强度和行为特征的怪物配置。

### MonsterType枚举设计

```mermaid
classDiagram
class MonsterType {
<<enumeration>>
+NORMAL : "normal"
+ELITE : "elite"
+BOSS : "boss"
}
class MonsterConfig {
+uuid : number
+type : MonsterType
+stageNumber : number
+level : number
+strengthMultiplier : number
}
class MonsterPool {
+getMonsterUUIDsByType() : number[]
+EliteMonsterList : number[]
+BossMonsterList : number[]
+getMonList() : number[]
}
MonsterType --> MonsterConfig : "生成"
MonsterPool --> MonsterType : "提供"
MonsterPool --> MonsterConfig : "包含"
```

**图表来源**
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L28-L34)
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L240-L260)

### 怪物池配置

系统维护三个独立的怪物池，每个池包含特定类型的怪物：

- **普通怪物池**：使用 `getMonList()` 方法获取所有可用的普通怪物
- **精英怪物池**：固定配置的精英怪物列表
- **Boss怪物池**：固定配置的Boss怪物列表

**章节来源**
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L18-L34)
- [heroSet.ts](file://assets/script/game/game/common/config/heroSet.ts#L35-L40)

## 关卡配置规则

系统通过预定义的配置规则实现关卡的程序化生成，确保游戏体验的连贯性和挑战性。

### 配置规则结构

```mermaid
flowchart TD
A[关卡号] --> B{关卡类型判断}
B --> |第5关且等级3| C[事件关卡]
B --> |第10关| D{等级判断}
B --> |其他| E{等级判断}
D --> |等级5| F[Boss关卡]
D --> |等级4| G[精英关卡]
D --> |其他| H[普通关卡]
E --> |等级5| I[精英关卡]
E --> |其他| J[普通关卡]
C --> K[生成怪物配置]
F --> K
G --> K
H --> K
I --> K
J --> K
K --> L[计算怪物数量]
K --> M[计算强度倍率]
L --> N[生成最终配置]
M --> N
```

**图表来源**
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L129-L168)

### 怪物数量计算算法

系统采用线性递增算法计算怪物数量：

```typescript
// 计算公式：基础数量 + (关卡号 ÷ 5) 的整数部分
const increment = Math.floor(stageNumber / 5);
let count = baseCount + increment;

// 确保数量在最小值和最大值范围内
count = Math.max(minCount, Math.min(maxCount, count));
```

**章节来源**
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L150-L175)

## 随机事件系统

系统提供了丰富的随机事件机制，为游戏增添不确定性和策略深度。

### EventType枚举

```mermaid
classDiagram
class EventType {
<<enumeration>>
+TREASURE : "treasure"
+TRAP : "trap"
+BUFF : "buff"
+DEBUFF : "debuff"
}
class EventConfig {
+TREASURE : TreasureConfig
+TRAP : TrapConfig
+BUFF : BuffConfig
+DEBUFF : DebuffConfig
}
class EventProbability {
+TREASURE : 0.3
+TRAP : 0.25
+BUFF : 0.25
+DEBUFF : 0.2
}
EventType --> EventConfig : "配置"
EventConfig --> EventProbability : "概率分布"
```

**图表来源**
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L50-L75)

### 事件触发机制

事件系统采用累积概率算法确保公平性：

```mermaid
sequenceDiagram
participant Player as 玩家
participant System as 事件系统
participant RNG as 随机数生成器
participant Effect as 效果处理器
Player->>System : 进入事件关卡
System->>RNG : 生成随机数(0-1)
RNG-->>System : 返回随机值
System->>System : 累积概率计算
alt 随机数 ≤ 0.3
System->>Effect : 触发宝藏事件
Effect->>Player : 增加50金币
else 随机数 ≤ 0.55
System->>Effect : 触发陷阱事件
Effect->>Player : 造成伤害
else 随机数 ≤ 0.8
System->>Effect : 触发增益事件
Effect->>Player : 获得临时增益
else 随机数 > 0.8
System->>Effect : 触发减益事件
Effect->>Player : 造成临时减益
end
```

**图表来源**
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L295-L311)

**章节来源**
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L50-L75)
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L295-L311)

## 动态难度计算

系统实现了复杂的难度计算机制，确保游戏体验的渐进式挑战。

### 强度倍率计算

```mermaid
flowchart LR
A[关卡号] --> B[阶段倍率计算]
C[等级] --> D[等级倍率计算]
B --> E[基础倍率 = 1 + (关卡号-1) × 0.1]
D --> F[等级倍率 = 1 + (等级-1) × 0.05]
E --> G[总倍率 = 阶段倍率 × 等级倍率]
F --> G
G --> H[应用到怪物属性]
H --> I[HP = 基础HP × 总倍率]
H --> J[AP = 基础AP × 总倍率]
H --> K[DEF = 基础DEF × 总倍率]
```

**图表来源**
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L177-L185)

### 难度曲线特征

| 关卡范围 | 等级要求 | 强度倍率 | 怪物数量 | 挑战特点 |
|---------|---------|---------|---------|---------|
| 1-9 | 1-4级 | 1.0-1.4 | 2-6只 | 渐进适应 |
| 1-9 | 5级 | 1.4-1.8 | 3-6只 | 中等挑战 |
| 10 | 1-3级 | 1.9-2.3 | 3-6只 | 高强度 |
| 10 | 4级 | 2.4-2.8 | 3-6只 | 极限挑战 |
| 10 | 5级 | 2.9-3.3 | 3-6只 | 终极考验 |

**章节来源**
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L177-L185)

## 关卡生成流程

系统通过多层函数协作实现完整的关卡生成流程。

### 完整生成序列

```mermaid
sequenceDiagram
participant MC as MissionComp
participant RM as MissionMonComp
participant RC as RogueConfig
participant MM as MapModel
participant M as Monster
MC->>RM : do_mon_wave()
RM->>RC : getStageType(stageNumber, level)
RC-->>RM : StageType
RM->>RC : getStageMonsterConfigs(stageNumber, level)
RC->>RC : generateStageConfig()
RC->>RC : calculateMonsterCount()
RC->>RC : calculateMonsterStrengthMultiplier()
RC-->>RM : 怪物配置数组
RM->>RM : generateMonstersFromStageConfig()
loop 每个怪物配置
RM->>RM : addToStageSpawnQueue()
end
loop 怪物生成队列
RM->>M : addMonster()
M->>MM : 加载怪物资源
MM-->>M : 怪物实例
M-->>RM : 怪物实体
end
```

**图表来源**
- [MissionMonComp.ts](file://assets/script/game/map/MissionMonComp.ts#L102-L136)
- [RogueConfig.ts](file://assets/script/game/map/RogueConfig.ts#L207-L247)

### 怪物生成队列管理

系统采用队列机制控制怪物生成节奏：

```mermaid
stateDiagram-v2
[*] --> 等待生成
等待生成 --> 准备生成 : 怪物队列非空
准备生成 --> 生成中 : spawnTimer >= spawnInterval
生成中 --> 暂停检查 : 生成5只后
生成中 --> 准备生成 : 继续生成
暂停检查 --> 暂停中 : 需要暂停
暂停检查 --> 准备生成 : 继续生成
暂停中 --> 暂停结束 : pauseInterval时间到
暂停结束 --> 准备生成 : 重置计数器
准备生成 --> [*] : 队列为空
```

**图表来源**
- [MissionMonComp.ts](file://assets/script/game/map/MissionMonComp.ts#L45-L85)

**章节来源**
- [MissionMonComp.ts](file://assets/script/game/map/MissionMonComp.ts#L102-L136)
- [MissionMonComp.ts](file://assets/script/game/map/MissionMonComp.ts#L150-L180)

## 实际调用机制

系统在游戏运行时通过事件驱动的方式调用关卡配置功能。

### 调用时序图

```mermaid
sequenceDiagram
participant GM as GameMap
participant MC as MissionComp
participant MMon as MissionMonComp
participant RC as RogueConfig
GM->>MC : 初始化游戏
MC->>MC : data_init()
MC->>MC : mission_start()
MC->>MC : to_fight()
MC->>MMon : fight_ready()
MMon->>MMon : do_mon_wave()
Note over MMon : 开始关卡生成流程
MMon->>RC : getStageType(currentStage, level)
MMon->>RC : getStageMonsterConfigs(currentStage, level)
RC-->>MMon : 怪物配置数据
MMon->>MMon : generateMonstersFromStageConfig()
MMon->>MMon : addToStageSpawnQueue()
loop 怪物生成循环
MMon->>MMon : spawnNextMonster()
MMon->>GM : addMonster()
end
```

**图表来源**
- [GameMap.ts](file://assets/script/game/map/GameMap.ts#L25-L35)
- [MissionComp.ts](file://assets/script/game/map/MissionComp.ts#L75-L95)
- [MissionMonComp.ts](file://assets/script/game/map/MissionMonComp.ts#L40-L50)

### 数据流传递

关卡配置数据通过以下路径传递：

1. **配置层**：RogueConfig.ts 提供基础配置
2. **逻辑层**：MissionMonComp.ts 处理游戏逻辑
3. **渲染层**：Mon.ts 负责怪物渲染和行为
4. **状态层**：smc.vmdata.mission_data 管理游戏状态

**章节来源**
- [GameMap.ts](file://assets/script/game/map/GameMap.ts#L25-L35)
- [MissionComp.ts](file://assets/script/game/map/MissionComp.ts#L75-L95)
- [MissionMonComp.ts](file://assets/script/game/map/MissionMonComp.ts#L40-L50)

## 扩展指南

### 添加新事件类型

要添加新的随机事件类型，请按照以下步骤操作：

1. **扩展EventType枚举**：
```typescript
export enum EventType {
    // 现有类型...
    NEW_EVENT = "new_event"  // 新增事件类型
}
```

2. **更新EventConfig配置**：
```typescript
export const EventConfig = {
    // 现有配置...
    [EventType.NEW_EVENT]: {
        description: "新事件描述",
        probability: 0.15,  // 新事件概率
        effect: "新事件效果"
    }
}
```

3. **在事件处理函数中添加逻辑**：
```typescript
private processRandomEvent() {
    switch (this.currentEvent) {
        // 现有事件处理...
        case EventType.NEW_EVENT:
            // 实现新事件逻辑
            break;
    }
}
```

### 调整难度曲线

可以通过修改以下参数来调整难度曲线：

1. **基础倍率调整**：
```typescript
// 修改 StageConfigRules 中的怪物配置
[StageType.NORMAL]: {
    monsters: [
        { type: MonsterType.NORMAL, count: 3, minCount: 2, maxCount: 6 }
        // count: 基础数量
        // minCount/maxCount: 数量范围限制
    ]
}
```

2. **强度倍率系数**：
```typescript
// 修改 calculateMonsterStrengthMultiplier 函数
const stageMultiplier = 1 + (stageNumber - 1) * 0.15;  // 增加每关倍率
const levelMultiplier = 1 + (level - 1) * 0.08;        // 增加每级倍率
```

### 平衡精英/Boss关卡

1. **调整精英怪物配置**：
```typescript
export const EliteMonsterList = [
    5201, // 兽人战士
    5202, // 兽人刺客
    5203, // 兽人护卫
    // 添加更多精英怪物
    5204, // 新精英怪物
    5205  // 更强精英怪物
];
```

2. **优化Boss关卡配置**：
```typescript
[StageType.BOSS]: {
    description: "Boss关卡",
    monsters: [
        { type: MonsterType.BOSS, count: 1, minCount: 1, maxCount: 1 },
        { type: MonsterType.ELITE, count: 3, minCount: 2, maxCount: 4 },  // 增加精英数量
        { type: MonsterType.NORMAL, count: 4, minCount: 2, maxCount: 6 }  // 增加普通怪物
    ]
}
```

### 自定义怪物池

如果需要添加特定类型的怪物：

1. **扩展怪物池**：
```typescript
// 在 RogueConfig.ts 中
export const CustomMonsterList = [
    5301, // 自定义怪物1
    5302, // 自定义怪物2
    5303  // 自定义怪物3
];
```

2. **在 getMonsterUUIDsByType 中添加分支**：
```typescript
case MonsterType.CUSTOM:
    return CustomMonsterList;
```

## 性能优化建议

### 怪物生成优化

1. **批量生成**：使用对象池减少频繁的实例化
2. **延迟加载**：怪物资源按需加载
3. **队列管理**：合理控制生成频率避免性能峰值

### 内存管理

1. **及时清理**：战斗结束后立即清理怪物实体
2. **资源卸载**：不再需要的资源及时卸载
3. **缓存策略**：合理缓存常用的配置数据

### 配置优化

1. **预计算**：将静态配置在启动时预计算
2. **分层加载**：按关卡需求分层加载配置
3. **压缩存储**：使用紧凑的数据结构存储配置

## 总结

肉鸽关卡配置系统是一个设计精良的程序化关卡生成框架，具有以下核心优势：

### 技术亮点

- **模块化设计**：清晰的职责分离和接口定义
- **可扩展性**：易于添加新类型和调整配置
- **性能优化**：合理的算法设计和资源管理
- **用户体验**：平衡的难度曲线和多样化的游戏体验

### 应用价值

该系统不仅适用于Roguelike游戏，也可作为其他类型游戏关卡生成的基础框架。其程序化的设计理念和灵活的配置机制为游戏开发提供了强大的工具支持。

通过深入理解和合理运用这套系统，开发者可以创造出具有深度策略性和持续挑战性的游戏体验，为玩家提供持久的游戏乐趣。