> 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/jeux-web/fal-ai-relic-rumble.md).

# Relic Rumble de fal.ai

Transformez un jeu fal.ai en jeu multijoueur avec edgegap : un jeu three.js écrit par un agent de programmation, avec des personnages, des accessoires et des sons en 3D générés par fal, un système de matchmaking et un serveur Node.js faisant autorité pour chaque partie.

Découvrez comment mettre en ligne en multijoueur sur Edgegap un jeu créé avec [fal.ai](https://fal.ai/) des ressources.

![Relic Rumble : quatre personnages générés par fal dans une partie](https://raw.githubusercontent.com/edgegap/netcode-sample-fal-relic-rumble/main/docs/images/gameplay.jpg)

Relic Rumble est un [three.js](https://threejs.org/) jeu de groupe pour 4 joueurs : attrapez une relique, ramenez-la dans votre coin et bousculez quiconque tente d’en faire autant. Un agent de programmation a écrit le code, et fal.ai a généré tout ce que vous voyez et entendez : quatre personnages animés et dotés d’un squelette, avec des animations de marche et de course, les accessoires, le sol et les sons.

* **fal.ai** : utilisé pendant la création du jeu pour générer ses ressources.
* **Edgegap** : utilisé pendant les parties pour le matchmaking et pour fournir un serveur dédié par partie, à proximité des joueurs.

Cet exemple montre :

* **Règles regroupées dans un seul fichier**: `client/rules.js` ne contient aucun code pour le navigateur. La page l’exécute donc pour les parties en solo, tandis que le serveur de jeu exécute le même fichier pour les parties en ligne.
* **Des ressources qui restent dans la page** : le serveur représente les personnages par des cercles et les piliers par des boîtes. Aucun modèle, texture ou son n’est copié dans l’image du serveur, et l’ajout de nouvelles illustrations ne nécessite aucune nouvelle version du serveur.
* **Toutes les ressources sont facultatives** : si le fichier `client/assets.js` est vide, le jeu dessine des formes simples. L’exemple a été créé et testé en ligne de cette façon, avant la génération de la moindre ressource.
* **Le processus fal** : une image conceptuelle par personnage, puis conversion d’image en 3D avec création du squelette. Tous les prompts, modèles et tarifs figurent dans le fichier `PROMPTS.md`.
* **Rechercher une partie depuis la page** avec le [SDK JavaScript d’Edgegap](https://www.npmjs.com/package/@edgegap/sdk) : de 2 à 4 joueurs par partie, les places vacantes étant comblées par des bots.

{% hint style="info" %}
Consultez le [dépôt de l’exemple](https://github.com/edgegap/netcode-sample-fal-relic-rumble) pour découvrir le jeu, les scripts et les prompts fal, le serveur de jeu et un test de bout en bout de l’ensemble du processus.
{% endhint %}

## ✔️ Préparation

Avant de commencer, vous aurez besoin de :

* [l’exemple Relic Rumble de fal.ai](https://github.com/edgegap/netcode-sample-fal-relic-rumble), envoyé vers votre propre dépôt GitHub.
* [Node.js](https://nodejs.org/) 22 ou version ultérieure, pour exécuter le serveur et la page en local.
* Pour générer vos propres ressources : un [compte fal.ai](https://fal.ai/dashboard) avec quelques dollars de crédit, ainsi que le CLI fal `genmedia` ou le [serveur MCP fal](https://fal.ai/mcp) connecté à votre agent de programmation. Les ressources de l’exemple sont incluses, cette étape est donc facultative.

☑️ Essayez d’abord le jeu en local :

{% code collapsedlinecount="10" %}

```bash
npm install
npm run test:local
npm run client
```

{% endcode %}

`npm run test:local` lance une partie complète avec deux joueurs sans interface graphique sur un serveur local. Ouvrez `http://localhost:8080` et cliquez sur **Jouer contre des bots** pour jouer en solo.

☑️ Pour jouer en ligne sur votre propre machine, exécutez `npm run server` dans un deuxième terminal, puis cliquez sur **Serveur local :7777** dans deux onglets du navigateur.

## 🎨 Générer des ressources avec fal.ai

### 1. Personnages, accessoires et sons

☑️ Générez une image conceptuelle pour chaque personnage. Demandez une vue en pied en pose A, les bras éloignés du corps et les mains vides, afin que le personnage puisse être automatiquement équipé d’un squelette :

{% code collapsedlinecount="10" %}

```bash
bash art/gen-concepts.sh
```

{% endcode %}

☑️ Transformez chaque image en modèle 3D avec squelette. Le résultat comprend le modèle ainsi que des animations distinctes de marche et de course :

{% code collapsedlinecount="10" %}

```bash
genmedia run meshy/v7.1/image-to-3d --image_url "<concept url>" --enable_rigging true --pose_mode "a-pose" --target_polycount 12000 --async --json
genmedia status meshy/v7.1/image-to-3d <request_id> --result --json
```

{% endcode %}

☑️ Téléchargez chaque modèle, réduisez la taille de sa texture pour le Web et répertoriez-le dans `client/assets.js`:

{% code collapsedlinecount="10" %}

```bash
python art/fetch.py raider-blue
bash art/build.sh raider-blue
```

{% endcode %}

Les accessoires, la texture du sol et les sons suivent les mêmes étapes avec `art/gen-props.sh` et `art/gen-sfx.sh`.

{% hint style="success" %}
**Vos ressources ne sont jamais transmises au serveur de jeu.** Les collisions, la portée et la vitesse sont des valeurs définies dans `client/rules.js`. Le moteur de rendu met chaque modèle à l’échelle pour qu’il ait une taille exprimée en unités du monde : vous pouvez donc remplacer n’importe quel modèle sans modifier de règle.
{% endhint %}

{% hint style="warning" %}
**Un modèle avec squelette indique une taille incorrecte** avec la boîte englobante par défaut de three.js, car son squelette possède sa propre échelle. Mesurez plutôt les sommets déformés, comme le fait `fit()` dans `client/render.js`, sinon le personnage s’affichera beaucoup trop petit.
{% endhint %}

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

## ⚡ Déployer et connecter

### 2. Créer l’image du serveur

☑️ Pour commencer, vous devrez [créer un compte gratuit sur Edgegap](https://app.edgegap.com/auth/register). Aucune carte bancaire n’est requise.

☑️ Trouvez le nom et les identifiants de votre projet [Container Registry](https://docs.edgegap.com/fr/learn/advanced-features/edgegap-container-registry.md) .

☑️ Dans votre dépôt GitHub, ouvrez **Paramètres**, puis **Secrets et variables**, puis **Actions**, et ajoutez :

* variable `EDGEGAP_REGISTRY_PROJECT` - le nom de votre projet de registre,
* secret `EDGEGAP_REGISTRY_USERNAME` - votre nom d’utilisateur du registre,
* secret `EDGEGAP_REGISTRY_TOKEN` - votre jeton de registre.

☑️ Exécutez le workflow **Image du serveur** depuis l’onglet **Actions** Il lance le test de match local, puis crée et envoie `registry.edgegap.com/<project>/relic-rumble:<tag>`, avec l’heure de création comme étiquette. L’étiquette est indiquée dans le résumé de l’exécution.

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

### 3. Créer la version de l’application

☑️ [Créez une application](https://app.edgegap.com/application-management/applications/list) nommée `relic-rumble`, avec une version portant le nom de votre étiquette :

* **Image**: registre `registry.edgegap.com`, dépôt `<project>/relic-rumble`, étiquette `<tag>`,
* **Ressources**: 0,25 vCPU et 512 Mo de mémoire,
* **Port**: `7777`, nom `gameport`, protocole **WS**, avec **TLS Upgrade** activé,
* **Politique de redémarrage**: Never,
* **Variables d’environnement**:
  * `EMPTY_TIMEOUT_S` - `15`, pour arrêter un serveur que tout le monde a quitté,
  * `FIRST_JOIN_TIMEOUT_S` - `60`, pour arrêter un serveur que personne n’a rejoint,
  * `RESULTS_SECONDS` - `8`,
  * `IDLE_TIMEOUT_S` - `75`, pour déconnecter les joueurs dont la page n’est plus accessible,
* **Durée maximale**: 30 minutes, par mesure de sécurité : le serveur s’arrête de lui-même.

{% hint style="warning" %}
**Mise à niveau TLS** permet aux navigateurs sur les pages `https` de se connecter à `wss://<id>.pr.edgegap.net:<port>`. Edgegap termine la connexion TLS et transmet le trafic WebSocket en clair au port `7777`.
{% endhint %}

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

### 4. Créer le Matchmaker

☑️ Définissez `application.version` dans le fichier `matchmaker/rumble.json` de l’exemple sur votre version, et ajoutez l’adresse de votre page à `allowed_cors_origins`.

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

Le profil `rumble` permet de réunir 2 à 4 joueurs. Au bout de 20 secondes, un joueur qui attend seul obtient un serveur, et des bots occupent les places restantes.

☑️ Lorsque le Matchmaker affiche **En ligne**, copiez son **URL de l’API** et son **jeton d’authentification** dans `client/config.local.js`, une copie de `client/config.js`.

{% hint style="success" %}
Le **jeton d’authentification du Matchmaker peut être intégré sans risque aux pages web**: il ne peut servir qu’à demander des parties. Ne mettez jamais votre jeton d’API Edgegap dans une page ni dans l’image du serveur.
{% endhint %}

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

### 5. Trouver une partie

☑️ Ouvrez votre page dans deux onglets de navigateur et cliquez sur **Trouver une partie** dans les deux onglets en moins de 20 secondes.

Chaque page :

1. rejoint le Matchmaker et attend `HOST_ASSIGNED`,
2. se connecte à `wss://<fqdn>:<port>` et envoie l’ID de son ticket,
3. joue : elle envoie des commandes et affiche l’état renvoyé par le serveur, à l’aide du même moteur de rendu et des mêmes ressources que lors d’une partie en solo.

Le serveur de jeu :

1. attend les joueurs réunis, puis remplit les places restantes avec des bots,
2. exécute `client/rules.js` 60 fois par seconde et envoie les positions 20 fois par seconde,
3. arrête son propre déploiement après l’écran des résultats.

🙌 Les deux joueurs sont maintenant dans la même partie, sur un serveur situé à proximité.

☑️ Pour tester tout le parcours sans navigateur, lancez le test de bout en bout. Il met en file d’attente deux joueurs sans interface, leur fait jouer une partie et attend que le déploiement s’arrête de lui-même :

{% code collapsedlinecount="10" %}

```bash
MM_URL=<API URL> MM_TOKEN=<Auth Token> node tests/e2e.mjs rumble 2
```

{% endcode %}

## 📦 Publiez votre jeu

* Hébergez la page où vous voulez : `client/` contient des fichiers statiques, sans étape de compilation. L’exemple comprend un workflow GitHub Pages.
* Vérifiez la taille de `client/assets/` avant la publication. Les quatre personnages, les trois accessoires, le sol et les sons de l’exemple occupent au total 7 Mo.
* Conservez vos prompts fal pour pouvoir générer plus tard un nouvel élément dans le même style.
* Désactivez `inspect` dans la configuration du matchmaker avant le lancement.
* Pour publier de nouvelles règles, envoyez un nouveau tag d’image et associez-le à la version de l’application. Les nouvelles parties l’utiliseront, tandis que celles en cours conserveront l’ancienne version. Pour publier de nouveaux éléments, il suffit de republier la page.

{% hint style="info" %}
Vous utilisez un agent de programmation ? La `edgegap-fal` compétence disponible dans [les compétences d’agent d’Edgegap](https://github.com/edgegap/llm-agent-skills) contient le brief du jeu, le pipeline de création de ressources fal, les modèles de serveur et les tests, et guide votre agent à travers les mêmes étapes pour créer votre propre jeu.
{% endhint %}
