ue5-performance-packaging

Quick Start

• Confirm target platform and build configuration.
• Collect current performance symptoms and packaging goal.
• Output a pre-package checklist plus measurement plan.

UE5.7 API Anchors

• Runtime quality and frame-budget anchors:
  • UGameUserSettings::SetOverallScalabilityLevel(...)
  • UGameUserSettings::SetFrameRateLimit(...)
  • UGameUserSettings::ApplySettings(...)
• Packaging settings anchors:
  • UProjectPackagingSettings
  • BuildConfiguration, MapsToCook, DirectoriesToAlwaysCook
  • UsePakFile, bUseIoStore, bGenerateChunks
• Asset dependency validation anchors:
  • FAssetRegistryModule, IAssetRegistry
  • GetAssetsByPath(...)
  • GetDependencies(...), GetReferencers(...)
• Profiling instrumentation anchors:
  • TRACE_CPUPROFILER_EVENT_SCOPE(...)
  • DECLARE_CYCLE_STAT(...)
• Practical runtime stat commands:
  • stat unit, stat gpu, stat scenerendering, memreport -full

Performance and Packaging Contract

• Every performance/packaging task must define:
  • target platform + build config + test map
  • reproducible capture scenario (camera path, duration, net mode)
  • baseline metrics and acceptance thresholds
  • packaging configuration set and dependency scan scope
  • go/no-go output with explicit blockers
• If any item is missing, readiness evaluation is incomplete.

Workflow

1) Reproducible Baseline Capture

• Freeze test map, camera path, scalability, and net mode.
• Capture stat unit and stat gpu under same scenario repeatedly.
• Use median or percentile metrics, not single-frame spikes.

2) Hotspot Isolation

• Identify top-cost gameplay/render systems in the capture window.
• Correlate high-cost actors/assets with scene context.
• Add scoped CPU markers for custom systems when attribution is unclear.

3) Asset and Dependency Validation

• Scan target paths for missing or broken asset references.
• Query dependencies and referencers for problematic assets.
• Validate required map/game mode assets are included in package scope.