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 / PlayerStateGameMode 蓝图或构造函数
关卡使用哪个 GameModeWorld Settings(GameMode Override)或项目设置
全局默认Project Settings → Maps & Modes

World Settings 的覆盖优先级高于项目默认,这是"这一关用特殊规则"的标准做法。

常见坑

坑说明
在客户端取 GameMode不存在,返回空
在 BeginPlay 里做需要玩家的初始化玩家还没登录,应在 PostLogin
把需要复制的字段写在 GameMode 里客户端永远收不到,应移到 GameState
在 GameMode 里直接操作 UI服务端没有 UI