> 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/supabase-sumo-push.md).

# Supabase Sumo Push

backend de jeu multijoueur Supabase avec EdgeGap : connexion, profils, classement et matchmaking via les fonctions Edge de Supabase, un serveur Node.js autoritaire par match sur EdgeGap.

Découvrez comment utiliser Supabase comme backend d’un jeu web multijoueur hébergé sur Edgegap.

![Une partie sur un serveur Edgegap](https://raw.githubusercontent.com/edgegap/netcode-sample-threejs-supabase/main/docs/images/match.jpg)

Cet exemple reprend Sumo Push, un [three.js](https://threejs.org/) jeu de fête de [Three.js Minigames](https://docs.edgegap.com/fr/docs/sample-projects/jeux-web/threejs-minigames.md) exemple, et ajoute [Supabase](https://supabase.com/) comme backend. Les joueurs se connectent, conservent un profil, gravissent un classement en direct et cliquent **Trouver une partie**. Le système de matchmaking d’Edgegap lance près d’eux un serveur node.js autoritaire, qui enregistre le résultat dans Supabase et s’arrête une fois la partie terminée.

* **Supabase**: connexion, profils, victoires, historique des parties, mises à jour du classement et passerelle vers le matchmaking.
* **Edgegap**: le matchmaking, et un serveur dédié par partie, près de ses joueurs.

Cet exemple montre :

* **Connexion anonyme**: chaque joueur reçoit un véritable utilisateur Supabase sans e-mail ni mot de passe, et le conserve lors de la visite suivante. Associez plus tard un e-mail ou une identité OAuth pour conserver la progression sur plusieurs appareils.
* **Trouver une partie via une Edge Function Supabase**: la page ne détient jamais le jeton du système de matchmaking. La fonction vérifie la session du joueur, rejoint le système de matchmaking et mémorise quel ticket appartient à quel joueur.
* **Joueurs vérifiés par le serveur de jeu**: chaque joueur envoie son jeton d’accès Supabase lors de la connexion. Le serveur vérifie sa signature avec les clés publiques du projet, afin de savoir qui joue sans détenir de clé Supabase.
* **Résultats signalés par le serveur**: lorsqu’une partie se termine, le serveur envoie les scores à une seconde Edge Function. Postgres n’accepte que les joueurs venus avec leur propre ticket inutilisé pour cette partie, afin que les résultats ne puissent pas être falsifiés ni comptés deux fois.
* **Sécurité au niveau des lignes**: les joueurs peuvent lire les profils et les parties, et renommer leur pseudo, mais ils ne peuvent pas modifier leurs victoires.
* **Classement en direct** avec Supabase Realtime : la fin d’une partie, où qu’elle se produise, met à jour chaque page ouverte.

{% hint style="info" %}
Voir le [dépôt d’exemple](https://github.com/edgegap/netcode-sample-threejs-supabase) pour le schéma de la base de données, les deux Edge Functions, le serveur de jeu et un test de bout en bout de l’ensemble du flux.
{% endhint %}

## ✔️ Préparation

Avant de commencer, vous aurez besoin de :

* [Exemple Supabase Sumo Push](https://github.com/edgegap/netcode-sample-threejs-supabase).
* [Node.js](https://nodejs.org/) 22 ou plus récent, pour exécuter localement le serveur et les pages, et le [Supabase CLI](https://supabase.com/docs/guides/local-development/cli/getting-started) via `npx`.
* [Docker](https://docs.docker.com/get-started/get-docker/), pour construire l’image du serveur.
* Un [compte Supabase](https://supabase.com/dashboard). Le forfait gratuit suffit.

☑️ Essayez d’abord le jeu en local :

{% code collapsedlinecount="10" %}

```bash
npm install
npm run dev
npm run web
```

{% endcode %}

Ouvrez `http://localhost:8080`, cliquez sur **Serveur local**, puis ouvrez un deuxième onglet pour jouer contre vous-même. Sans configuration de Supabase, le serveur laisse tout le monde entrer et n’enregistre rien. `npm test` joue une partie complète avec deux joueurs sans interface.

## 🗄️ Backend Supabase

### 1. Créez le projet

☑️ Créez un projet Supabase et appliquez le schéma de l’exemple :

{% code collapsedlinecount="10" %}

```bash
npx supabase login
npx supabase projects create edgegap-sumo --org-id <org-id> --region us-east-1
npx supabase link --project-ref <project-ref>
npx supabase db push --remote
```

{% endcode %}

`npx supabase orgs list` affiche l’ID de votre organisation. `db push` crée les `profiles`, `tickets`, `matches` et `match_players` tables, leurs politiques de Sécurité au niveau des lignes, un déclencheur donnant un profil à chaque nouvel utilisateur, et la fonction `record_match()` .

☑️ Dans le tableau de bord Supabase, ouvrez **Authentication**, puis **Sign In / Providers**, et activez **Allow anonymous sign-ins**.

☑️ Copiez `client/config.js` à `client/config.local.js` et renseignez votre **Project URL** et **Publishable key**, depuis **Project Settings**, puis **API Keys**.

{% hint style="success" %}
La **La clé publiable Supabase peut être intégrée sans risque dans des pages web**: la Sécurité au niveau des lignes décide ce qu’elle peut lire et modifier. Ne mettez jamais la clé secrète ni la clé de rôle de service dans une page ou dans l’image du serveur.
{% endhint %}

☑️ Rechargez `http://localhost:8080`: le menu affiche le nom de joueur généré, votre bilan et le classement. Renommez-vous, et le nom est enregistré dans votre profil.

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

## ⚡ Déployer et connecter

### 2. Construisez l’image du serveur

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

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

☑️ Connectez-vous au registre de conteneurs d’Edgegap avec Docker, en utilisant le nom de projet de votre registre, votre nom d’utilisateur et votre jeton :

{% tabs %}
{% tab title="Bash (Linux)" %}

```bash
project='<REGISTRY_PROJECT>';
username='robot$<REGISTRY_ORGANIZATION_ID>+client-push';
token='<REGISTRY_TOKEN>';

echo "$token" | docker login registry.edgegap.com -u "$username" --password-stdin 2>&1
```

{% endtab %}

{% tab title="PowerShell (Windows)" %}

```powershell
$project = '<REGISTRY_PROJECT>'
$username = 'robot$<REGISTRY_ORGANIZATION_ID>+client-push'
$token = '<REGISTRY_TOKEN>'

echo "$token" | docker login registry.edgegap.com -u "$username" --password-stdin 2>&1
```

{% endtab %}
{% endtabs %}

☑️ Construisez et poussez l’image contenant le serveur de jeu, taguée avec l’heure de construction :

{% code collapsedlinecount="10" %}

```bash
docker build --platform linux/amd64 -t registry.edgegap.com/<project>/sumo-supabase:<tag> .
docker push registry.edgegap.com/<project>/sumo-supabase:<tag>
```

{% endcode %}

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

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

☑️ [Créez une application](https://app.edgegap.com/application-management/applications/list) nommé `sumo-supabase`, avec une version nommée d’après votre tag :

* **Image**: `registry.edgegap.com/<project>/sumo-supabase`, tag `<tag>`,
* **Identifiants du registre**: votre nom d’utilisateur et votre jeton du registre de conteneurs, afin qu’Edgegap puisse récupérer l’image,
* **Ressources**: 0,25 vCPU et 512 Mo de mémoire,
* **Port**: `7777`, nom `gameport`, protocole **WS**, avec **mise à niveau TLS** activé,
* **Variables d’environnement**:
  * `SUPABASE_URL` - l’URL de votre projet, `https://<project-ref>.supabase.co`,
  * `GAME_SERVER_SECRET` - une longue chaîne aléatoire, marquée **hidden**, partagée avec Supabase à l’étape 5,
  * `REQUIRE_TICKET` - `1`, pour refuser les joueurs que le système de matchmaking n’a pas envoyés à cette partie,
* **Durée maximale**: 30 minutes, comme filet de sécurité : le serveur s’arrête tout seul.

{% hint style="warning" %}
**mise à niveau TLS** permet aux navigateurs sur `https` pages de se connecter à `wss://<id>.pr.edgegap.net:<port>`. Edgegap termine le TLS et transfère le trafic WebSocket brut vers le port `7777`.
{% endhint %}

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

### 4. Créez le matchmaker

☑️ Définissez `application.name` et `application.version` dans le `edgegap/matchmaker-config.json` de l’exemple vers votre application et votre version.

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

La `sumo` fait correspondre une partie entre 2 et 8 joueurs. Après 20 secondes, un joueur seul obtient un serveur, et des bots remplissent les places vides.

☑️ Quand le système de matchmaking affiche **En ligne**, copiez son **URL API** et **jeton d’authentification**.

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

### 5. Déployez les Edge Functions

☑️ Enregistrez les détails du système de matchmaking et le secret du serveur de jeu dans Supabase, puis déployez les deux fonctions :

{% code collapsedlinecount="10" %}

```bash
npx supabase secrets set EDGEGAP_MM_URL=<API URL> EDGEGAP_MM_TOKEN=<Auth Token> GAME_SERVER_SECRET=<same secret as step 3>
npx supabase functions deploy matchmaking
npx supabase functions deploy report-match
```

{% endcode %}

* `matchmaking` vérifie la session du joueur, puis rejoint le système de matchmaking comme groupe d’un seul joueur, l’interroge en boucle et renvoie `wss://` l’adresse du serveur et l’ID du ticket du joueur. Son action `cancel` quitte la file d’attente en supprimant le groupe du joueur.
* `report-match` vérifie le secret du serveur de jeu, puis appelle `record_match()`.

{% hint style="info" %}
**Les joueurs n’appellent jamais le système de matchmaking directement.** L’Edge Function conserve son jeton, donc seuls les joueurs connectés peuvent se mettre en file, et chaque ticket est lié à un utilisateur Supabase. Cela signifie aussi que le `allowed_cors_origins` n’a pas besoin de l’origine de votre page.
{% endhint %}

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

### 6. Trouvez une partie

☑️ Ouvrez la page `http://localhost:8080` dans deux navigateurs (ou un navigateur normal et une fenêtre privée, puisqu’un profil de navigateur partage une seule session Supabase). Cliquez **Trouver une partie** dans les deux en moins de 20 secondes.

Chaque page :

1. appelle l’ `matchmaking` Edge Function toutes les 1,5 secondes jusqu’à ce que le système de matchmaking renvoie `HOST_ASSIGNED`,
2. se connecte à `wss://<fqdn>:<port>` et envoie son ID de ticket et son jeton d’accès Supabase,
3. joue : il envoie les entrées et affiche l’état renvoyé par le serveur.

Le serveur de jeu :

1. vérifie le jeton d’accès de chaque joueur avec `https://<project-ref>.supabase.co/auth/v1/.well-known/jwks.json`, et son ticket par rapport à `MM_TICKET_IDS`,
2. déroule la partie,
3. envoie le ticket, l’ID utilisateur, le score et la place de chaque joueur à `report-match`,
4. arrête son propre déploiement après l’écran de résultats.

{% hint style="warning" %}
**Annuler les recherches que les joueurs abandonnent**, sinon le système de matchmaking peut encore leur trouver une partie et démarrer un serveur que personne ne rejoint. L’exemple annule sur le **Annuler** bouton, sur un nouveau **Trouver une partie**, et lorsque la page se ferme en plein milieu de la recherche, avec une requête `keepalive` que le navigateur termine après la disparition de la page. Un joueur qui part une fois que sa partie est formée obtient tout de même un serveur : celui-ci s’arrête tout seul après `FIRST_JOIN_TIMEOUT_S` (120 secondes) si personne ne se joint.
{% endhint %}

🙌 Les deux joueurs sont maintenant dans la même partie, sur un serveur placé près d’eux, et le classement se met à jour sur les deux pages lorsqu’elle se termine.

☑️ Pour tester tout le parcours sans navigateur, lancez le test de bout en bout. Il connecte des joueurs sans interface, leur trouve une partie via l’Edge Function, la joue, lit le résultat depuis Supabase, et attend que le déploiement s’arrête tout seul :

{% code collapsedlinecount="10" %}

```bash
SUPABASE_URL=https://<project-ref>.supabase.co SUPABASE_PUBLISHABLE_KEY=<publishable key> npm run e2e
```

{% endcode %}

## 📦 Déployez votre jeu

* Hébergez la page n’importe où : ce sont des fichiers statiques sans étape de compilation (`index.html`, `client/`, `game/`).
* Permettez aux joueurs de conserver leur compte sur plusieurs appareils en associant une adresse e-mail ou une identité OAuth à leur utilisateur anonyme.
* Désactivez `inspect` dans la configuration du matchmaker avant le lancement.
* Réduisez `FIRST_JOIN_TIMEOUT_S` (par exemple à `60`), afin que les serveurs dont tous les joueurs sont partis avant de rejoindre s’arrêtent plus vite.
* Nettoyez les anciennes lignes de la table `tickets` par exemple avec une tâche quotidienne `pg_cron` .
* Pour livrer une nouvelle version du serveur, poussez un nouveau tag d’image et pointez la version de l’application vers celui-ci. Les nouvelles parties l’utiliseront, et celles en cours conserveront l’ancienne version.

{% hint style="info" %}
Vous utilisez un agent de codage ? La `edgegap-supabase` compétence dans [les compétences d’agent d’Edgegap](https://github.com/edgegap/llm-agent-skills) fournit le schéma, les Edge Functions, les changements serveur et client de cet exemple sous forme de modèles, et guide votre agent à travers les mêmes étapes pour votre propre jeu.
{% endhint %}
