Skip to content

Repository of behaviors, actions, conditions and expressions to be used in GDevelop for creating games

License

Notifications You must be signed in to change notification settings

GDevelopApp/GDevelop-extensions

Repository files navigation

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 Official and Community Extensions

This repository hosts community made extensions for GDevelop. Extensions can provide new behaviors for objects, actions, conditions or expressions.

Getting started

❔ I want to... 🚀 What to do
🎮 Use GDevelop to make games Go to GDevelop homepage to download the app!
Use an extension Extensions can be searched and downloaded directly from GDevelop.
Contribute to GDevelop itself Visit GDevelop GitHub repository.
Create/improve an extension Read below.

Submit your extension to community extensions

If you've created an extension with GDevelop, you can submit it to be shared with the rest of the community. This Trello board has the extensions that are being worked on by the community.

  1. Create your extension in your game with GDevelop: see the documentation about functions and custom behaviors.
  2. Make sure the descriptions, tags, names are properly filled in the options of the extension.
  3. Export your extension to a .json file from GDevelop.
  4. Submit it! You can either:
    • Easy: submit it here, attaching the .json file (as a zip, because GitHub won't accept json files directly).
    • If you know how to use git: fork this repository, clone the git, add your .json file in extensions/community folder. Finally open a Pull Request.
  5. Your extension will be added after a automated checks and a quick safety check. 🚀

Note: If automated checks are failing, please adapt your extension and submit it again to get it added! Even if we don't do a full review of all extensions, just safety checks, the automated checks must pass. Look at automated comments that will be added to the Pull Request corresponding to your submission.

Get your extension (reviewed extensions)

Reviewed extensions are community extensions that got reviewed and adapted to meet all the best practices that are listed here.

If your community extension is very useful and you think its quality is good enough:

  1. open a Pull Request to move it from the community folder to the reviewed folder.
  2. A member of the GDevelop Extensions Team will then review it and give you feedback on what to do to have it reviewed.
  3. When it's ready, it will be merged and the extension now accessible in the "reviewed" extensions.

Note: When your extension gets reviewed, the extension team will ask you to adapt your extension to reach a fairly high quality bar. It's normal! The feedback is here to help get the extension in a state where it's super flexible and useful for all users.

License

All extensions provided on this repository are MIT licensed.