Troubleshooting

Troubleshooting And Testing

Resolve missing overlays, wrong cameras, unavailable counters, graph sensitivity, update cadence, and package test setup.

  • Missing overlay
  • Wrong camera
  • Unavailable values
  • Package tests

Use this page when the overlay is missing, attached to the wrong camera, reporting unavailable values, or too visually noisy for the current test.

Troubleshooting

The Overlay Does Not Appear

Check the following:

  • Visible On Start is enabled, or Show() has been called.
  • The scene has an active enabled camera with CameraType.Game.
  • The intended camera is assigned to Target Camera.
  • The target camera has a non-empty culling mask.
  • The target camera has a valid pixel width and height.
  • The component is enabled.

The Overlay Appears On The Wrong Camera

Assign Target Camera directly in the inspector.

Auto-attach is convenient for simple scenes, but explicit assignment is best for split-screen, camera stacks, minimaps, cinematic cameras, and projects that create cameras at runtime.

Some Values Show --

The current Unity runtime is not providing that metric on the current platform or graphics API. This is expected for some combinations of platform, render pipeline, device, and build type.

The Text Is Too Large Or Too Small

Adjust Scale. You can also reduce visible sections to keep the overlay compact on low-resolution displays.

The Graph Is Too Sensitive

Increase Graph Top Ms if spikes are clipping at the top of the graph. Adjust Target FPS so the marker line reflects your actual performance target.

The Overlay Updates Too Often

Lower Text Hz or Graph Hz. Text values and graph geometry can update at different rates.

Testing

The package includes editor and play mode tests under:

Tests/Editor
Tests/Runtime

To make package tests appear in a consuming project's Unity Test Runner, add the package to the testables list in the project manifest:

{
  "testables": [
    "com.azkarindustries.azkarscreenstats"
  ]
}

License

Copyright (c) 2026 Azkar Industries LLC. All rights reserved.

Licensed to Unity Asset Store customers under the Unity Asset Store End User License Agreement, unless a separate license is provided.

https://unity.com/legal/as-terms