Share your extension

Extensions that you can search and use in GDevelop have been created and shared by the community.

If you have created a reusable behavior that can be useful in more than one game, or a set of actions/conditions/expressions, consider sharing them with the community! Doing so is very easy.

1) Export your extension

Open your extension from the Project Manager. At the top of the list of functions, you can see a button “Edit Extension Options”. Click on it to open the configuration of the extension:

1.1) Complete the extension information

Fill all the fields, in particular, the name and the descriptions of your extension:

  • The name will be displayed in the search (and will be useful for people to search for your extension),
  • The short description will also be displayed in the search results, along with the icon,
  • The description will be displayed when installing the extension. It should contain a quick explanation about how to use the extension.
  • The version is a version number, in the format X.Y.Z. For example: 1.0.0. Start with 1.0.0 if you're confident that your extension is ready, or 0.0.1 if it's still subject to changes.
  • Tags is a list of comma-separated “tags”, that help to search the extension. Read the existing tags when you search for extensions to get some inspiration. Reuse existing tags as possible.
  • Author is your name, your email or GitHub handle (if you have one).

1.2) Ensure your extension follow the best practices

1.3) Export the extension to a .json file

Once you're done, click on “Export Extension” at the bottom, then on “Export to a File”. Choose a file and enter the same name as your extension, finishing by .json. For example: Flash.json.

2) Submit your extension to the community

All extensions submitted on Github must follow the best practices, otherwise you will be asked to follow them before getting a review.

To submit an extension to GDevelop you will need need a GitHub profile to continue.

Once you are logged into your Github account, open a new issue on this GitHub repository. Github will not let you upload a .json file, so you will need to use a tool to package your extension into ZIP format. You can read other ways to submit extensions directly on the repository README.

Complete all the information in the issue checklist, then attach your .json file and submit the issue. See an example here.

To help the reviewer understand your extension, it is beneficial to include a video, screenshot, or example game that demonstrates what your extension does.

Your extension will get reviewed to ensure high quality and a good experience for GDevelop users. It is common for the reviewer to request changes, so don't feel discouraged if this happens to you! Once your extension passes the final review, it will be added to GDevelop. The extension will become available immediately and will not have to wait for a new version of GDevelop to be released.