Skip to content
EQLabs EQLabs

Replication Debugger

Replication Debugger

Section titled “Replication Debugger”

Module: Tech · Category: Debugging · Tool ID: ReplicationDebugger

Audits the active level for replication setup issues: actors with bReplicates=true but missing replicated properties; replicate-movement on actors without root components; components not set to replicate when their parent does; high net update frequency warnings; net relevancy distance; dormancy mode; bandwidth estimation per actor.

Screenshot 01 — Hero shot — Debugger after scan, mixed-severity actor list visible with bandwidth column, summary block showing total estimated bandwidth.

When to use it

Section titled “When to use it”
  • Multiplayer pre-shipping audit — finding actors with broken or suspect replication setup
  • Bandwidth budget review — per-actor estimated kbps
  • Debugging “this actor doesn’t replicate” reports — usually a missing flag

When not to use it

Section titled “When not to use it”
  • Don’t expect runtime traffic capture — this is asset/level-side analysis
  • Don’t use this for non-multiplayer projects — there’s nothing to debug

Opening the tool

Section titled “Opening the tool”
  1. Open the EQLabs Hub and search for Replication (or browse to Tech → Debugging)
  2. Click the tool card
  3. Click Scan Level

Interface tour

Section titled “Interface tour”
SectionWhat it doesDefault
Scan LevelWalks every actor in the active level
High Frequency ThresholdNetUpdateFrequency above this is flagged30.0
Show Issues OnlyHide healthy actors
Include Non-ReplicatingInclude actors with bReplicates=false
Copy ResultsPlain-text dump
StatsTotal / replicating / issue count / total bandwidth
Actors listPer-actor row: name, class, replicates flag, replicate movement, NetUpdateFrequency, NetCullDistance, dormancy, replicated component count, total components, est. bandwidth kbps, severity, issues

Severity coding

Section titled “Severity coding”
SeverityMeaning
OKProperly configured
InfoMinor inefficiency
WarningLikely issue (high frequency, suspect setup)
ErrorBroken (replicates but no replicated properties, etc.)

Screenshot 02 — Issues filter — Issues-only view showing 5–10 actors with mixed severities and recommendations.

Workflow

Section titled “Workflow”
  1. Open the level
  2. Click Scan Level
  3. Toggle Show Issues Only to focus on actionable rows
  4. Walk Error severities first
  5. Sort by Est. Bandwidth descending — top entries are highest-impact
  6. Single-click rows to select the actor in the viewport

Settings reference

Section titled “Settings reference”
FieldDefault
High Frequency Threshold30.0
Show Issues Onlyfalse
Include Non-Replicatingfalse

Settings file: [Project]/Saved/EQLabs/Settings/ReplicationDebugger.json

Output

Section titled “Output”
  • In-panel actors list
  • Clipboard — Copy Results
  • No level edits — read-only audit

Tips & gotchas

Section titled “Tips & gotchas”
  • Bandwidth is an estimate — based on NetUpdateFrequency × replicated property size. Real traffic is affected by relevancy + dormancy + delta compression
  • High NetUpdateFrequency is rarely needed — typical actors should be 10–30 Hz. 60+ Hz is usually a bug or a hero actor
  • Dormancy modes can save significant bandwidth — review actors with Awake dormancy that should probably be Initial or DormantAll
Section titled “Related tools”
  • Project Doctor Suite — broader project audit
  • Subsystem Viewer — for replication-related subsystems
Report an issue with this tool

Opens our feedback form in a new tab with the tool name pre-filled.