Godot GDScript Formatter

The Godot GDScript Formatter provides automated, style-driven formatting for Godot projects. It addresses inconsistent code aesthetics by applying a configurable set of rules to all GDScript files, ensuring uniform indentation, spacing, and line structure without changing program behavior. This benefits solo developers seeking clean locally managed code and teams requiring predictable previews, faster code reviews, and simpler onboarding for new contributors. By targeting only whitespace, line endings, and token layout, the tool reduces debates about style while preserving the original logic and semantics of each script.

Conceptually, the formatter operates on static analysis of GDScript structure. It tokenizes the source, identifies blocks (functions, conditionals, loops, and classes), then applies user-configured rules for indentation depth, maximum line length, and blank line handling. It can emit a formatted version and an optional diagnostic report highlighting potential style anomalies. It supports Godot 3.x and 4.x differences through a target_version setting and can run in dry-run mode to preview changes before writing.

Core features include deterministic formatting passes, optional tabs or spaces, consistent trailing newlines, and optional per-project configuration. Optional advanced features include integration hooks for CI pipelines and editor plugins, plus an export-friendly summary of changes. The tool does not perform semantic analysis or runtime evaluation; it only rewrites layout while preserving behavior. It is suitable for large codebases and iterative reformats during project maintenance.

Use cases span pre-commit formatting, code review standardization, onboarding automation, and cross-team consistency. The formatter's unique value lies in its Godot-specific awareness, language-level parsing, and version-sensitive rules, delivering stable results across repositories. It supports clear diagnostics, easy reconfiguration, and output that can be re-ingested by editors or CI systems for automated enforcement.