GDSuite Docs

Troubleshooting & FAQ

What to do when something doesn't work, and answers to common questions.

Start with doctor

When something seems wrong, run this in your project's folder:

gdsuite doctor

It shows where Godot and each tool are, and their versions. When everything is in place, it ends with [gdsuite:doctor] status ok. When something is missing, each line says what to run:

[gdsuite:doctor] warn  godot not found; install Godot and add to PATH, or set GODOT_EXE, or set project.godot_exe in gdsuite.toml
[gdsuite:doctor] warn  gdtidy not found; run `gdsuite setup` to install the toolchain
[gdsuite:doctor] status error

Common problems

Questions

Still stuck?

Open an issue with the output of gdsuite doctor and of the command that failed.