GDScript Formatter

GDQuest·GDQuest.GDScript.Formatter

A faster code formatter for GDScript and Godot 4

A fast code formatter for Godot's GDScript programming language built with Tree Sitter GDScript and Topiary. The goal of this project is to provide a simple GDScript code formatter that runs fast enough and that's both easy to contribute to and to maintain while an official one built into the engine remains unavailable. Making it in user space allowed us to get a production-ready tool quickly and to update it anytime from here on. This project aims to follow the official GDScript style guide

winget install --id GDQuest.GDScript.Formatter --exact --source winget

Latest 0.25.0·September 6, 2026

Release Notes

A fast code formatter for GDScript in Godot 4.

Changelog

Added

• Added --verbose option to print one line per formatted file (#227)

Changed

• Removed space between lambda function name and parameter list • Force @export and @onready annotations to stay on the same line as a variable, but keep other annotations separate, including annotations on local variables (#333) • Stop trying to format any code containing parse errors. Until now we tried to still format definitions around the code with errors, but this can lead to cases where the formatter produces invalid code • Add line wrapping for annotation arguments (#330)

Fixed

• Fixed an extra comma being inserted after a trailing comment in a lambda function argument (#304) • fixed certain export annotations being moved out of their respective groups (#308) • Preserve up to one blank line used to group elements in "containers" like enums • Fixed losing blank line between statements in a body if the previous statement has an inline comment (#320, thanks @Buitragox for the fix) • Fixed various edge cases with ignored directories:paths are now normalized before comparison • Fixed special get syntax with parentheses having an extra space (#314) • Output warnings to stderr when using reorder and safe mode together (#332) • Removed the space between ... and variadic parameter names (#331) • Fixed incorrect indentation for match patterns using and or or (#328)

Learn more about the formatter in the GDScript Formatter documentation

Installer type: zip

x64—A17E40EF62DB561084C5CC7C3C21C937CC68BBC014A71A50FB1F16519A37AEF6
arm64—4930FE132260BD8ACC12A5B4306CAA6655913C6F22BD0D25D554F6173D0C812B

Details

Homepage
https://github.com/GDQuest/GDScript-formatter
License
MIT
Publisher
GDQuest
Support
https://github.com/GDQuest/GDScript-formatter/issues
Copyright
Copyright (c) 2025 GDQuest

Tags

formattergdscriptgodotgodot-enginerusttree-sitter

Older versions (1)

0.20.1
x64—C5BE3E835C6FF6887D1EFA4D5D995D5B609AA357FCAC3B47402ADFF79F81C0A0
arm64—7DFD0415FD94B0C7D5AA8C703433E53671BBDC9D660421BCF1D4FD4580EC2BAE