GDevelop is a full-featured, no-code, open-source game development software. You can build 2D, 3D and multiplayer games for mobile (iOS, Android), desktop and the web. GDevelop is fast and easy to use: the game logic is built up using an intuitive and powerful event-based system and reusable behaviors.
This repository hosts the open-source, free example projects for GDevelop.
| ❔ I want to... | 🚀 What to do |
|---|---|
| 🎮 Use GDevelop to make games | Go to GDevelop homepage to download the app! |
| Try an example | Examples can be searched and downloaded directly from GDevelop. |
| Contribute to GDevelop itself | Visit GDevelop GitHub repository. |
| Create/improve an example | Read below. |
If you've created an example with GDevelop, you can submit it to be shared with the rest of the community.
- Create your game with GDevelop.
- Make sure to follow the requirements and best practices on this page.
Note that for now, we're trying to keep a fairly high quality bar for examples, so you might be asked to adapt your game according to reviewer feedbacks. Don't feel bad about this! This is normal process and here to help making examples as good as possible for new users. If we take too much time to review your example, you can send a ping on the issue. ⏰
- Create a
preview.png(case sensitive) 16:9 image that will let users see what the game looks like. You can also add athumbnail.png(case sensitive) with a 16:9 ratio (the game logo/banner) shown in the examples list of the game engine or asquare-icon.png(the game icon). All of these images should be located at the root folder of the game. (If the game will be used in quick customization, then add athumbnail-quick-customization.png(case sensitive) with a 16:9 ratio to be shown on the get started page of GDevelop.) - Create a new
README.mdfile and write a short description of the game. - Export your game and all its resources to a zip file (you can save it in a new folder and zip this folder).
- Submit it! You can either submit it here, attaching the zip file.
If you know how to create Pull Requests, you can also clone this repository and add your example in the examples folder, and then open a PR. Examples are deployed automatically when pushed to the main branch:
To add a game to the homepage the game have to be listed in the scripts/generate-database.js file.
All examples provided on this repository are MIT licensed, unless specified otherwise.