GDScript Formatter

The GDScript Formatter formats source code to enforce a consistent style across Godot projects. It accepts raw GDScript as input and returns a reformatted version that adheres to a defined style guide. It is designed for individual developers, teams, studios, and CI pipelines seeking predictable formatting.

Conceptually, the tool analyzes GDScript syntax and constructs a lightweight representation of code structure. It rewrites whitespace, bracket placement, and indentation while preserving semantics and avoiding changes to identifiers, strings, and comments. It supports multi-line statements, nested blocks, and type hints, ensuring readability without altering behavior.

Audience and value:Solo developers, code reviewers, and teams benefit from reduced review time, fewer style disputes, and faster onboarding for new contributors. By applying the same formatting rules across a project, collaboration improves, maintenance costs drop, and automation can reliably enforce standards in code reviews and PR checks.

Core features include configurable indentation (spaces or tabs), a maximum line length, and Godot version-aware rules for GDScript 3.x vs 4.x. Optional per-project configurations, preservation of trailing commas where appropriate, and an option to generate a patch/diff to show changes. It operates offline and integrates into CI workflows.