gh

.circleci/config.yml

@@ -6,7 +6,7 @@ orbs:
 jobs:
   install:
     docker:
-      - image: cimg/node:14.17.0
+      - image: cimg/node:20.13.1
     steps:
       - checkout
       - run: npm install
@@ -19,7 +19,7 @@ jobs:
             - GDevelop/newIDE/app # As we have a dependency on GDevelop sources.
   tests:
     docker:
-      - image: cimg/node:14.17.0
+      - image: cimg/node:20.13.1
     steps:
       - checkout
       - attach_workspace:
@@ -29,7 +29,7 @@ jobs:
       - run: npm run check-format
   build:
     docker:
-      - image: cimg/node:14.17.0
+      - image: cimg/node:20.13.1
     steps:
       - checkout
       - attach_workspace:
@@ -42,7 +42,7 @@ jobs:
             - dist
   deploy:
     docker:
-      - image: cimg/node:14.17.0
+      - image: cimg/node:20.13.1
     steps:
       - checkout
       - attach_workspace:

.github/ISSUE_TEMPLATE/config.yml

@@ -4,5 +4,5 @@ contact_links:
     url: https://discord.gg/rjdYHvj
     about: Discuss on the forum or on the Discord to get help with an example or create a new one.
   - name: GDevelop Forums
-    url: https://forum.gdevelop-app.com
+    url: https://forum.gdevelop.io
     about: You can also discuss examples on the forum.

.github/ISSUE_TEMPLATE/new-example.yml

@@ -0,0 +1,57 @@
+name: ✨New example
+description: Submit a new example to be added to the repository
+title: 'New example: <title>'
+labels: [✨ New example]
+body:
+  - type: markdown
+    attributes:
+      value: '# Example submission'
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear and concise description of what the example is, how useful it is.
+      placeholder: This example shows how to...
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      description: Make sure you have done all of this before submitting!
+      options:
+        - label: "I've followed all of [the best practices](https://wiki.gdevelop.io/gdevelop5/community/guide-for-submitting-an-example)."
+          required: true
+        - label: My game has a proper name in the game properties.
+          required: true
+        - label: My game package name begins with `com.example.`.
+          required: true
+        - label: My game has all events unfolded.
+          required: true
+        - label: I've added myself as the author in the game properties.
+          required: true
+        - label: I've included a file called "README.md" with a description in proper English, explaining what this example is doing.
+          required: true
+        - label: I confirm that this game and all of its resources can be integrated to this GitHub repository, distributed and MIT licensed.
+          required: true
+        - label: I've cleaned unused resources.
+          required: true
+  - type: textarea
+    id: example
+    attributes:
+      label: Game project folder
+      description: Please drag into this text field a zip file containing your game project folder and all its resources (images, sounds, etc...). **DO NOT PUT A LINK TO AN EXTERNAL SERVICE LIKE GOOGLE DRIVE!**
+      placeholder: '[MyExample.zip]()'
+    validations:
+      required: true
+  - type: textarea
+    id: preview
+    attributes:
+      label: Game preview
+      description: You can add a few screenshots of your game and a link to play it to show how cool your example is.
+      placeholder: 'Try my game on gd.games...'
+    validations:
+      required: false
+  - type: markdown
+    attributes:
+      value: |
+        If your game is high quality and useful, it will be added to the list of GDevelop community examples.
+        Thanks for contributing to GDevelop! 🙌

.github/ISSUE_TEMPLATE/report-an-issue-with-an-example.md

@@ -8,16 +8,21 @@ assignees: ''
 ---
 
 ### Describe the bug
+
 A clear and concise description of what the bug is.
 
 ### To Reproduce
+
 Steps to reproduce the behavior:
+
 1. Open '....' example
 2. Click on '....'
 3. See error
 
 ### Screenshots
+
 If applicable, add screenshots to help explain your problem.
 
 ### Additional context
+
 - GDevelop version: '...'

.github/workflows/calibreapp-image-actions.yml

@@ -7,20 +7,20 @@
 # For other scenarios, a new PR will be opened if any images are compressed.
 name: Compress images
 on:
-  pull_request:
-    paths:
-      - '**.jpg'
-      - '**.jpeg'
-      - '**.png'
-      - '**.webp'
-  push:
-    branches:
-      - main
-    paths:
-      - '**.jpg'
-      - '**.jpeg'
-      - '**.png'
-      - '**.webp'
+  # pull_request:
+  #   paths:
+  #     - '**.jpg'
+  #     - '**.jpeg'
+  #     - '**.png'
+  #     - '**.webp'
+  # push:
+  #   branches:
+  #     - main
+  #   paths:
+  #     - '**.jpg'
+  #     - '**.jpeg'
+  #     - '**.png'
+  #     - '**.webp'
   workflow_dispatch:
   schedule:
     - cron: '00 23 * * 0'
@@ -43,6 +43,9 @@ jobs:
           githubToken: ${{ secrets.GITHUB_TOKEN }}
           # For non-Pull Requests, run in compressOnly mode and we'll PR after.
           compressOnly: ${{ github.event_name != 'pull_request' }}
+          # Avoid progressive degradation of quality
+          pngQuality: '100'
+          minPctChange: '15'
       - name: Create Pull Request
         # If it's not a Pull Request then commit any changes as a new PR.
         if: |

