Focused reference · Unreal Engine 5.8

Load and streaming hitch diagnosis

unreal-memory-streaming/references/load-hitch-diagnosis.md
  1. Mark the player action/region entry and capture Timing plus loadtime/file channels as needed.
  2. Inspect Asset Loading Insights package order, async priorities, serialization, and Game-thread waits.
  3. Correlate file IO, decompression, UObject creation, PostLoad, component registration, render/physics resource creation, PSO compile, and GC.
  4. Determine whether work is synchronous, async but completed too late, or async followed by a blocking readiness phase.
  5. Move/preload only the causal work, increase lead time, or amortize creation across frames.
SymptomFirst evidence
first pickup/effect hitchespackage load, component registration, PSO/decode readiness
entering region hitchesWorld Partition/cell activation, file IO, texture/Nanite demand
memory spike then GC hitchtransient allocations, object churn, retained load handles
asset says loaded but appears laterender/physics resource or PSO readiness
cold run hitches, warm run does notOS/driver/cache-sensitive IO or compilation
async request still stallslate request, completion on critical path, sync dependency inside PostLoad

Never “fix” by hiding the trace interval behind a shorter loading screen. If blocking is required, own it with a real loading transition and an explicit complete/timeout/failure contract.