GDSuite Docs

Welcome to GDSuite

Keep a Godot project tidy, correct and easy to change, with one tool.

GDSuite watches over your GDScript while you build your game. It tidies the layout of your scripts, points at likely mistakes, finds errors in scripts you haven't opened, runs your tests, and tells you which scripts are getting too big to change safely.

You install one thing, GDSuite, and run one command to check everything:

gdsuite check

What it does for you

A taste

Here is what formatting does to a script written in a hurry:

Before
extends Node

const MAX_HEALTH=100
var health:int=MAX_HEALTH

func take_damage(amount:int)->void:
    health=max(health-amount,0)
    if health==0 :
        died.emit()
After
extends Node

const MAX_HEALTH = 100
var health: int = MAX_HEALTH


func take_damage(amount: int) -> void:
	health = max(health - amount, 0)
	if health == 0:
		died.emit()

And here is what a check finds in a small project:

player/player.gd:11:1: warning[class-definitions-order]: Definition out of order in global scope: `signals` must come before `others`
hud.gd:10: error[missing-resource]: "res://levels/level_2.tscn" does not exist

The second line is a scene that was renamed or deleted: the game would only fail when the player reaches the exit.

Do I need to be a programmer?

No. If you write GDScript in the Godot editor, GDSuite is for you. Every page here starts with what a feature does and why it helps, before any command. GDSuite runs from a terminal today, and its tests already have a panel in the Godot editor; the rest of its features are coming to the editor too.

Start here