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 |
许可协议:CC BY
作者:Davids
本文链接:https://hustjjd.github.io/1c2d50fe.html
更新于:2026年11月16日