Troubleshooting

beginner troubleshooting

Editor Doctor Pro · Troubleshooting & FAQ

Troubleshooting

Common issues and how to resolve them.

Code Audit tab is empty

Symptom	The Code Audit tab in the Doctor shows no checks even after a scan.
Cause	The `com.unity.nuget.mono-cecil` package is missing or the `EDP_HAVE_CECIL` define is not set.
Solution	Open Window > Kronnect > Editor Doctor Pro > Settings > Integrations and click Install Cecil package. Unity recompiles once and the rule set lights up. If the install button is grayed out, open Window > Package Manager, search for Mono Cecil, and install version 1.10.2 or later manually.

Scenes tab missing in the Doctor

Symptom	SPP is installed in the project but the Doctor doesn't show the Scenes tab.
Cause	The `EDP_SPP_BRIDGE` scripting define is not set, so the bridge asmdef is excluded from compilation.
Solution	Open Settings > Integrations and click Enable Scene Pilot Pro bridge. Unity recompiles; the Scenes tab appears after the recompile completes. See SPP Bridge for the full setup.

Cmd+Z didn't revert my fix

Symptom	You applied an auto-fix, pressed Cmd+Z, but the fix is still there.
Cause	A small set of fixes don't enter Unity's Cmd+Z stack - notably `AssetDatabase.MoveAsset` (used by the Conventions MoveStrayAssetFix) and the soft-delete in Safe Delete. They go through the Action History instead.
Solution	Open Window > Kronnect > Editor Doctor Pro > Action History, find the entry, and click Restore. For move actions, the action moves the asset back to its original path. For soft-deletes, the action restores from the Trash.

Scan is slow on a large project

Symptom	A full scan with Code Audit enabled takes minutes.
Cause	Code Audit walks every assembly with Cecil. On projects with many assemblies (50+) the IL parse dominates wall-clock time.
Solution	Three options: (1) restrict the scope via Custom paths in the Doctor header to scan only the subtree you changed; (2) disable rule buckets you don't need under Settings > Rules (e.g. naming conventions); (3) run the CLI with `--module asset-health` on quick passes and the full scan only on release cuts.

STRAY check produces too many findings

Symptom	`EDP-LINT-STRAY` flags many assets the team considers correctly placed.
Cause	The default confidence threshold (0.8) and minimum sample size (5) may not match your project's organisation - especially when several folders share a type.
Solution	Open Settings > Conventions. Raise the confidence threshold to 0.9 (only fires when ≥ 90% of a type lives in one folder) or raise the minimum sample size to 10. The detector will only trigger when a clear convention is present.

Safe Delete wants to delete a file you need

Symptom	Safe Delete lists an asset as a candidate even though you know it's used (e.g. loaded by reflection, referenced from a custom build pipeline, or imported by a tool that doesn't go through AssetDatabase).
Cause	The dependency walker can only follow what AssetDatabase + serialized references know about. Reflection-loaded assets, runtime `Resources.Load` with computed paths, and external tooling references are invisible.
Solution	Add a protection rule under Settings > Safe Delete. Rules accept path globs and an optional reason. Once added, the asset (or the entire path glob) never appears as a candidate. Check the rule into git so the whole team picks it up.

SPP bridge define stuck after uninstalling SPP

Symptom	You uninstalled Scene Pilot Pro and now the project shows compile errors about `ScenePilotPro.Editor`.
Cause	The `EDP_SPP_BRIDGE` define is still set so the bridge asmdef is still compiling - and failing because SPP types are gone.
Solution	The Doctor's hero banner shows a Disable Bridge button when SPP is missing. Click it; Unity removes the define and recompiles cleanly. The Doctor itself lives in Core (not in the bridge asmdef), so the banner is reachable even while the bridge fails to compile.

Still need help?

Visit the Kronnect Support or post in our Discord. Our team will get back to you shortly.

Was this page helpful? |