search

GDevelopApp / GDevelop-examples

Repository of examples and templates for GDevelop - the open-source, no-code game engine
https://gdevelop.io
54 stars 20 forks source link
game-development game-engine gamedev gdevelop hacktoberfest open-source

readme

GDevelop logo

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.

GDevelop Examples

This repository hosts the open-source, free example projects for GDevelop.

Getting started

❔ 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.

Submit your example

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. (If the game will be used in quick customization, then add a thumbnail-quick-customization.png (case sensitive) with a 16:9 ratio to be shown on the get started page of GDevelop.)
  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: CircleCI

Developers

To add a game to the homepage the game have to be listed in the scripts/generate-database.js file.

License

All examples provided on this repository are MIT licensed, unless specified otherwise.