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_ForConnection | GameState、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 大小不合理 | 太大 = 没优化;太小 = 边界频繁进出 |
| 与休眠冲突 | 休眠后不再更新,需要正确的唤醒时机 |
| 只在编辑器测试 | 客户端数量与距离分布不同,要压测 |
许可协议:CC BY
作者:Davids
本文链接:https://hustjjd.github.io/2772613d.html
更新于:2026年11月16日