AGameModeBase
自动关联目录:AGameModeBase
GameMode 定义"这局游戏的规则",且只存在于服务端。
这是最容易出错的一条性质:客户端 GetWorld()->GetAuthGameMode() 返回 nullptr。任何客户端也需要的数据,都必须放到 GameState。
职责边界
| 该做 | 不该做 |
|---|---|
| 规则判定(胜负、回合、结算) | 存需要显示给玩家的状态 |
生成与重生(SpawnDefaultPawnFor、RestartPlayer) | 处理输入或 UI |
| 登录与队伍分配 | 每帧逻辑(它没有 Tick 语义上的保证) |
| 服务器端的作弊校验 | 依赖客户端上报的关键判定 |
常用重写点
// 登录
virtual void PreLogin(...) override; // 拒绝连接
virtual void PostLogin(APlayerController*) override;
// 生成
virtual APawn* SpawnDefaultPawnAtTransform(...) override;
virtual AActor* ChoosePlayerStart(AController*) override;
virtual void RestartPlayer(AController*) override;
// 规则
virtual bool ShouldSpawnAtStartSpot(AController*) override;
virtual void HandleSeamlessTravelPlayer(AController*) override;| 函数 | 用途 |
|---|---|
PreLogin | 返回 Error 字符串即拒绝登录 |
PostLogin | 玩家就绪,生成 Pawn、初始化数据 |
ChoosePlayerStart | 选出生点,可按队伍/进度过滤 |
SpawnDefaultPawnFor | 决定生成什么 Pawn |
RestartPlayer | 重生流程的统一入口 |
ChangeState / SetMatchState(AGameMode) | 用 AGameMode(非 Base)时的比赛状态机 |
基类选择
| 类 | 提供 |
|---|---|
AGameModeBase | 最小集:登录、生成、默认 Pawn |
AGameMode | 额外提供 MatchState 状态机(WaitingToStart / InProgress / WaitingPostMatch 等) |
需要回合/赛制状态机时用 AGameMode,简单场景用 AGameModeBase 更干净。
配置方式
| 配置项 | 位置 |
|---|---|
| 默认 Pawn / Controller / HUD / GameState / PlayerState | GameMode 蓝图或构造函数 |
| 关卡使用哪个 GameMode | World Settings(GameMode Override)或项目设置 |
| 全局默认 | Project Settings → Maps & Modes |
World Settings 的覆盖优先级高于项目默认,这是"这一关用特殊规则"的标准做法。
常见坑
| 坑 | 说明 |
|---|---|
| 在客户端取 GameMode | 不存在,返回空 |
在 BeginPlay 里做需要玩家的初始化 | 玩家还没登录,应在 PostLogin |
| 把需要复制的字段写在 GameMode 里 | 客户端永远收不到,应移到 GameState |
| 在 GameMode 里直接操作 UI | 服务端没有 UI |
许可协议:CC BY
作者:Davids
本文链接:https://hustjjd.github.io/c4308202.html
更新于:2026年11月16日