.github/workflows/comment-links-to-changed-games-in-pull-requests.yml

@@ -0,0 +1,56 @@
+name: Comment with links to test the game(s) changed in a PR
+on:
+  pull_request:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Get changed files
+        id: changed-game-files
+        uses: tj-actions/changed-files@v23.1
+        with:
+          files: |
+            examples/**/*.json
+
+      - name: Output links to all changed game(s) as markdown
+        id: changed-games-markdown
+        run: |
+          CHANGED_GAMES_LINKS=""
+          for file in ${{ steps.changed-game-files.outputs.all_changed_files }}; do
+            CHANGED_GAMES_LINKS+="* https://editor.gdevelop.io?project=https://raw.githubusercontent.com/GDevelopApp/GDevelop-examples/$(echo ${GITHUB_HEAD_REF})/$file
+          "
+          done
+          [ -z "$CHANGED_GAMES_LINKS" ] && CHANGED_GAMES_LINKS="*No games are changed in this Pull Request.*"
+
+          # Support multiple lines
+          CHANGED_GAMES_LINKS="${CHANGED_GAMES_LINKS//'%'/'%25'}"
+          CHANGED_GAMES_LINKS="${CHANGED_GAMES_LINKS//$'\n'/'%0A'}"
+          CHANGED_GAMES_LINKS="${CHANGED_GAMES_LINKS//$'\r'/'%0D'}"
+
+          echo "::set-output name=changed-games-links::$CHANGED_GAMES_LINKS"
+
+      - name: Find the existing comment about games in the PR
+        uses: peter-evans/find-comment@v2
+        id: fc
+        with:
+          issue-number: ${{ github.event.pull_request.number }}
+          comment-author: 'github-actions[bot]'
+          body-includes: "### Preview the game(s) changed or added in this Pull Request"
+
+      - name: Create or update comment
+        uses: peter-evans/create-or-update-comment@v2
+        with:
+          comment-id: ${{ steps.fc.outputs.comment-id }}
+          issue-number: ${{ github.event.pull_request.number }}
+          body: |
+            ### Preview the game(s) changed or added in this Pull Request
+
+            ${{ steps.changed-games-markdown.outputs.changed-games-links }}
+
+            ---
+            This is an automatic message displaying links to the games in this PR - double check the JSON in case of doubt.
+          edit-mode: replace

.gitpod.yml

@@ -0,0 +1,14 @@
+# This configuration file to initialise a Gitpod workspace.
+
+tasks:
+  - name: Install dependencies and build
+    init: |
+          cd ..
+          git clone https://github.com/4ian/GDevelop.git
+          cd GDevelop/newIDE/app 
+          npm install
+          cd ../../../GDevelop-examples
+          npm install
+          npm run build -- --gdevelop-root-path ../GDevelop
+
+

README.md

@@ -1,16 +1,16 @@
-![GDevelop logo](https://raw.githubusercontent.com/4ian/GDevelop/master/Core/docs/images/gdlogo.png 'GDevelop logo')
+![GDevelop logo](https://raw.githubusercontent.com/4ian/GDevelop/master/newIDE/GDevelop%20banner.png 'GDevelop logo')
 
-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.
+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 example projects for GDevelop.
+This repository hosts the open-source, free example projects for GDevelop.
 
 ## Getting started
 
 | ❔ I want to...                 | 🚀 What to do                                                         |
 | ------------------------------- | --------------------------------------------------------------------- |
-| Download GDevelop to make games | Go on [GDevelop website](https://gdevelop-app.com) to download GD!    |
+| 🎮 Use GDevelop to make games   | Go to [GDevelop homepage](https://gdevelop.io) to download the app!   |
 | Try an example                  | Examples can be **searched and downloaded** directly from GDevelop.   |
 | Contribute to GDevelop itself   | Visit [GDevelop GitHub repository](https://github.com/4ian/GDevelop). |
 | Create/improve an example       | Read below.                                                           |
@@ -20,14 +20,20 @@ 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. Ensure you have the basic requirements ready:
-    - The **game name** and **author name** are properly filled in the properties of the game.
-    - Create a `README.md` file and enter the description of what the example is doing/useful for.
-    - Create a `thumbnail.png` file containing the icon of your example.
-3. **Export** your game and all its resources to a zip file (you can save it in a new folder and zip this folder).
-4. Submit it! You can either [submit it here](https://github.com/GDevelopApp/GDevelop-examples/issues/new/choose), 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](https://circleci.com/gh/GDevelopApp/GDevelop-examples/tree/main.svg?style=svg)](https://circleci.com/gh/GDevelopApp/GDevelop-examples/tree/main)
+2. Make sure to follow the [requirements and best practices on this page](http://wiki.compilgames.net/doku.php/gdevelop5/community/guide-for-submitting-an-example).
+   > 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](https://github.com/GDevelopApp/GDevelop-examples/issues/new/choose), 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](https://circleci.com/gh/GDevelopApp/GDevelop-examples/tree/main.svg?style=svg)](https://circleci.com/gh/GDevelopApp/GDevelop-examples/tree/main)
+
+## Developers
+
+To add a game to the homepage the game have to be listed in the `scripts/generate-database.js` file.
 
 ## License