Troubleshooting

beginner troubleshooting

Scene Pilot Pro · Troubleshooting & FAQ

Troubleshooting

This page covers the most common issues users encounter with Scene Pilot Pro and how to resolve them.

Health window shows no results

Symptom	The Health window scans but reports zero findings, even on a scene you expect to have issues.
Cause	Some or all health checks may be disabled in the settings.
Solution	Open the Health window settings (gear icon in the toolbar). Review the Disabled checks list and re-enable any checks you want to run. Make sure Show info checks is enabled if you want to see informational findings. Click Scan to re-run the diagnostics.

Bookmarks not persisting

Symptom	Camera bookmarks (Places) disappear after closing and reopening Unity or switching scenes.
Cause	Bookmark data is stored in `ProjectSettings/ScenePilotPro/bookmarks/`. If this folder is not included in version control or is being deleted, bookmarks will be lost.
Solution	Verify that the folder `ProjectSettings/ScenePilotPro/` exists in your project. Add this folder to your version control system (Git, Plastic SCM, etc.). Make sure your `.gitignore` or equivalent is not excluding this folder.

Smart Focus not finding a good viewpoint

Symptom	Double-clicking an object in Browse or clicking Smart Focus results in a viewpoint that is too close, too far, or partially obstructed.
Cause	Smart Focus calculates the viewpoint based on the object's renderer bounds. Very large objects, objects without renderers, or objects fully enclosed inside other geometry may produce suboptimal results.
Solution	For very large objects (terrain, large buildings), manually frame the area of interest after Smart Focus. For objects without renderers (empty parents, trigger colliders), Smart Focus will use the transform position - you may need to adjust manually. Use the Places system to save good viewpoints that you return to frequently.

Health scan feels slow

Symptom	The Health scan takes a long time on a very large scene.
Cause	Scenes with thousands of objects and many unique textures/materials require more processing time.
Solution	The scan uses an 8 ms per-frame budget, so the editor should remain responsive. The scan spreads its work across multiple frames to avoid freezing. If you only need to check specific areas, disable unneeded check categories in the settings to speed up the scan. Texture and material checks require importing asset metadata, which can be the slowest part. Disable these if you only care about object-level diagnostics.

Object Notes not showing in Scene View

Symptom	Notes are visible in the Notes window but no floating windows appear in the Scene View.
Cause	Floating notes are only shown when you double-click a note to open it. They are not displayed automatically.
Solution	Open the Notes window (`Ctrl+Shift+N`). Double-click the note you want to see as a floating sticky in the Scene View. The floating window will appear and remain visible until you close it.

Still stuck? Visit the Kronnect Discord for direct support.

Was this page helpful? |