Godot Project Doctor Mini 0.2.8 Tools 4.6 Community

Submitted by user Vav_Labs; MIT; 2026-05-18

Godot Project Doctor Mini is a Godot 4 editor plugin that scans a project and generates Markdown and JSON diagnostic reports. It runs as a dock inside the Godot editor and also supports headless operation for CI pipelines.

Checks performed:
- Missing scripts: scene and resource references to scripts that no longer exist.
- Broken resource paths: referenced res:// paths that cannot be found on disk.
- Large textures: textures above a configurable size threshold.
- Heavy scenes: scenes with node counts above a configurable threshold.
- Scripts using _process(): marks scripts with per-frame work for manual review.
- Empty folders: helps keep the project tree tidy.
- Export preset readiness: detects missing export presets and obvious preset gaps.
- Import settings issues: flags unreadable .import files, missing source references, and large textures in raw import mode.

Features:
- One-click scan from the Project Doctor dock.
- Severity summary (errors, warnings, info) with severity filters.
- Settings panel for thresholds, ignore patterns, baseline path, and experimental checks.
- Direct buttons to open the generated Markdown and JSON reports.
- Headless scan script for local automation and CI.
- Reusable GitHub Actions workflow with artifact uploads and optional PR comment summaries.
- Baseline file and ignore pattern support to suppress accepted findings.

Each scan writes reports/project-doctor-report.md and reports/project-doctor-report.json. The Markdown report uses collapsible sections and renders cleanly on GitHub. The JSON report uses a stable schema suitable for CI automation.

The plugin is editor-only and does not appear in the running game. Scans a 500-file project in under one second on a typical machine.