Skip to content
Tutorials Center
My learning

Topics

Lesson 2 of 36 ยท Getting Started

Installing Godot and Using the Project Manager

Download Godot 4, choose between the standard and .NET builds, understand the Project Manager, pick a renderer and version control option, and create your first project safely.

Godot is delivered as a single program you can run without installing anything. There is no account, no launcher and no license key. This lesson walks you through downloading the editor, opening the Project Manager and creating a project, and explains the choices you meet on the way so you can make them with confidence.

Installing and running the editor happens on your computer; this site cannot run Godot. Everything below is a description of what you will see, plus a small Python stand-in that models the project-creation checklist.

Download the editor

Go to the official website, godotengine.org, open the Download page and pick the build for your system (Windows, macOS or Linux). You will usually see two flavours:

Build Use it when
Standard You will write GDScript (this tutorial) or use C++ through GDExtension.
.NET You want to write C#. It also runs GDScript, but the download is larger and needs the .NET SDK.

Pick Standard for this tutorial. You get a ZIP file containing the editor executable (on Windows Godot_v4.x-stable_win64.exe; on macOS an app bundle). Extract it somewhere you will remember, for example C:\Tools\Godot or ~/Applications. There is nothing to install. To "upgrade", download the newer version and keep both: Godot versions live side by side, which is useful because a project should normally be finished with the version you started with.

Stable releases are named like 4.4-stable. Avoid "dev", "beta" and "rc" builds for real projects: they are for testing and can change between snapshots.

Steam and package managers (such as winget, Homebrew or Flatpak) also distribute Godot. They offer the same editor, so use whichever you prefer.

The Project Manager

Launch the executable. The first window is the Project Manager. It lists your projects and lets you create, import, scan, run, edit or remove them. The main buttons are:

  • Create: starts a new project folder.
  • Import: opens an existing project by selecting its project.godot file.
  • Scan: looks inside a folder for projects and adds them all.
  • Edit / Run: open the editor on a project, or run the game directly.
  • Remove: removes the entry from the list. It does not delete the files.

There are also tabs for Asset Library (free plugins, templates and demos you can download into a project) and a version selector in newer releases that lets you manage multiple installed editors.

Create a project

Press Create. You choose:

  1. Project name: shown in the window title and the list. Spaces are fine.
  2. Project path: an empty folder. Use Create Folder so Godot makes one named after the project. Prefer a short path without unusual characters, and do not place the project inside a cloud-synced folder that rewrites files while you work.
  3. Renderer: Forward+, Mobile or Compatibility (described in What Is Godot?). For a 2D learning project, any is fine. If you plan to export to the web, choose Compatibility now so your visuals match what you will ship.
  4. Version control metadata: choose Git to have Godot create a .gitignore and .gitattributes for you. Even if you do not use Git yet, this is a good default.

Press Create & Edit. The editor opens on an empty project.

flowchart LR
    A["Download ZIP"] --> B["Extract and run"]
    B --> C["Project Manager"]
    C --> D["Create: name, folder, renderer, Git"]
    D --> E["Editor opens"]

From download to an open editor, with no installer.

What gets created

Inside your new folder Godot writes a few things immediately:

  • project.godot: a plain-text file with your project settings.
  • icon.svg: a default project icon.
  • .gitignore and .gitattributes (if you chose Git).
  • A hidden .godot/ folder: a cache of imported assets. It is regenerated automatically and must not be committed to version control.

We explore these in Project Structure and Files.

Editor settings you may want to change

Open Editor > Editor Settings:

  • Interface > Editor > Display Scale and Theme: increase the scale on high-DPI screens.
  • Interface > Editor > Editor Language: Godot ships translations for many languages.
  • Text Editor > Appearance > Show Line Numbers: leave it on; error messages quote line numbers.
  • Text Editor > Behavior > Indent: GDScript uses tabs by default. Never mix tabs and spaces in one file.

These are editor settings, stored per user, not in the project. Project > Project Settings is the other place and belongs to the game itself (window size, input map, physics layers).

Stand-in: a project-creation checklist

This Python snippet is not Godot. It models the form you just read about, rejecting the mistakes that cause the most trouble (a non-empty folder, an export target that does not fit the renderer).

Python Stand-in (Python): validating new-project choices

Press Run (or Ctrl + Enter) to see the result here.

Program input ยท what you'd type while the program runs

Type the answers before you press Run, one per line. Each time the program reads a line (with input()), it gets the next line from this box.

Troubleshooting

  • The editor does not start (Windows): install the latest graphics drivers. If Vulkan is unsupported, run with --rendering-driver opengl3 or use the Compatibility renderer.
  • A project made in a newer version will not open in an older one: open it with the same or a newer editor; the reverse is not supported. Keep a backup before upgrading.
  • "Project not found" after moving a folder: use Import and select the new project.godot.

Check your understanding

Quick check ยท 4 questions

of 4 answered You scored / 4 ยท perfect!

  1. 1. Which Godot build should you download to follow this tutorial?

    Standard supports GDScript, which this tutorial uses. The .NET build is for C# users.
  2. 2. What does the Remove button in the Project Manager do?

    Remove only edits the list. Your files stay on disk.
  3. 3. Which folder is a regenerated cache that should not be committed to Git?

    The hidden .godot folder holds imported data and is rebuilt automatically.
  4. 4. Which renderer should you pick if you plan to export to the web?

    Web exports use the OpenGL-based Compatibility renderer, so choosing it early avoids surprises.

Summary

  • Godot is a single downloadable program: extract it and run. Keep several versions side by side if you need to.
  • Use the Standard build for GDScript and .NET for C#.
  • The Project Manager creates, imports, scans, runs and lists projects.
  • Pick a renderer and Git metadata when creating the project; you can change the renderer later.
  • Editor Settings are per user; Project Settings belong to the game.

Next: Your First Project: Hello, World