This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
gdevelop5:getting_started [2018/04/25 23:34]
4ian [Open existing project]
gdevelop5:getting_started [2020/10/17 04:03] (current)
Line 1: Line 1:
-# Getting Started+# Getting Started ​with GDevelop
-## Try GDevelop ​online or download the desktop version+GDevelop ​is a free, open-source,​ and cross-platform game creation tool that anyone can use to create games *without* programming skills.
-* To get started, you can [try GDevelop online](https://​4ian.github.io/​GD).  +This guide explains how to get up and running with GDevelop.
-* To create your own game, save and then publish it, [download the desktop version on GDevelop ​website](http://​compilgames.net).+
-When you have GDevelop ​downloaded, open and install it, then use the GDevelop icon on your desktop to launch it. +## Step 1: Install ​GDevelop
-Once the application is launched you are going to be presented with the start page where you can open an existing project or create a new one. +
-{{ :gdevelop5:​start_page.png?nolink |}}+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](https://​gdevelop-app.com/​download/​).
-==== Open existing project ====+The installation instructions depend on the operating system.
-To open an existing project, select the relevant option on the start page. +### Windows
-Next you need to browse your local file system to open a project. GDevelop ​5 project files are normally saved as "​game.json"​ file. Find it, and select it to open. +Double-click the executableThis installs ​GDevelop, launches the app, and adds an icon to the Desktop.
-{{ :​gdevelop5:​project-file.png?​nolink&​200 |}}+
-The icon of this file is depends on whether you have any default application installed on your computer to edit such file.+### macOS
-<​note>​By default, ​the locations of the saved game.json files are: +1. Open the DMG file
-  * Windows: C:/Users/​YourUserName/​GDevelop Projects, +2. Drag "​GDevelop.app"​ into the "~/Applications" ​directory.
-  * macOS and Linux: GDevelop Projects ​directory ​in your home folder. +
-Once you have the project open you should be presented with the editor but we come back to it later, first let see how to create a new project. ​+### Linux
-**Note:** GDevelop ​4 users, you can [[gdevelop5:​getting_started:​open-gdevelop-4-project|learn here how to save your project to open it with GDevelop 5]].+1. Expand the archive file to access an [AppImage](https://​appimage.org/​) file. 
 +2. Run `chmod a+x GDevelop.AppImage` ​to make the file executable.
-==== Create a new project ==== +<​note>​There'​s an online version ​of GDevelop ​available at [editor.gdevelop-app.com](https://editor.gdevelop-app.com/). In general thoughwe recommend using the desktop version.</​note>​
-To create a new project select the relevant option on the start page +
-In the next window you can choose from templates or create a blank project. A template is already including some assets and events to get you started, the blank project including nothing so you need to start from scratch. +
-{{ :​gdevelop5:​create-new-project-window.png?​nolink |}} +
-Since the purpose ​of this page is to get you started with using GDevelop, let create a blank project. +
-First, select the location where would you like to store your new projectAs you may notice a default location is already set for you on the bottom of this page. +
-{{ :gdevelop5:​project-default-location.png?nolink |}} +
-If you would like to select a different location, click on the choose folder button next to it: +
-{{ :​gdevelop5:​choose-folder-button.png?nolink |}} +
-Nextbrowse ​the file system on your computer to select a folder to store your project inside+
-Once you selected or decided to stick with the default location, just click the Empty game button to create ​blank project+## Step 2: Create ​new project
-{{ :​gdevelop5:​empty-game-button.png?​nolink |}}+
-Next you should see the editor either created ​blank project or selected ​template.+1. Launch GDevelop. 
 +2. Click **Create ​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 game from scratch by selecting the **Empty** project.
-==== Learn more ====+{{:​gdevelop5:​getting-started-create-new-project.jpg|}}
-For further information on how to use GDevelopI recommend to visit the following pages where everything is explained ​in more detail: +The projects in the **Starters** tab demonstrate ​how to create entire gameswhile the projects ​in the **Examples** tab demonstrate how to create specific features.
-  ​[[gdevelop5:​interface|]] +
-  ​[[gdevelop5:​objects|]] +
-  ​[[gdevelop5:​behaviors|]]+
 +## Step 3: Preview the game
-==== Tutorials ==== +If a project has at least one scene, which all of the starter projects do, a **Preview** button is available via the toolbarThis button launches a preview of the game.
- +
-You can also find tutorials on the wiki: +
-  ​[[gdevelop5:​tutorials|]] +
- +
-==== Examples ==== +
- +
-You can find various examples and templates here to get you started with making your own games from scratch: +
-  ​[[https://​gametemplates.itch.io/​|gametemplates.itch.io]]+
 +## Next step
 +Read the [Platformer Tutorial](http://​wiki.compilgames.net/​doku.php/​gdevelop5/​tutorials/​platform-game/​start). 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.