Project Doctor - Project Health Scanner

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 PROJECT

SCAN 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 SCORE

Review 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 DIAGNOSTICS

Each 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 CORRECTIONS

Assisted 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 matters
• The proposed change
• Safety information
• A read-only Target Inspector

Supported 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 DOCTOR

Build Size Doctor provides two complementary workflows:

• Predictive analysis of potential build contributors
• Analysis of Unity’s latest successful BuildReport

Inspect 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 FEATURES

• Project asset, settings and Prefab diagnostics
• Diagnostics for scenes currently loaded in Unity
• Focused Current Scene Scan
• Health scoring for scanned content
• Critical, Warning, Optimization and Information classification
• 8 configurable scanner families
• Economy Mode for larger projects or slower workstations
• Search and diagnostic filtering
• Ping and Locate navigation
• Local, safety-guided Assisted Fixes
• Read-only Target Inspector
• Explicit confirmation before supported corrections
• CORRECTED session history
• Protected restoration when safely available
• Ignore and Restore workflows
• PDF, CSV and JSON report export
• Predictive build-size analysis
• Unity BuildReport analysis
• Build contribution and optimization diagnostics

COMPATIBILITY

• Unity 2022.3 LTS and Unity 6
• Windows development environment
• Built-in Render Pipeline
• Universal Render Pipeline
• High Definition Render Pipeline
• Unity UI package (com.unity.ugui) required

Core 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.