Project Health Toolkit – Scan, Understand & Fix Issues Fast

Project Health Toolkit is a powerful editor tool designed to help you quickly identify, understand, and resolve common issues in your Unity project.

Instead of digging through scenes and assets manually, you can scan your project, see what matters most, and fix problems with confidence.

🔍 Smart Project & Scene Scanning

• Detect missing scripts, broken prefab links, and null references
• Find duplicate assets and unused asset candidates
• Identify performance risks like high draw calls and heavy meshes
• Analyze texture memory usage and large audio assets

🧠 Understand Before You Fix

Every issue includes:

• What it means
• Why it matters
• Impact (FPS, memory, build size, stability)
• What can break
• Confidence level (Safe / Review / Risky)

⚡ Fix Issues Safely

• One-click fixes for common problems
• Batch fix with preview and change summary
• Automatic material relinking during duplicate cleanup
• Safe workflow with Undo support and Trash-based cleanup

📊 Clear Dashboard & Workflow

• Health score with visual indicators
• Top issues based on impact score
• Recommended next action
• Quick fix simulation (estimated improvements)
• Focus mode to highlight the most important problems

🔄 Smart Iteration

• Re-check only affected items after fixes
• Before / after comparison
• Scan history and issue timeline
• Pin important issues and track them

🧪 Pre-Build Validation

Run a full project check before building:

• Combined scene + asset validation
• Clear “Ready for Build” status
• Actionable list of issues to fix

📦 Reports & Export

• Human-readable reports (summary + issues + recommendations)
• JSON and clipboard export
• Scene-by-scene breakdown

🛡️ Safe & Transparent

• Safe / Review / Risky labels for every fix
• Explain panel with reasoning behind each recommendation
• No destructive actions without confirmation
• Duplicate assets moved to Trash instead of permanent deletion

🎯 Who Is This For?

• Indie developers
• Teams preparing builds
• Mobile developers optimizing performance
• Anyone tired of hunting issues manually

⚠️ Limitations

• Draw call analysis is heuristic, not profiler-accurate
• Some checks are suggestions, not strict errors
• Unused asset detection is approximate

💡 Why Use This Tool?

Save hours of debugging and optimization by focusing only on what actually matters.

I'm always open to suggestions! If you have any questions about the asset or ideas for improvements, feel free to reach out via email: [email protected]

Online documentation and full info are here: https://9476764.gitbook.io/assets/project-health-toolkit