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 [2019/05/19 14:08]
gdevelop5:getting_started [2020/12/26 13:56] (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://editor.gdevelop-app.com).  +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](https://gdevelop-app.com).+
-When you have downloaded GDevelop, open the installer and install the software.:+## Step 1Install GDevelop
-* On Windows machinesafter *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. +GDevelop is available for all major operating systemsincluding the latest versions of Windows, macOS, and LinuxTo download GDevelop, visit [gdevelop-app.com/download](https://gdevelop-app.com/download/).
-* 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+The installation instructions depend on the operating system.
-{{ :gdevelop5:start_page.png?nolink |}} +* **Windows**double-click the executable. This installs GDevelop, launches the app, and adds an icon to the Desktop. 
-==== Create new project ====+* **macOS**: 
 +  * 1. Open the DMG file
 +  * 2. Drag "GDevelop.app" into the "~/Applications" directory. 
 +* **Linux**: 
 +  * 1. Open terminal.  
 +  * 2. Make the AppImage file executable by typing `chmod a+x GDevelop*.AppImage`. 
 +  * 3.  Run it: `./GDevelop*.AppImage` (or double click on the file).
-To create a new project select the relevant option on the start page.+<note>There's an online version of GDevelop available at [editor.gdevelop-app.com](https://editor.gdevelop-app.com/). In general though, we recommend using the desktop version.</note>
-new window will open. This window presents a list of options that allows you to  choose from templates/examples or to create a blank project.  The examples contain a template that is already to use. The template includes some assets and events to get you started. +## Step 2: Create a new project
-Selecting the blank project includes no assets or eventsThink of it as you would a blank sheet of paper. This template allows you to start from scratch.+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.
-{{ :gdevelop5:create-new-project-window.png?nolink |}}+{{:gdevelop5:getting-started-create-new-project.jpg|}}
-At the bottom of the windowyou can select the location where would you like to store your new project. +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:project-default-location.png?nolink |}}+
-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+## Step 3: Preview the game
-==== Re-open an existing project ====+
-To re-open an existing project, select the relevant option on the start page.  +If a project has at least one scenewhich all of the starter projects do, a **Preview** button is available via the toolbarThis button launches preview of the game.
- +
-Next,  browse your local file system to open a project. GDevelop 5 project files are normally saved as ".json" files. Find it in the file menu that opens and select it to open the game. +
- +
-{{ :gdevelop5:project-file.png }} +
- +
-The icon for this file depends on whether or not you have any default application installed on your computer to edit a "json" files. +
- +
-<note>By defaultthe locations of the saved game.json files are: +
-  * Windows: C:/Users/YourUserName/GDevelop Projects, +
-  * macOS and Linux: GDevelop Projects directory in your home folder. +
-</note> +
- +
-Once you have the project open,  you will be presented with the Gdevelop editors. Just as you've seen when you created game for the first time. +
- +
-**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]]. +
- +
-==== Next step: start with tutorials  ==== +
- +
-Continue reading **[[gdevelop5:tutorials:basic-game-making-concepts| 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 [[gdevelop5:tutorials|tutorial]]! +
-==== Learn more about GDevelop ==== +
- +
-For further information on how to use GDevelop, visit the following pages where everything is explained in more detail: +
- +
-  * [[gdevelop5:interface|]] +
-  * [[gdevelop5:objects|]] +
-  * [[gdevelop5:behaviors|]] +
-  * [[gdevelop5:events|]] +
-  * [[gdevelop5:all-features|]] +
-  * [[gdevelop5:publishing|]] +
- +
-==== Examples ==== +
- +
-//Be sure to check all examples bundled with GDevelop! They are a good way to learn about the different capabilities of the software.//+
 +## Next step
 +Read the [[gdevelop5:tutorials:platformer:start|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.