Replication Graph

自动关联目录:Replication Graph

默认复制逻辑的问题:每帧对每个连接遍历所有相关 Actor,判断相关性。Actor 数量上千时,这个遍历本身就成了瓶颈。

Replication Graph 的做法是把"哪些 Actor 要发给谁"的计算结果缓存成图结构,按规则分流,避免每帧全量遍历。

核心思路

UReplicationGraph
├── UReplicationGraphNode_GridSpatialization2D   按空间网格划分
├── UReplicationGraphNode_ActorList             静态/常驻列表
├── UReplicationGraphNode_DynamicSpatialFrequency 按距离调频
├── UReplicationGraphNode_TearOff_ForConnection 仅某连接可见
└── UReplicationGraphNode_AlwaysRelevant        永远相关(GameState 等)

每个节点负责一类 Actor 的相关性判断,节点之间可组合。

常用节点

节点用途
GridSpatialization2D按网格划分,只复制附近的 Actor(大世界必备)
ActorList固定列表,适合数量少且一直相关的对象
AlwaysRelevant / AlwaysRelevant_ForConnectionGameState、PlayerController
DynamicSpatialFrequency距离越远更新越慢
TearOff一次性事件(爆炸残留)
DormancyNode配合休眠

接入

步骤说明
继承 UReplicationGraph实现 InitConnectionGraph / InitGlobalActorClassSettings / RouteAddNetworkActorToNodes
配置 ReplicationGraphClass在项目设置里指定
为类配 FClassReplicationInfo距离、频率、剔除策略
按连接定制InitConnectionGraph 里给每个连接建节点
void UMyRepGraph::InitGlobalActorClassSettings()
{
    // 全局默认:200 米的剔除距离
    GetReplicationGraph()->GlobalActorReplicationInfoMap.SetCullDistance(...);

    // 按类定制
    FClassReplicationInfo Info;
    Info.SetCullDistanceSquared(30000.f * 30000.f);
    Info.ReplicationPeriodFrame = 4;   // 每 4 帧一次
    ...
}

什么时候值得上

场景建议
少量 Actor(几十个)不值得,默认逻辑够
上百个需要复制的 Actor值得,主要收益在减少遍历
大世界 / 大量小怪 / 子弹多必须用,配合网格划分

判断依据:Profiler 里 ServerReplicateActors 的耗时占比。如果它显著,就上 Replication Graph。

常见坑

坑说明
忘了给新 Actor 类型路由Actor 根本不被复制(表现为"客户端看不到")
把动态 Actor 放进静态列表位置变了但相关性没更新
网格 Cell 大小不合理太大 = 没优化;太小 = 边界频繁进出
与休眠冲突休眠后不再更新,需要正确的唤醒时机
只在编辑器测试客户端数量与距离分布不同,要压测