Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Redot.

Checking the stable version of the documentation...

Qt Creator

Qt Creator is a free, open source IDE for all desktop platforms.

Importing the project

  • From the Qt Creator's main screen select New Project > Import Project > Import Existing Project.

../../../_images/qtcreator-new-project.png

  • Under Location select the Redot root folder.

../../../_images/qtcreator-set-project-path.png

  • Next, you can choose which folders and files will be visible to the project. While C/C++ files are added automatically, other extensions can be potentially useful: *.glsl for shader files, *.py for buildsystem files, *.java for Android platform development, *.mm for macOS platform development.

../../../_images/qtcreator-apply-import-filter.png

Note

You can change this configuration later by right-clicking on your project and selecting the Edit Files... option.

../../../_images/qtcreator-edit-files-menu.png

  • Finish the import.

  • Open the project_name.includes file and add a line containing . to it to correctly enable the code completion.

../../../_images/qtcreator-project-name-includes.png

  • From the left-side menu select Projects and open the Build tab.

  • Delete the predefined make build step.

../../../_images/qtcreator-projects-build.png

  • Click Add Build Step > Custom Process Step to add a new build step with the following settings:

    Command

    scons

    Arguments

    See Introduction to the buildsystem for a full list of arguments.
../../../_images/qtcreator-set-scons-command.png

Note

If the build fails with Could not start process "scons", it can mean that scons is not in your PATH environment variable. In this case, you'll have to specify the full path to the SCons binary.

Debugging the project

  • From the left-side menu select Projects and open the Run tab.

  • Under Executable specify the path to your executable located in the <Redot root directory>/bin folder. The name depends on your build configuration, e.g. godot.linuxbsd.editor.dev.x86_64 for 64-bit LinuxBSD platform with platform=editor and dev_build=yes. You can use %{buildDir} to reference the project root, e.g: %{buildDir}/bin/redot.linuxbsd.editor.dev.x86_64.

  • If you want to run a specific project, specify its root folder under Working directory.

  • If you want to run the editor, add -e to the Command line arguments field.

../../../_images/qtcreator-run-command.png

To learn more about command line arguments, refer to the command line tutorial.

Code style configuration

Developers must follow the project's code style and the IDE should help them follow it. By default, Qt Creator uses spaces for indentation which doesn't match the Redot code style guidelines. You can change this behavior by changing the Code Style in Tools > Options > C++.

../../../_images/qtcreator-options-cpp.png

Click on Edit to change the current settings, then click on Copy Built-in Code Style button to set a new code style. Set a name for it (e.g. Redot) and change the Tab policy to be Tabs Only.

../../../_images/qtcreator-edit-codestyle.png

If you run into any issues, ask for help in one of Redot's community channels.