Project Health Scanner for Godot 4

Project Health Scanner is an editor plugin that adds a dock for finding common project problems before export.

What it finds

• Broken res:// references in text resources and scripts.
• Missing main scene, project name, or project icon.
• Broken or duplicate autoload paths.
• Missing or empty export presets.
• Large files over 5 MB.
• File paths with spaces or special characters.
• Case-only path collisions.
• Screenshot and preview folders that may need .gdignore.
• Likely unused asset files.

Install

Copy addons/project_health_scanner into a Godot 4 project, then enable it from Project > Project Settings > Plugins.

Use

Open the Health Scanner dock and click Scan Project. After scanning, click Export Markdown to create res://project_health_report.md.

Notes

The unused asset check is heuristic and can report false positives when files are loaded dynamically, generated, referenced from binary resources, or included through export filters.

License

MIT.