> For the complete documentation index, see [llms.txt](https://docs.edgegap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.edgegap.com/fr/docs/sample-projects/godot/arena-shooter.md).

# Jeu de tir en arène

Hébergez un jeu de tir en arène multijoueur Godot 4 sur Edgegap avec des serveurs dédiés et le matchmaking, en utilisant l’exemple Edgegap Arena Shooter.

Explorez comment héberger des projets Godot sur Edgegap en utilisant des techniques du [Super Star Fighter](https://github.com/DumpsterFireLabs/SuperStarFighter) jeu de tir en arène vue du dessus de Dumpster Fire Labs.

Les joueurs appuient sur **RECHERCHER UNE PARTIE**, le [Matchmaker Edgegap](https://docs.edgegap.com/fr/learn/matchmaking.md) les regroupe et lance un serveur dédié à proximité d’eux, puis le serveur s’arrête de lui-même lorsque la partie est terminée.

Cet exemple montre :

* **Godot 4.7.2** jeu avec GDScript, exporté en tant que serveur dédié Linux sans interface,
* **code réseau autoritaire côté serveur** sur un port WebSocket unique - le serveur exécute toute la simulation, et les clients se connectent avec `wss://`,
* **Matchmaker Edgegap** intégration - le client crée un ticket, attend un serveur, puis le rejoint,
* **auto-arrêt du serveur** - le serveur arrête son propre déploiement après la partie, ou quand personne ne rejoint,
* **remplissage par des PNJ** - les PNJ prennent les places vides, afin qu’un joueur solo obtienne quand même une partie.

{% hint style="success" %}
Voir [EDGEGAP.md](https://github.com/edgegap/game-sample-godot-arena-shooter/blob/main/EDGEGAP.md) dans le dépôt d’exemple pour la liste complète des fichiers Edgegap et des paramètres du serveur.
{% endhint %}

## ✔️ Préparation

Avant de commencer, vous aurez besoin de :

* [projet d’exemple Arena Shooter](https://github.com/edgegap/game-sample-godot-arena-shooter) (modifié pour Edgegap),
* Godot 4.7.2 - l’exemple télécharge sa propre copie (voir ci-dessous),
* Python 3 - pour exécuter le script de build de l’exemple.

<details>

<summary><a href="https://www.docker.com/products/docker-desktop/">Installez Docker Desktop (ou Docker CLI)</a></summary>

* [Installez Docker Desktop à partir de la source officielle](https://www.docker.com/products/docker-desktop/) (aucun compte requis).
* Redémarrez votre ordinateur après avoir terminé l'installation.

</details>

☑️ Téléchargez la version de Godot épinglée et les modèles d’exportation dans le dossier ignoré `.tools` depuis PowerShell à la racine de votre dépôt :

{% code collapsedlinecount="10" %}

```powershell
.\tools\bootstrap.ps1
```

{% endcode %}

Rien n’est installé à l’échelle du système.

## ⚡ Déployer et connecter

### 1. Construire l’image du serveur

☑️ Pour commencer, vous devrez [créer un compte gratuit avec Edgegap](https://app.edgegap.com/auth/register). Aucune carte de crédit requise.

☑️ Trouvez votre [Registre de conteneurs](https://docs.edgegap.com/fr/learn/advanced-features/edgegap-container-registry.md#getting-your-credentials) nom de projet et vos identifiants, puis connectez-vous avec `docker login registry.edgegap.com`.

☑️ Exportez le serveur dédié Linux, puis construisez et poussez votre image :

{% code collapsedlinecount="10" %}

```bash
python tools/build.py bootstrap
python tools/build.py build server-linux-x64 --skip-gate
docker build --platform linux/amd64 -f edgegap/Dockerfile -t registry.edgegap.com/<project>/arena-shooter:<tag> builds/beta-19/server-linux-x86_64
docker push registry.edgegap.com/<project>/arena-shooter:<tag>
```

{% endcode %}

{% hint style="danger" %}
:x: **À ÉVITER — écraser les tags existants ou utiliser `latest`  tag** — cela déploiera un cache obsolète.\
:white\_check\_mark: **À FAIRE — toujours incrémenter votre tag de version** et déployer la nouvelle version.
{% endhint %}

Votre serveur écoute sur le port WebSocket `7000`. En dehors d’un déploiement Edgegap, il se comporte exactement comme le jeu d’origine.

✅ Vous pouvez maintenant passer à l’étape suivante.

### 2. Créer une version d’application

☑️ [Créer une application](https://app.edgegap.com/application-management/applications/list) nommée `godot-arena-shooter`, et une version nommée `v1` avec :

* votre `registry.edgegap.com/<project>/arena-shooter:<tag>` image,
* votre nom d’utilisateur et jeton du registre de conteneurs, afin qu’Edgegap puisse extraire votre image,
* ressources 0,5 vCPU et 1 Go de mémoire,
* [port](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md#port-mapping) `7000`, nommé `gameport`, protocole **WS**, avec **mise à niveau TLS** activée.

{% hint style="warning" %}
Les clients se connectent avec `wss://`, donc **la mise à niveau TLS doit être activée**, sinon les clients ne peuvent pas se connecter. Voir [Websockets (WS) et Websockets sécurisés (WSS)](https://docs.edgegap.com/fr/learn/orchestration/deployments.md#websockets-ws-and-secure-websockets-wss).
{% endhint %}

Facultativement, définissez des variables d’environnement sur votre version d’application :

* `EDGEGAP_NPC_FILL` - remplit la partie avec des PNJ jusqu’à ce nombre de vaisseaux (par défaut `4`, `0` désactive les PNJ),
* `EDGEGAP_START_GRACE` - secondes à attendre que tous les joueurs appariés se joignent après le premier (par défaut `30`),
* `EDGEGAP_JOIN_TIMEOUT` - secondes avant qu’un serveur vide s’arrête de lui-même (par défaut `120`),
* `EDGEGAP_ROUNDS_TO_WIN` - manches nécessaires pour gagner la partie (par défaut `3`).

✅ Vous pouvez maintenant passer à l’étape suivante.

### 3. Créer un Matchmaker

☑️ Ouvrez [Matchmaker](https://app.edgegap.com/matchmaker-management-v2/matchmakers/list) la page dans le tableau de bord et cliquez sur **Créer**.

☑️ Téléversez `edgegap/matchmaker-config.json` depuis l’exemple. Modifiez `application.name` et `application.version` si les vôtres sont différents.

La configuration comporte un seul profil `casual` pour 2 à 4 joueurs. Après 30 secondes d’attente, un seul joueur peut être apparié seul.

☑️ Cliquez sur **Créer et démarrer**, puis attendez que votre matchmaker soit prêt.

☑️ Copiez l' **URL de l’API** et **jeton d’authentification**.

✅ Vous pouvez maintenant passer à l’étape suivante.

### 4. Connecter le client

☑️ Collez l’URL de votre matchmaker et le jeton d’authentification dans `src/client/edgegap/edgegap_settings.gd`:

{% code collapsedlinecount="10" %}

```gdscript
const MATCHMAKER_URL := "https://<your-matchmaker-url>"
const MATCHMAKER_AUTH_TOKEN := "<your-auth-token>"
```

{% endcode %}

Vous pouvez aussi définir `EDGEGAP_MATCHMAKER_URL` et `EDGEGAP_MATCHMAKER_TOKEN` des variables d’environnement au lancement de votre client.

{% hint style="info" %}
Le jeton d’authentification appartient à votre matchmaker et ne donne aucun accès à votre compte Edgegap, il est donc sûr de l’intégrer dans les clients du jeu. **Ne mettez jamais votre jeton d’API Edgegap dans le client.**
{% endhint %}

☑️ Construisez un client Windows avec `python tools/build.py build windows --skip-gate`, ou exécutez `.\tools\start-client.ps1`.

☑️ Démarrez deux clients et appuyez sur **RECHERCHER UNE PARTIE** dans les deux.

Les deux clients obtiennent le même serveur et le rejoignent. La partie commence lorsque tous les joueurs appariés sont présents, ou 30 secondes après l’arrivée du premier, avec des PNJ dans les places vides.

🙌 Félicitations pour votre premier déploiement apparié sur Edgegap !

## 🔄 Cycle de vie de la partie

1. Le client crée un ticket avec `casual` profil, puis le vérifie toutes les 2 secondes jusqu’à ce qu’un serveur soit attribué.
2. Le matchmaker déploie `godot-arena-shooter` près des joueurs. Le serveur lit combien de joueurs ont été appariés à partir de [`MM_TICKET_IDS`](https://docs.edgegap.com/fr/learn/matchmaking/matchmaker-in-depth.md#injected-variables).
3. Le client rejoint `wss://<host>:<external port>` via le code de connexion directe du jeu. Le mot de passe du lobby est l’identifiant de requête du déploiement, donc seuls les joueurs appariés peuvent entrer.
4. Le serveur démarre la partie et remplit les places vides avec des PNJ, jusqu’à 4 vaisseaux.
5. 20 secondes après les résultats finaux, le serveur appelle `ARBITRIUM_DELETE_URL` pour arrêter son déploiement. Il s’arrête aussi si personne ne rejoint dans les 120 secondes, ou si tout le monde part pendant 30 secondes.

Chaque déploiement exécute une partie. Après une partie, les joueurs appuient sur **RECHERCHER UNE PARTIE** à nouveau.

Voir [Matchmaking](https://docs.edgegap.com/fr/learn/matchmaking.md) et [Déploiements](https://docs.edgegap.com/fr/learn/orchestration/deployments.md) pour en savoir plus.

## 🎵 Modifications par rapport à la version d’origine

La licence des ressources d’origine réserve le nom du jeu, la musique et le logo du studio aux builds non modifiés. Ce fork est renommé Edgegap Arena Shooter, avec la musique et le logo supprimés. Les effets sonores sont générés dans le code et jouent toujours.
