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/05/19 14:08]
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.:+## 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
-==== Create a new project ====+
  
-To create a new project select ​the relevant option on the start page.+Double-click ​the executable. This installs GDevelop, launches ​the app, and adds an icon to the Desktop.
  
-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. ​+### macOS
  
-Selecting ​the blank project includes no assets or eventsThink of it as you would a blank sheet of paperThis template allows you to start from scratch.+1. Open the DMG file. 
 +2Drag "​GDevelop.app"​ into the "​~/​Applications"​ directory.
  
-{{ :​gdevelop5:​create-new-project-window.png?​nolink |}}+### Linux
  
-At the bottom of the window, you can select the location where would you like to store your new project+1. Expand ​the archive file to access an [AppImage](https://​appimage.org/​) file
-{{ :​gdevelop5:​project-default-location.png?nolink |}}+2. Run `chmod a+x GDevelop.AppImage` to make the file executable.
  
-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. +<​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>​
-==== Re-open an existing project ====+
  
-To re-open an existing ​project, select the relevant option on the start page. +## Step 2: Create a new project
  
-Next,  browse your local file system to open a project. ​GDevelop 5 project ​files are normally saved as ".json" filesFind it in the file menu that opens and select it to open the game.+1. Launch GDevelop. 
 +2. Click **Create ​new project**. 
 +3. Choose a location for the project. 
 +4Select 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:project-file.png }}+{{:​gdevelop5:​getting-started-create-new-project.jpg|}}
  
-The icon for this file depends on whether or not you have any default application installed on your computer ​to edit a "​json"​ files.+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.
  
-<​note>​By default, ​the locations of the saved game.json files are: +## Step 3: Preview ​the game
-  * 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. +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.
- +
-**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.//+
  
 +{{:​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.