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 doctorIt 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 errorCommon problems
Questions
Still stuck?
Open an issue with the output of
gdsuite doctor and of the command that failed.