AGS Debug Profiler

The AGS Debug Profiler is a powerful real-time diagnostic tool built directly into the system. It helps developers and QA identify bottlenecks and verify how AGS is behaving.

How to Use

  • Hotkeys: Press F9 (default, configurable) to toggle the overlay.
  • Manual Toggle: Use the "Show/Hide Debug Profiler" button in the AutoConfigManager Inspector.

Metrics Explained

  • FPS & Stats (Avg, Min, Max): Real-time frame rate with consistency tracking and smoothing. Color-coded dynamically based on your Target FPS (Green = Good, Orange = Warning, Red = Bad).
  • Bottleneck Analysis: Identifies if the game is CPU Bound, GPU Bound, or Balanced with smoothed transitions to enable actual readability without flickering.
  • Detailed Memory:
    • System: Total Physical RAM.
    • Allocated: Memory currently used by the app.
    • Reserved: Memory reserved by the engine.
    • VRAM: Total Video RAM detected.
  • Dynamic Status: Shows active Render Scale, SSAO state, Bloom state, and target FPS.
  • Event Log: A real-time log of every dynamic adjustment (e.g., "[00:45.2] Render Scale Reduced to 0.85").