PerfGuardian – Lightweight FPS, GC & Memory Profiler for Runtime

PerfGuardian – Runtime Performance Monitor & Spike Detector PerfGuardian is a lightweight runtime performance monitoring tool for Unity projects. It helps developers detect FPS drops, GC spikes and memory issues automatically while the game is running. Unlike the built-in Unity Profiler, PerfGuardian is designed to work directly inside runtime builds with minimal overhead, making it ideal for production testing and real-device diagnostics. ------------------------------------------------------------ KEY FEATURES ------------------------------------------------------------ • Real-Time FPS Monitoring Track frame rate and frame time directly in-game. • Automatic Spike Detection Automatically detect: - Low FPS events - Frame hitches - GC allocation spikes • Memory Monitoring Monitor Mono memory, total allocated memory, and reserved memory usage. • JSON Event Logging Export structured performance logs in JSON format for external analysis or debugging. • Lightweight & Production Safe Designed to run with minimal runtime overhead. • Cross-Platform Support Works in Unity Editor and standalone builds. Logs are saved to persistentDataPath. • Built-In Stress Test Demo Scene Includes demo tools to simulate object spawn stress, GC allocation spikes, and UI rebuild spikes for testing. ------------------------------------------------------------ WHY PERF GUARDIAN? ------------------------------------------------------------ When the Unity Profiler is too heavy or impractical for runtime builds, PerfGuardian keeps watch. It is not a full profiler replacement — it is a lightweight performance watchdog designed to alert you when something goes wrong. ------------------------------------------------------------ IDEAL FOR ------------------------------------------------------------ • Indie developers testing builds on real devices • Runtime diagnostics in production builds • Detecting performance regressions • Monitoring FPS and GC behavior during gameplay • Lightweight performance validation before release ------------------------------------------------------------ TECHNICAL DETAILS ------------------------------------------------------------ • No third-party dependencies • Minimal allocations • Clean namespace structure • Runtime-safe implementation • Compatible with Unity 2021+ (or your target version) ------------------------------------------------------------ DOCUMENTATION INCLUDED ------------------------------------------------------------ • Quick start guide • Setup instructions • Changelog • Usage examples ------------------------------------------------------------ VERSION ------------------------------------------------------------ Current Version: 1.0.0