48 lines
2.6 KiB
Markdown
48 lines
2.6 KiB
Markdown
# BP_TestMode
|
||
|
||
## 基本信息
|
||
- **类型**: Blueprint (GameMode)
|
||
- **父类**: GameModeBase
|
||
- **源文件**: /Game/Blueprints/BP_TestMode.BP_TestMode
|
||
- **模块**: Content
|
||
|
||
## 功能概述
|
||
BP_TestMode 是项目的 GameMode 蓝图，配置默认的 Pawn、PlayerController 和 HUD 类，将项目的所有核心类串联起来。
|
||
|
||
## 设计用意
|
||
作为项目唯一的 GameMode，BP_TestMode 将分散的蓝图类通过引擎框架连接在一起。它将 BP_TestChar 设为默认 Pawn、BP_TestCtl 设为玩家控制器、BP_Hud 设为 HUD 类，形成一个完整的游戏运行时配置。这样所有核心类型的替换只需要修改这一个地方。
|
||
|
||
## 职责范围
|
||
BP_TestMode 负责配置默认游戏类和串联项目核心类型之间的关系。具体的角色行为、控制器逻辑、UI 管理分别由各自对应的类负责。
|
||
|
||
## 项目内依赖
|
||
| 依赖项 | 关系 | 源文件 |
|
||
|--------|------|--------|
|
||
| BP_TestChar | DefaultPawn | /Game/Blueprints/BP_TestChar |
|
||
| BP_TestCtl | PlayerController | /Game/Blueprints/BP_TestCtl |
|
||
| BP_Hud | HUD | /Game/Blueprints/BP_Hud |
|
||
|
||
## 对外接口
|
||
- **继承自 AGameModeBase 的标准接口**：
|
||
- GameMode 生命周期事件：`InitGame`、`PreLogin`、`PostLogin`、`Logout`、`RestartPlayer`、`SpawnDefaultPawnAtTransform` 等，均可在蓝图 EventGraph 中覆盖（EventGraph 中 event_count=2, node_count=2）
|
||
- `GetDefaultPawnClassForController` -- 返回配置的 DefaultPawnClass
|
||
- GameMode 的标准函数和事件均继承可用
|
||
- **编辑器配置属性**（通过 GameMode 基类继承）：
|
||
- `DefaultPawnClass` = BP_TestChar -- 默认 Pawn 类型
|
||
- `PlayerControllerClass` = BP_TestCtl -- 玩家控制器类型
|
||
- `HUDClass` = BP_Hud -- HUD 类型
|
||
- 其他 GameMode 标准配置属性（GameStateClass、SpectatorClass 等）
|
||
|
||
## 使用方法
|
||
- 在关卡的世界设置（World Settings）中将 `GameMode Override` 设置为 BP_TestMode
|
||
- 或在项目设置中将其设为默认 GameMode，应用于所有关卡
|
||
- 配置三个核心 class 属性，将 BP_TestChar、BP_TestCtl、BP_Hud 串联为一个完整游戏框架
|
||
- EventGraph 中无额外蓝图逻辑（node_count=2），纯配置型蓝图，所有替换只需修改此文件中的属性值
|
||
- 项目有且仅有一个 GameMode，所有核心类型的替换集中在此处管理
|
||
|
||
## 用例
|
||
- 关卡 World Settings 的 `GameMode Override`，引擎启动时加载
|
||
- `DefaultPawnClass=BP_TestChar` -- 新玩家进入时自动生成该 Pawn
|
||
- `PlayerControllerClass=BP_TestCtl` -- 新玩家连接时自动创建该控制器
|
||
- `HUDClass=BP_Hud` -- 创建控制器时自动生成该 HUD
|