Scan, diagnose, and optimize your Unity project with Project Doctor. Detect issues, analyze build size, improve project health, and apply safe Assisted Fixes with confirmation and restoration.Project Doctor is an Editor-only diagnostic and optimization toolkit for Unity, compatible with Built-in, URP, and HDRP. Scan scenes and projects, identify issues, analyze real and estimated build size, understand what consumes space, and get actionable optimization guidance. Custom Scriptable Render Pipelines are not officially supported.Find problems before they become bigger problems.Project Doctor is an Editor-only diagnostic and optimization utility for inspecting Unity project health, loaded scenes and potential build-size contributors.SCAN YOUR PROJECTSCAN PROJECT inspects project assets, settings, Prefabs and scenes currently loaded in the Unity Editor. Closed scenes are never opened automatically.To inspect a specific scene, open it manually and use SCAN CURRENT SCENE. The active scene is analyzed in its current Editor state, including unsaved changes.All scans are read-only.PROJECT HEALTH SCOREReview a health score for the content that was actually scanned. Findings are organized into Critical, Warning, Optimization and Information categories.Project scores do not include scenes that were closed and therefore not inspected.ACTIONABLE DIAGNOSTICSEach finding provides contextual information and a recommended action.Use Ping or Locate to inspect the affected target, Guide to review a proposed resolution, or Ignore when a reported condition is intentional.Search and filtering tools help navigate larger result sets.ASSISTED FIXES — GUIDED LOCAL CORRECTIONSAssisted Fixes is a local, rule-based correction workflow. It is not an AI assistant and does not require an external service.Before confirming a supported correction, Project Doctor displays:Why the finding mattersThe proposed changeSafety informationA read-only Target InspectorSupported corrections require explicit user confirmation. Context-dependent or unsupported findings provide manual guidance instead of automatically modifying the project.Completed corrections appear in the CORRECTED history for the current Unity session. Restoration is offered only when it can be performed without overwriting newer user changes.Project Doctor never saves modified scenes automatically. Version control or a project backup is recommended before applying corrections.BUILD SIZE DOCTORBuild Size Doctor provides two complementary workflows:Predictive analysis of potential build contributorsAnalysis of Unity’s latest successful BuildReportInspect asset categories, top contributors, build-inclusion evidence and prioritized optimization guidance.Build Size Doctor can identify common inclusion sources such as Resources, StreamingAssets, package dependencies, fonts, SDF atlases, shaders and serialized assets.Predictive values are estimates, not guaranteed final build sizes. Estimated savings are displayed only when sufficient information is available.KEY FEATURESProject asset, settings and Prefab diagnosticsDiagnostics for scenes currently loaded in UnityFocused Current Scene ScanHealth scoring for scanned contentCritical, Warning, Optimization and Information classification8 configurable scanner familiesEconomy Mode for larger projects or slower workstationsSearch and diagnostic filteringPing and Locate navigationLocal, safety-guided Assisted FixesRead-only Target InspectorExplicit confirmation before supported correctionsCORRECTED session historyProtected restoration when safely availableIgnore and Restore workflowsPDF, CSV and JSON report exportPredictive build-size analysisUnity BuildReport analysisBuild contribution and optimization diagnosticsCOMPATIBILITYUnity 2022.3 LTS and Unity 6Windows development environmentBuilt-in Render PipelineUniversal Render PipelineHigh Definition Render PipelineUnity UI package (com.unity.ugui) requiredCore scanning is render-pipeline independent. Some diagnostics are enabled only when the relevant render pipeline is detected. Custom Scriptable Render Pipelines are not officially supported.Project Doctor contains Editor-only code and does not add runtime components to the final Player build.Plugin: Project Doctor - Unity Project Health ScannerVersion: 1.0.0 | Type: Editor utilitySCANNING AND DIAGNOSTICS• Scans project assets, settings, Prefabs and scenes currently loaded in Unity.• SCAN PROJECT never opens closed scenes.• Current Scene Scan inspects the active scene, including unsaved changes.• Health scores cover only inspected content.• Critical, Warning, Optimization and Information levels.• 8 configurable scanner families.• Search, filters, progress feedback, Ping, Locate, Guide and Ignore actions.ASSISTED FIXES• Local rule-based workflow; no AI or external service required.• Safety guidance, read-only Target Inspector and explicit confirmation.• Supported texture, mesh and audio importer corrections.• Missing MonoBehaviour and selected Rigidbody corrections in loaded scenes.• Manual guidance when automatic correction is unsuitable.• CORRECTED session history with protected restoration.• Scans are read-only; scenes are never saved automatically.BUILD SIZE DOCTOR• Predictive estimates and latest successful Unity BuildReport analysis.• Category breakdown, top contributors and per-asset inclusion evidence.• Resources, StreamingAssets, enabled-scene and package dependency analysis.• Prioritized guidance and estimated savings when reliably calculable.REPORTING• PDF, CSV and JSON export.TECHNICAL INFORMATION• Module: ProjectDoctor.Editor (Editor).• Unity Visual Scripts: 0 | C# scripts: 50.• Development platform: Windows.• Target builds: Not applicable; Editor-only with no runtime code in Player builds.• Unity 2022.3 LTS and Unity 6.• Built-in, URP and HDRP. Custom SRPs are not officially supported.• Dependency: Unity UI (com.unity.ugui).• No third-party Asset Store dependencies.• Documentation: Included PDF User Manual and Quick Start.AI tools were used as development assistants during the creation process, mainly to support development, documentation, and UI/UX ideation. All final content and functionality were reviewed, tested, and validated by the publisher.
