GDevelop is a full-featured, open-source game development software, allowing to create desktop and mobile games without any knowledge in a specific programming language. All the game logic is built up using an intuitive and powerful event-based system.

This repository hosts the example projects for GDevelop.

If you've created an example with GDevelop, you can submit it to be shared with the rest of the community.

1. Create your game with GDevelop.
2. 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. ⏰

3. Create a preview.png (case sensitive) 16:9 image that will let users see what the game looks like. You can also add a thumbnail.png (case sensitive) with a 16:9 ratio (the game logo/banner) shown in the examples list of the game engine or a square-icon.png (the game icon). All of these images should be located at the root folder of the game.
4. Create a new README.md file and write a short description of the game.
5. Export your game and all its resources to a zip file (you can save it in a new folder and zip this folder).
6. 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.