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 community made extensions for GDevelop. Extensions can provide new behaviors for objects, actions, conditions or expressions.
| ❔ I want to... | 🚀 What to do |
|---|---|
| Download GDevelop to make games | Go on GDevelop website to download GD! |
| 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. |
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.
-
Create your extension in your game with GDevelop: see the documentation about functions and custom behaviors.
-
Make sure the descriptions, tags, names are properly filled in the options of the extension.
-
Export your extension to a .json file from GDevelop.
-
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/communityfolder. Finally open a Pull Request.
-
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.
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:
- open a Pull Request to move it from the
communityfolder to thereviewedfolder. - A member of the GDevelop Extensions Team will then review it and give you feedback on what to do to have it reviewed.
- 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.
All extensions provided on this repository are MIT licensed.