SGG PerfMeter

Lightweight runtime performance diagnostics and agent-readable profiling for Unity 6 URP.

English | Русский | Deutsch | Español | Français | Italiano | 日本語 | 한국어 | Português (Brasil) | 简体中文

—

Installation | Quick Start | Workflows | Visual Presets | Implemented Widgets | API | MCP | Comparison | Limitations | Troubleshooting | Screenshots | Setup Window Screenshots | Contributor Checks | Changelog

SGG PerfMeter - lightweight runtime performance diagnostics and agent-readable profiling for Unity 6 URP.

Detect frame bottlenecks, compare performance changes, capture reproducible sessions, and expose structured profiling data to tools and AI agents.

SGG PerfMeter explains whether a frame is limited by CPU, GPU, render thread, present/VSync, overdraw, or unavailable platform counters, and lets you save that state for later analysis.

Why It Helps

• See frame bottleneck context while the game is running.
• Switch between visual presets, graphs, metric bars, compact layouts, and custom metric rows for different debugging situations.
• Record reproducible profiling sessions with warm-up, scene scope, worst-frame summaries, JSON/CSV export, device metadata, and camera metadata.
• Use alerts, structured logs, callbacks, and Editor warning cooldowns to catch regressions without watching the overlay all the time.
• Give tools and agents structured data for comparisons, A/B tests, and hotspot search instead of relying on screenshots or Console scraping.

How It Exposes The Data

• Runtime overlay: visual presets, compact layouts, graphs, metric bars, and custom metric rows for live inspection.
• Public C# API: immutable snapshots for status, metrics, device, camera, Render Graph, alerts, sessions, and custom metrics.
• Session recording: bounded captures with warm-up, scene scope, worst frames, device/camera metadata, and JSON/CSV export.
• Alerts: structured logs, callbacks, Editor warning cooldowns, and latest-alert snapshots.
• Agent layer: MCP command metadata lets agents inspect the project, compare runs, perform A/B tests, and search for hotspots through structured data.

What It Measures

• Unity 6000.4+ / URP 17.4+ Render Graph runtime state.
• FrameTimingManager CPU/GPU timing: CPU frame, main thread, render thread, present wait, and GPU frame time when available.
• ProfilerRecorder render counters: draw calls, SetPass, batches, vertices, SRP Batcher, BRG/GRD, upload bytes, memory, and GPU memory when available.
• Bottleneck classification for GPU, CPU main thread, CPU render thread, present/VSync, balanced, or unknown frames.
• Opt-in numerical overdraw measurement and visual overdraw heatmap through URP Render Graph.
• Device, camera, Render Graph, status, metrics, alerts, session, and custom metric snapshots for code and MCP automation.

Quick Start

1. Install the Unity package from npm registry or Git UPM.
2. Open SGG/Perfmeter/Setup in Unity.
3. Run the recommended setup, enter Play Mode, and confirm that the overlay appears.

{
  "scopedRegistries": [
    {
      "name": "npmjs",
      "url": "https://registry.npmjs.org",
      "scopes": [
        "com.sungeargames"
      ]
    }
  ],
  "dependencies": {
    "com.sungeargames.perfmeter": "2026.6.5-2"
  }
}

For Git UPM and local-copy options, see Installation and Quick Start.

Common Workflows

• Zero-code overlay: create Assets/Resources/SGG.PerfMeter/perfmeter-settings.json from the setup window and let PerfMeter auto-start.
• Runtime API: call PerformanceMeter.EnsureRunning(), then read immutable status, metrics, device, camera, and session snapshots.
• Session export: record bounded profiling windows and export JSON/CSV with scene, device, camera, settings, counters, warnings, and worst-frame metadata.
• Overdraw diagnostics: request a bounded numerical measurement or enable the visual heatmap when the URP renderer feature is installed.
• MCP automation: use MCP command metadata to start collection, switch overlay modes, export sessions, inspect alerts, and read snapshots.

See Workflows, API, and MCP.

Screenshots

See the default overlay preset, setup window pages, visual presets, and runtime widgets in the screenshot galleries.

Start with Visual Presets, Setup Window Screenshots, Implemented Widgets, and Screenshots.

Compared With FPS Counters

Advanced FPS Counter and Graphy are strong general-purpose drop-in visual overlays. SGG PerfMeter intentionally focuses on modern Unity URP diagnostics: structured timing and render counters, bottleneck classification, reproducible sessions, device/camera snapshots, overdraw diagnostics, Render Graph state, and MCP/API automation.

Use Comparison as product and architecture context rather than measured runtime benchmark data.

Requirements

• Unity 6000.4+ for supported runtime usage.
• URP 17.4+ with Render Graph path.
• Frame Timing Stats enabled before relying on FrameTimingManager in builds.
• Vulkan is preferred on Android when GPU timing matters.

Unity 2022.3 through 6000.3 may be import-safe for compile checks, but runtime overlay, Render Graph features, overdraw passes, and support expectations target Unity 6000.4+ with URP 17.4+. Some features may not work in versions before 6000.4.

License

This package is licensed under Stinger Royalty-Free EULA 1.0.

• Authoritative license text: LICENSE.ru.md
• English convenience translation: LICENSE.md
• Notices: NOTICE.md and NOTICE.ru.md
• Brand usage policy: English, Russian, German, Spanish, French, Italian, Japanese, Korean, Brazilian Portuguese, and Simplified Chinese