**This is an old revision of the document!**

Getting Started with GDevelop

GDevelop is a free, open-source, and cross-platform game creation tool that anyone can use to create gameswithout programming skills.

This guide explains how to get up and running with GDevelop.

Step 1: Install GDevelop

GDevelop is available for all major operating systems, including the latest versions of Windows, macOS, and Linux. To download GDevelop, visit gdevelop-app.com/download.

The installation instructions depend on the operating system.

Windows

Double-click the executable. This installs GDevelop, launches the app, and adds an icon to the Desktop.

macOS

  1. Open the DMG file.
  2. Drag “GDevelop.app” into the “~/Applications” directory.

Linux

  1. Expand the archive file to access an AppImage file.
  2. Run chmod a+x GDevelop.AppImage to make the file executable.
There's an online version of GDevelop available at editor.gdevelop-app.com. In general though, we recommend using the desktop version.

Step 2: Create a new project

  1. Launch GDevelop.
  2. Click Create a new project.
  3. Choose a location for the project.
  4. Select one of the projects from the Starters tab, such as Platformer or 8-bit Space Shooter, or start a game from scratch by selecting the Empty project.

The projects in the Starters tab demonstrate how to create entire games, while the projects in the Examples tab demonstrate how to create specific features.

Step 3: Preview the game

If a project has at least one scene, which all of the starter projects do, a Preview button is available via the toolbar. This button launches a preview of the game.

Next step

Read the Platformer Tutorial. You'll learn how to create a platforming game from absolute scratch and discover many of GDevelop's fundamental concepts, such as objects, events, and expressions.

Try GDevelop online or download the desktop version

When you have downloaded GDevelop, open the installer and install the software.:

  • On Windows machines, after launching the installer, use the GDevelop icon on your desktop to launch it. You can also uncompress the installer file (like a zip file) and put the software in any folder.
  • On MacOS, launch the DMG file, drag GDevelop into Applications, and open GDevelop from the Applications folder.
  • On Linux, uncompress the archive and launch the executable.

Once the application is launched, you will be presented with the start page. The start page allows you to open an existing project or to create a new project.

Create a new project

To create a new project, select “Create A New Project” on the start page.

A new window will open. It presents a list of options, allowing you to choose from templates/examples or to create a blank project. The examples are showing how to use a particular feature, while starters are more advanced games that you can try, study and modify.

Selecting the blank project includes no assets, events or scenes - it's an entirely empty game.

At the top of the window, you can select the location where would you like to store your new project.

Once you have selected the default location for your project, click on the name of a starter template or an example to open the game.

By default, new games that you create are saved in a folder called “GDevelop Projects”, located in your “Documents” folder.

Open an existing project

To re-open an existing project, select “Open a Project” on the start page.

Next, browse your local file system to select the project file. If you're using the GDevelop online version, you can save and load a file from Google Drive. GDevelop 5 project files are by default saved as “.json” files.

If you're a GDevelop 4 user, you can learn here how to save your project to open it with GDevelop 5.

Next step: start with tutorials

Continue reading the basic concepts to know how to use GDevelop.

The tutorials, along with the documentation, are the best ways to learn. It is highly recommended that you read and follow a tutorial!

Learn more about GDevelop

For further information on how to use GDevelop, visit the following pages where everything is explained in more detail:

Be sure to also check the examples bundled with GDevelop! They are a good way to learn about the different capabilities of the software.