Getting Started
Follow this guide to run your first scan and clean up your project.
1. Open the Dashboard
Go to Tools > Missing Reference Killer > Scan Project. The main dashboard will open.
2. Run a Scan
Click the large SCAN PROJECT button. The tool will iterate through:
- 📂 Scenes: All scenes in Build Settings + currently open scenes.
- 📦 Prefabs: All prefabs in your
Assetsfolder. - 📄 ScriptableObjects: All configuration references.
[!TIP] scanning large projects (100GB+) may take a minute. The progress bar will show you the exact status.
3. Analyze Results
Issues are displayed in a clean list with color-coded severity:
- â–ˆ Red (Critical): Missing Script. The component itself is broken.
- â–ˆ Yellow (Warning): Null Reference. A variable field is empty but the component is valid.
4. Fix Issues
You have three ways to fix issues:
- Auto-Fix Safe: Click the FIX SAFE button to automatically resolve all non-critical warnings (e.g., clearing null fields).
- Manual Fix: Click the Select button next to an issue to ping the object in the Hierarchy/Project window.
- Smart Suggest: Click Suggest to let the AI find the missing asset for you.
Next Steps
- Learn about the Smart Assist system.
- Configure Build Safety Checks.