Runtime Atlas

Runtime Atlas is a production-grade Unity Editor extension that consolidates runtime diagnostics into a single, persistent inspection workspace. It is built for developers who need accurate, live data about their scene systems during Play Mode — without switching between multiple Unity windows, adding debug MonoBehaviours to scenes, or building custom editor tooling from scratch.

Runtime Atlas integrates with the Unity Editor lifecycle without modifying project assemblies.

Runtime Atlas editor systems are excluded from player builds through assembly definition separation.

Inspection Systems

The Camera tab provides live snapshots of all Camera components — field of view, clipping planes, culling masks, clear flags, render texture assignment, and depth — with live property editing. Post-processing volume inspection is available for projects using URP or HDRP.

The Audio tab monitors all AudioSource components and tracks AudioListener count. It reports playing state, volume, pitch, spatial blend, loop settings, and a live level meter per source. Playback controls (Play, Pause, Stop) operate directly on the live component during Play Mode.

The Physics tab lists all Rigidbody components with velocity, speed, mass, collision detection mode, and physics layer. A Colliders sub-tab lists all Collider components with type, trigger state, physics material, and world-space bounds. A Layer Matrix sub-tab renders the full 32×32 physics layer collision grid, colour-coded for collision and ignore states.

The Animator tab monitors Animator components, displaying current state, normalized playback time, and all parameters. Float, Int, Bool, and Trigger parameters can be read and written live from the panel.

The Materials tab lists all Renderer components with their assigned materials and shader names. An expandable detail panel shows all material properties — floats, colours, textures, and vectors — per material.

Diagnostic Systems

The Alert System aggregates diagnostic alerts across sessions. Alerts are generated by the Camera and Audio nodes (multiple listeners, missing clips, camera depth conflicts) and are displayed in the Alerts tab with severity classification — Info, Warning, and Critical. Alerts are grouped by message, filterable by severity, and individually dismissible. The IAlertSource interface allows custom alert sources to be registered from project code.

The Script Scanner performs static pattern analysis on C# source files without requiring Play Mode or compilation. It detects common patterns — uncached GetComponent calls, FindObjectsOfType in Update loops, hot-path allocations, Camera.main access, SendMessage usage, Resources.Load calls, and others. Results show file path, line number, issue description, category, and severity. The Optimizer tab translates scanner results into structured fix recommendations with before/after examples.

Performance and Recording

The Profiler tab records per-frame metrics during Play Mode: frame time in milliseconds, FPS, GC heap size, GC allocation per frame, draw calls, triangle count, and vertex count. Data is displayed as a live scrolling graph and a sample list. Configurable thresholds tint rows that exceed warning or critical frame time limits.

The Timeline tab maintains a circular frame buffer (default 300 frames, configurable). Each recorded frame stores FPS, frame time, GC heap, and active camera, audio, and alert counts. A scrubber and playback controls allow reviewing what the scene looked like at any recorded point without replaying the scene.

Reporting

The Report tab assembles a session report from current Runtime Atlas data — project metadata, performance samples, camera and audio snapshots, alerts, and scanner results — and exports it to JSON, HTML, Markdown, CSV, DOCX, XML, or YAML. The HTML format is self-contained and browser-ready. The DOCX format uses System.IO.Compression for Open XML construction and does not require Microsoft Word to be installed.

Additional Panels

The Console tab captures Unity log messages prefixed with [RA], [RuntimeAtlas], or [Runtime Atlas] into a persistent, filterable ring buffer. The Inspector tab provides a supplementary component inspector with history navigation and object pinning. The Scene tab lists all GameObjects with component counts and a search filter. The Mixer tab displays exposed Audio Mixer parameters with live editing. The Graph tab shows the Runtime Atlas internal module diagram as an interactive node canvas.

Architecture

All data collection runs on EditorApplication.update at up to 60 Hz, decoupled from UI repaints. Repaint interval is configurable (default 100 ms). Scene queries (FindObjectsByType) in UI paths are throttled to at most once per second and stored in pre-allocated lists. All GUIStyle and Texture2D objects are lazily initialized into static fields and explicitly destroyed on domain reload via AssemblyReloadEvents and [DidReloadScripts]. There are no per-frame heap allocations in hot paths.

Runtime Atlas is editor-only. The RuntimeAtlas.Editor assembly is excluded from player builds by assembly definition. The RuntimeAtlas.Core assembly, which contains only plain data types (AlertEntry, AlertSeverity), ships in player builds but contributes no behaviour.

Documentation

Full documentation is available at the official documentation repository. The About tab provides direct links to installation, quick start, troubleshooting, API reference, and support. All in-tool links route through a centralized RuntimeAtlasDocs class — no hardcoded URLs in panel code.

KEY FEATURES

Inspection

Live Camera inspection with FOV, clipping planes, culling mask, depth, render texture, and post-processing volumes (URP/HDRP)

AudioSource monitoring including playback state, volume, pitch, spatial blend, and level meter

Rigidbody and Collider inspection with physics properties and bounds

Physics layer collision matrix (32x32)

Animator monitoring with state information and parameter editing

Material and shader inspection with detailed property view

Diagnostics

Alert System with Info, Warning, and Critical severity levels

Alert grouping, filtering, and dismissal

Custom alert integration via IAlertSource

Static C# script scanner for performance issue detection

Optimizer suggestions with structured fix guidance

Performance

Real-time profiler with FPS, frame time, GC usage, draw calls, and geometry statistics

Configurable performance thresholds and warnings

Timeline recorder with frame-by-frame playback

Reporting

Export reports in JSON, HTML, Markdown, CSV, DOCX, XML, and YAML formats

Reports include performance data, alerts, and scan results

Other Tools

Component inspector with history navigation and pin support

Scene object explorer with search

Audio Mixer parameter control with live editing

Log capture console with filtering

Interactive system graph view

Integrated documentation with context-aware links

Editor Quality

Zero runtime overhead in player builds

No per-frame allocations in hot paths

Scene queries optimized and throttled

Proper resource lifecycle management

Configurable UI refresh interval

Tested on Unity 2021.3 LTS through Unity 6.x

SUPPORT AND DOCUMENTATION

Documentation

Full documentation for Runtime Atlas v1.2.1 repository. It covers installation, quick start, a full reference for all 18 tabs, 4 usage guides, complete API documentation for all public types, troubleshooting, and the version changelog.

Documentation is accessible directly from within the tool via the About tab.

Community Support

Primary support is provided via the Tools Studio Discord server. Post in the runtime-atlas channel. Include your Unity version, Runtime Atlas version, OS, and Console output when reporting issues.

Purchase Support

For purchase, refund, or licensing issues, use the support channel of the platform you purchased from.

Version Information

The current Runtime Atlas version is displayed in the About tab and documented in the changelog.

If an older version appears after import, remove previous files and re-import the package.

Links

DOCUMENTATION

DISCORD

SUPPORT