Differences

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/03/05 23:03]
4ian
gdevelop5:getting_started [2020/11/06 23:36] (current)
davidturnbull
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. On Windows machines, use the GDevelop icon on your desktop to launch it. On MacOS, open GDevelop from the Applications folder or drag it to your dock for permanent placement.+## Step 1: Install ​GDevelop
  
-Once the application ​is launchedyou will be presented with the start pageThe start page allows you to open an existing project or to create a new project+GDevelop ​is available for all major operating systemsincluding ​the latest versions of Windows, macOS, and Linux. To download GDevelop, visit [gdevelop-app.com/​download](https://​gdevelop-app.com/​download/​).
  
-{{ :​gdevelop5:​start_page.png?nolink |}} +The installation instructions depend on the operating system.
-==== Create a new project ====+
  
-To create a new project select the relevant option on the start page.+### Windows
  
-A 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+Double-click the executable. This installs GDevelop, launches the app, and adds an icon to the Desktop.
  
-Selecting the blank project includes no assets or events. Think of it as you would a blank sheet of paper. This template allows you to start from scratch.+### macOS
  
-{{ :​gdevelop5:​create-new-project-window.png?nolink |}}+1. Open the DMG file. 
 +2. Drag "​GDevelop.app"​ into the "​~/​Applications"​ directory.
  
-At the bottom of the window, you can select the location where would you like to store your new project. +### Linux
-{{ :​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. +1. Expand ​the archive file to access ​an [AppImage](https://​appimage.org/​) file. 
-==== Re-open an existing project ====+2. Run `chmod a+x GDevelop.AppImage` ​to make the file executable.
  
-To re-open ​an existing projectselect 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 thoughwe recommend using the desktop version.</​note>​
  
-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.+## Step 2: Create ​new project
  
-{{ :gdevelop5:project-file.png }}+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 icon for this file depends on whether or not you have any default application installed on your computer to edit a "​json"​ files.+{{:​gdevelop5:​getting-started-create-new-project.jpg|}}
  
-<​note>​By default, the locations of the saved game.json files are: +The projects in the **Starters** tab demonstrate how to create entire gameswhile the projects in the **Examples** tab demonstrate how to create specific features.
-  ​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 a game for the first time.+## Step 3: Preview ​the game
  
-**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]]. +If a project ​has at least one scenewhich all of the starter projects do, a **Preview** button is available via the toolbar. This button launches ​preview ​of the game.
- +
-==== Next step: start with tutorials ​ ==== +
- +
-Continue reading **[[gdevelop5:​tutorials:​basic-game-making-concepts| the basic concepts to know how to use Gdevelop]]**. +
- +
-The tutorialsalong with the documentationare 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 good way to learn about the different capabilities ​of the software.//+
  
 +{{:​gdevelop5:​getting-started-preview-button.jpg|}}
  
 +## 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.