Skip to main content
Version: 1.11 (Beta)

Project Settings

Project Settings keep the choices for one project together. Use them to rename the project, change its Godot editor, add Git, choose a code editor, or open Godot in windowed mode.

Open Project Settings​

  1. Open the Projects view.
  2. Select on the project card.

The drawer opens on the Project tab. The other tabs are Source Control, Code Editor, and Launch.

Project Settings drawer showing the Project tabProject Settings drawer showing the Project tab

Rename a project​

Edit Project name to change the name shown in Godot Launcher. The project folder on disk is not renamed.

Select Also rename Godot project if you also want to change the name stored in project.godot. Leave it off to change only the launcher entry.

The name must be unique in the launcher and cannot be empty. Select Update to save it.

Change the Godot editor​

Choose an installed or registered editor from Godot Editor, then select Update. The project will use that editor the next time you open it.

You can choose an editor from the same major Godot version. If the project uses Visual Studio Code or VSCodium, the launcher also updates that editor's project setup.

See Change Project Editor Version for .NET editors, custom builds, and missing editor recovery.

Add Git to an existing project​

Open Source Control. If the project does not have a Git repository, select Initialize Git.

warning

Do not use Initialize Git if the project is already inside a larger Git repository. The launcher may create a second repository inside it.

This creates the repository immediately. It does not add Git template files or create a first commit. See Using Git With Godot Launcher for new-project Git setup and help when Git is unavailable.

Choose a code editor​

Project Settings Code Editor tab with Visual Studio Code selected and the Reset config actionProject Settings Code Editor tab with Visual Studio Code selected and the Reset config action

Open Code Editor and choose Visual Studio Code, VSCodium, or None. Select Update to save the choice. Godot will open project scripts in the selected editor.

Restore the code editor setup​

This choice applies only on this computer. Use Reset config if Godot stops opening scripts in the selected editor. See Code Editor Settings to set up an editor or change its location.

Open Godot in windowed mode​

Open Launch, enable Use windowed mode, and select Update. Godot Launcher will request a regular window each time it opens this project.

Leave this setting off if you want Godot to use its normal window behavior. See Launch a Project in Windowed Mode for more information.