AGameStateBase

自动关联目录:AGameStateBase

GameState 是"所有人都要看到的那份状态"的容器,存在于服务端与所有客户端,通过属性复制同步。

一句话定位:GameMode 是规则(仅服务端),GameState 是规则产生的结果(全端可见)。

该放什么

放这里不放这里
比分、剩余时间、回合数单个玩家的私有数据(放 PlayerState)
全局阶段/状态机仅服务端用的临时计算
需要 HUD 显示的全局信息高频变化的数据(复制开销大)
玩家列表(PlayerArray)不需要同步的缓存

复制要点

UPROPERTY(ReplicatedUsing = OnRep_MatchTime)
int32 RemainingTime;

UFUNCTION()
void OnRep_MatchTime();

void AMyGameState::GetLifetimeReplicatedProps(
        TArray<FLifetimeProperty>& OutLifetimeProps) const
{
    Super::GetLifetimeReplicatedProps(OutLifetimeProps);
    DOREPLIFETIME(AMyGameState, RemainingTime);
}
要点说明
必须 UPROPERTY() + Replicated否则不复制
必须注册 GetLifetimeReplicatedProps否则不复制
OnRep 只在客户端调用服务端要自己做一遍表现逻辑
ReplicatedUsing 不会在服务端触发常见误解

时间同步

GetServerWorldTimeSeconds() 与客户端时间有偏差,需要统一时间基准时:

方法说明
AGameStateBase::GetServerWorldTimeSeconds()权威时间
复制一个 ServerWorldTimeSecondsDelta客户端据此校正
用 Replicated 的时间戳简单场景够用

基类与扩展

类说明
AGameStateBase最小集,含 PlayerArray
AGameState额外提供比赛状态与 MatchState 相关辅助

自定义时通常继承 AGameStateBase 并加自己的复制字段,然后在 GameMode 里通过构造函数或蓝图指定 GameStateClass。

常见坑

坑说明
OnRep 里假设服务端也会走不会,服务端需单独处理
把高频数据(每帧变化)塞进来复制带宽爆炸,见 Replication
客户端直接改 GameState 字段会被服务端下次复制覆盖;要改就走 RPC
PlayerArray 顺序当稳定序号顺序不保证,用 PlayerId