Découvrez comment fonctionne Edgegap

Découvrez comment fonctionne Edgegap

LightNet Relay

Déployer sur Edgegap

LightNet Relay pour Unity : Comment exécuter un relais extensible sur un serveur dédié, avec codes de salon et logique de jeu optionnelle

Publié

Publié

dernière vérification de l'exactitude

dernière vérification de l'exactitude

Guide d'intégration de LightNet Relay : exécutez le relais open-source LightNet sur un serveur dédié Edgegap pour Unity

Ce guide vous montre comment exécuter le fork d’Edgegap de LightNet, un relais open source que vous exécutez sur un serveur dédié sur Edgegap et que vous pouvez étendre avec votre propre logique de jeu, afin que les joueurs de votre jeu Unity hôte-client hébergent une partie et la rejoignent avec un code de salon, ou soient mis en relation grâce au matchmaker optionnel d’Edgegap. L'exemple fonctionne avec Mirror, Fish-Networking, PurrNet et Netcode for GameObjects, avec un paramètre unique pour choisir le netcode.

Voyez cela comme du peer-to-peer amélioré. Dès le départ, le relais transfère le trafic et le jeu de l’hôte gère la partie. Ajoutez de la logique de jeu et il devient un serveur dédié multi-salons avec l’efficacité des ressources d’un relais, sur le même code et le même déploiement. Ce qui change dès le premier jour, c'est la destination du trafic. Chaque joueur se connecte à votre relais, dans un emplacement que vous choisissez, de sorte que personne n'a besoin d'ouvrir de port, aucun joueur ne voit l’adresse IP d’un autre joueur, et aucun réseau de relais partagé ne décide de votre itinéraire. Le fork d’Edgegap permet également aux joueurs de se connecter via WebSocket, y compris depuis des builds Unity WebGL dans le navigateur, ce que la version originale de LightNet ainsi que les relais de Steam et d’Epic ne prennent pas en charge.

Une fois votre relais conteneurisé, Edgegap le déploie à partir d’un simple appel API, sur Edge Cloud pour les tests ou sur des Private Fleets pour un relais qui reste actif en permanence. Un seul relais dessert plusieurs salons à la fois.

Ce guide couvre :

  1. Ce dont vous avez besoin avant de commencer

  2. Connecter votre agent de codage à Edgegap (facultatif)

  3. Choisir votre netcode dans l'exemple

  4. Conteneuriser le relais et créer une version de l'application

  5. Déployer le relais et connecter les joueurs

  6. Regrouper les joueurs avec des codes de salon

  7. Mettre en relation les joueurs avec le matchmaker d’Edgegap, y compris pour rejoindre des parties en cours (facultatif)

  8. Tester avec deux joueurs

Vous pouvez procéder de deux manières, et les combiner :

  • Avec un agent de codage : Connecté au serveur MCP d’Edgegap et à ses compétences d’agent, votre agent peut compiler et pousser l’image du relais, créer la version de l’application, la déployer, lire ses journaux et l’arrêter.

  • Manuellement : Chaque étape ci-dessous fonctionne également sans agent.

Ici, nous utilisons l’exemple de relais LightNet d’Edgegap : le relais, ainsi que le jeu Tanks de Mirror fonctionnant à travers lui sur les quatre netcodes.

Aucune carte de crédit requise. L'offre gratuite inclut les ressources nécessaires pour déployer un véritable serveur de jeu.

Aucune carte de crédit requise. L'offre gratuite inclut les ressources nécessaires pour déployer un véritable serveur de jeu.

Quelle configuration convient le mieux à votre jeu ?

Un relais extensible est l'une des six façons de réunir des joueurs dans une même partie. Elles diffèrent selon qui contrôle la partie et où elle s'exécute :

Configuration

Qui contrôle la partie

Idéal pour

Peer-to-peer

L'appareil d'un joueur

Le jeu local ou de type LAN

Service de relais partagé (Steam, Epic Online Services, Unity Relay)

Le joueur hôte

Une solution rapide pour les connexions qui échouent

Relais extensible (ce guide), sur un serveur dédié

Le joueur hôte

La coop et les salons privés entre joueurs qui se font confiance, ou les parties rapides avec le matchmaker d'Edgegap, avec votre propre relais et routage ; ajoutez de la logique de jeu pour le transformer en serveur de jeu multi-salons

Serveur de jeu multi-salons

Le serveur

Les jeux tolérants à la latence comme les RTS, les jeux de cartes et au tour par tour, avec de nombreuses parties dans un seul processus central

Petit serveur dédié

Le serveur

Les parties où l'équité est primordiale, chacune sur un serveur à vCPU fractionnaire déployé au plus près de ses joueurs

Serveur dédié complet

Le serveur

Simulations complètes, grandes parties et anti-triche

Ce qu'un relais extensible vous apporte :

  • Les adresses IP des joueurs restent masquées : Tout le monde se connecte vers l'extérieur au relais, ainsi les joueurs ne se connectent jamais directement entre eux. Cela élimine les risques d'attaques sur la connexion d'un joueur, comme le flooding de l'hôte, que le peer-to-peer laisse possibles.

  • Aucune redirection de port, aucun problème de NAT : Y compris sur les réseaux mobiles, où les connexions peer-to-peer directes échouent souvent.

  • Votre routage, vos emplacements : Déployez le relais là où se trouvent vos joueurs. Sur les services de relais gratuits, les studios ont signalé n'avoir « absolument aucun contrôle sur la façon dont ces joueurs sont routés » (conférence au Live Service Game Summit, septembre 2024).

  • Aucun réseau partagé : Une modification de routage ou une panne sur un autre réseau de relais n'impacte pas votre jeu.

  • Aucune réécriture : Votre netcode hôte-client reste tel quel, sans aucun SDK de fournisseur de relais dans votre jeu.

  • Étendez-le : Vous êtes propriétaire du code du relais, vous pouvez donc ajouter votre propre logique : mots de passe de salon ou vérifications de joueurs, limites de débit (rate limits), exclusions et bannissements, données de salon, télémétrie, points d'ancrage (hooks) vers votre lobby. Les services de relais partagés comme ceux de Steam et d'Epic ne vous permettent pas d'ajouter de code.

  • Faites-le évoluer en serveur de jeu : Ajoutez de la logique de jeu et il devient un serveur dédié multi-salons avec l'efficacité des ressources d'un relais, sur le même code et le même déploiement.

  • Matchmaking, celui d'Edgegap ou le vôtre : Avec le matchmaker optionnel d'Edgegap, les joueurs qui cliquent sur « Trouver une partie » rejoignent d'abord un relais proche, dans un salon avec une place libre ou un nouveau salon créé sur celui-ci, avant qu'un nouveau relais ne soit déployé. Ou conservez les codes de salon et transmettez-les via votre propre lobby, liste d'amis ou invitations Steam et Epic.

  • WebSocket, uniquement sur le fork d'Edgegap : Les joueurs peuvent se connecter via un seul WebSocket au lieu de TCP et UDP, en wss:// grâce à la mise à niveau TLS d'Edgegap et sans certificat à gérer, y compris depuis les builds Unity WebGL dans le navigateur. Les deux types de joueurs peuvent partager un même salon. LightNet en amont ne prend pas en charge WebSocket, et les relais de Steam et d'Epic non plus.

Ce qu'il ne peut pas faire :

  • Empêcher la triche par défaut : Quiconque détient l'état de la partie peut le modifier et, par défaut, c'est le jeu de l'hôte qui le détient. Un tricheur gâche la partie pour tout le monde, qu'elle soit casual ou classée. L'autorité du serveur permet d'éviter cela : ajoutez de la logique de jeu pour que le relais détienne la partie, ce qui implique de reconstruire les règles de votre jeu sur le serveur puisque le relais ne voit que le trafic netcode brut, ou passez à un petit serveur dédié par match. Un serveur multi-salons s'exécute sur un seul emplacement, prévoyez-en donc un par région : les joueurs éloignés subiront une latence et une équité moindres par rapport aux joueurs situés à proximité.

  • Maintenir la partie lorsque l'hôte quitte : Le relais ferme le salon et déconnecte les autres joueurs.

  • Garantir l'équité de la partie avec des inconnus : L'exemple inclut un matchmaking facultatif. Le matchmaker d'Edgegap regroupe les joueurs proches les uns des autres et place leur partie sur un relais à proximité, mais le jeu de l'hôte contrôle toujours la partie. Pour les parties publiques avec des inconnus, qu'elles soient casual ou classées, confiez la partie à un serveur.

  • Chiffrer de bout en bout : Les transports par défaut sont TCP et UDP en clair. Une connexion wss:// facultative, avec la mise à niveau TLS d'Edgegap, chiffre le trafic entre chaque joueur et Edgegap, mais le relais et le jeu de l'hôte le voient toujours. Avec les codes de salon, toute personne disposant de l'adresse du relais et d'un code valide peut se joindre tant que vous n'ajoutez pas vos propres vérifications de joueurs. Avec le matchmaker, le relais ne fournit le code de salon qu'aux tickets des joueurs appariés.

  • Garder le salon d'un hôte sur navigateur actif dans un onglet en arrière-plan : Les navigateurs brident les onglets masqués, de sorte qu'un salon hébergé dans le navigateur se fige jusqu'à ce que son onglet redevienne actif. Privilégiez un hôte sur ordinateur (desktop). Pour les jeux sur navigateur avec un serveur qui contrôle la partie, consultez Browser Games, Colyseus ou Manus AI.

Cas d'usage idéaux :

Guide étape par étape

Étapes d'intégration détaillées

1. Avant de commencer

  • Un compte Edgegap gratuit. Vérifiez votre adresse e-mail. Aucune carte de crédit n'est requise pour tester.

  • Unity 6000.0.54f1 (Unity 6), la version utilisée par l'échantillon. PurrNet nécessite Unity 2022.3 ou une version plus récente.

  • Docker pour créer l'image du relais. Les autres outils de conteneurisation ne sont pas abordés ici. Le SDK .NET 8 n'est requis que pour compiler le relais en dehors de Docker.

  • Pour le chemin de l'agent : un jeton d'API Edgegap, accessible depuis Dashboard → User Settings → Tokens. Il s'applique à l'ensemble de l'organisation, traitez-le donc comme un mot de passe : ne l'insérez jamais dans votre projet, votre client de jeu ou une messagerie.

Git : Unity nécessite un client Git (version 2.14.0 ou ultérieure) dans votre PATH pour installer des packages à partir d'une URL Git, comme PurrNet et le SDK Unity Edgegap (utilisé par le matchmaker optionnel) dans cet exemple. macOS en dispose généralement déjà (Xcode Command Line Tools) ; sous Windows, installez Git.

Clonez l'exemple : git clone https://github.com/edgegap/server-sample-lightnet-relay.git

2. Connectez votre agent de codage à Edgegap

Ignorez cette étape si vous faites tout manuellement.

Le serveur MCP d'Edgegap permet à votre agent de travailler sur votre compte : pousser des images, créer des versions d'application, déployer, lire les journaux et arrêter les déploiements. Les compétences (« skills ») contiennent le flux de travail testé. Une fois en production, le serveur MCP peut également vérifier l'état de la flotte, rechercher dans les journaux à travers les déploiements et comparer deux versions avant un retour en arrière (rollback).

Claude Code : installez le plugin Edgegap. Il ajoute à la fois le serveur MCP et les compétences, et demande votre jeton d'API lors de l'installation (stocké dans le gestionnaire d'identifiants de votre système) :

/plugin marketplace add edgegap/llm-agent-skills, puis /plugin install edgegap@edgegap. Redémarrez la session.

Vous souhaitez uniquement le serveur MCP, sans le plugin ? Exécutez plutôt ceci dans votre propre terminal : claude mcp add --transport http edgegap https://mcp.edgegap.dev/mcp -H "Authorization: token YOUR_EDGEGAP_API_TOKEN" --scope user. Ne faites pas les deux, sinon vous aurez deux serveurs edgegap.

Cursor, VS Code et autres clients envoyant des en-têtes : ajoutez https://mcp.edgegap.dev/mcp avec l'en-tête Authorization: token YOUR_EDGEGAP_API_TOKEN, puis installez les compétences avec npx skills add edgegap/llm-agent-skills --skill "*". Pour un agent de surveillance, ajoutez également l'en-tête X-Edgegap-Read-Only: 1 : il pourra lire mais ne pourra rien modifier.

Claude Desktop : les connecteurs personnalisés ne peuvent pas envoyer d'en-têtes, utilisez donc plutôt le serveur local (Node 18+) : { "mcpServers": { "edgegap": { "command": "npx", "args": ["-y", "@edgegap/mcp"] } } }. Il demande le jeton lors de la première utilisation.

Vérifiez que cela fonctionne :

Liste mes applications Edgegap.

Une liste vide est tout à fait normale. Votre agent peut également souligner qu'un serveur dédié donnerait l'autorité à votre serveur de jeu : c'est attendu, car un relais laisse l'hôte responsable de la partie.

3. Choisissez votre netcode dans l'exemple

Ouvrez le dossier tanks/ dans Unity Hub. Le netcode correspond à un champ unique, netcode, dans tanks/Assets/Tanks/Resources/TanksSettings.asset : Mirror, FishNet, PurrNet ou NGO. Ce même asset contient l'adresse et le port du relais, ainsi que les paramètres optionnels du matchmaker (désactivés par défaut). Autres moyens de changer :

  • Dans l'éditeur : Tanks > Netcode > Mirror / FishNet / PurrNet / NGO configure l'asset et ouvre la scène correspondant à ce netcode.

  • Dans le jeu : les boutons de netcode en haut du HUD, avant d'héberger ou de rejoindre une partie.

  • Depuis la ligne de commande : -netcode FishNet.

L'hôte et les joueurs doivent utiliser le même netcode. Un seul build contient les quatre.

Netcode

Version dans l'exemple

Transport de relais

Mirror

66.0.9

MirrorRelayTransport

Fish-Networking

4.7.4

FishNetRelayTransport

PurrNet

1.24.1

PurrNetRelayTransport

Netcode for GameObjects

1.13.0

NgoRelayTransport

Chaque transport encapsule RelayPeer, le client relais agnostique au netcode inclus dans le package LightNet de l'exemple. Les messages fiables transitent par TCP et les messages non fiables par UDP, jusqu'à 16 Ko pour les messages fiables et 1 177 octets pour les non fiables par message. Les joueurs peuvent également se connecter via un seul WebSocket : fournissez au jeu une adresse de relais ws:// ou wss://. Avec WebSocket, les messages non fiables sont transmis de manière fiable et ordonnée, ce qui convient mieux aux jeux coopératifs et au tour par tour qu'aux jeux de tir rapides. Les joueurs sur TCP + UDP et sur WebSocket peuvent partager la même salle.

Dans le navigateur : compilez le client WebGL via Tanks > Build WebGL client. Un navigateur ne possède pas de sockets TCP ou UDP, le build WebGL se connecte donc via wss:// grâce à une passerelle légère vers le propre WebSocket du navigateur, pour les quatre netcodes et dans les mêmes salles que les joueurs sur ordinateur. Il lit ses options depuis l'URL de la page, par exemple index.html?relay=wss://<host>.pr.edgegap.net:<port>&host ou &join=CODE, ainsi que &netcode=FishNet. Utilisez l'adresse wss:// : une page servie en HTTPS ne peut pas ouvrir de connexion ws://.

Votre propre jeu ? Copiez le package LightNet/ et le transport correspondant à votre netcode dans votre projet, et définissez-le comme le transport de votre Network Manager. Votre jeu continue d'héberger la partie comme il le fait aujourd'hui.

« Dans mon projet Unity utilisant {netcode}, ajoute le package LightNet provenant du dépôt server-sample-lightnet-relay d'Edgegap ainsi que son transport de relais {netcode}. Définis-le comme le transport du Network Manager, lis l'adresse et le port du relais depuis un asset de paramètres, puis ajoute des boutons pour héberger (Host) et rejoindre (Join) une salle : Host affiche le code de salle à 6 lettres, Join en requiert un. Ne modifie pas la logique de mon jeu. »

4. Conteneurisez le relais et créez une version de l'application

Le relais est une application console .NET 8 avec son propre Dockerfile. Compilez-le depuis la racine du dépôt, pour la plateforme d'Edgegap, même sur Apple Silicon :

docker build --platform linux/amd64 -f relay-server/Dockerfile -t registry.edgegap.com/<project>/lightnet-relay:<tag> .

Testez-le d'abord sur votre machine : docker run --rm -p 7777:7777/tcp -p 7777:7777/udp -p 7778:7778/tcp registry.edgegap.com/<project>/lightnet-relay:<tag>. Le journal devrait afficher « LightNet relay listening on TCP 7777, UDP 7777 ».

Poussez vers le registre de conteneurs Edgegap : exécutez vous-même docker login registry.edgegap.com, avec le nom d'utilisateur et le jeton issus de la page Container Registry, puis docker push. Utilisez un nouveau tag pour chaque build, jamais latest.

Créez ensuite l'application et sa version dans le tableau de bord :

  • Votre image et tag, avec les identifiants du registre (un profil de registre, ou le nom d'utilisateur et le jeton de la page Container Registry ; sans cela, les déploiements échouent avec « Unable to pull image from registry »).

  • Un seul port : 7777, protocole TCP/UDP, nommé relay. Deux entrées distinctes 7777 TCP et 7777 UDP sont rejetées car considérées comme des doublons. Pour le WebSocket chiffré facultatif, ajoutez un second port : 7778, protocole WS, TLS Upgrade activé, nommé relay-ws. Les joueurs se connectent ensuite à wss://<host>.pr.edgegap.net:<son port externe>.

  • Commencez avec peu de ressources : le relais n'exécute aucune logique de jeu. Pour le dimensionner en fonction du trafic réel, quittez le forfait gratuit en ajoutant une carte de crédit (Pay as You Go) : cela débloque des métriques de déploiement détaillées, vous permettant d'observer l'utilisation du processeur, de la mémoire et du réseau du relais dans un environnement en direct et d'ajuster en conséquence.

  • Variables d'environnement facultatives : RELAY_MAX_PEERS (joueurs par relais, valeur par défaut 256) et RELAY_IDLE_EXIT_SECONDS (le relais s'arrête après ce nombre de secondes sans salle ; valeur par défaut 600, de sorte qu'un relais inactif s'arrête après 10 minutes ; 0 signifie jamais). RELAY_WS_PORT définit le port WebSocket (valeur par défaut 7778, 0 le désactive). Un relais démarré par le matchmaker s'arrête de lui-même lorsque sa dernière salle se termine. Pour le matchmaker, ajoutez également MATCHMAKER_URL et MATCHMAKER_TOKEN, et éventuellement RELAY_MATCH_MAX_PLAYERS (joueurs par salle, valeur par défaut 4), RELAY_MAX_ROOMS (salles par relais, valeur par défaut 4) et RELAY_SOLO_ROOM_SECONDS (valeur par défaut 120) : voir étape 6.

Avec votre agent :

« Charge la compétence edgegap-containerize. Compile le relais LightNet depuis relay-server/Dockerfile à la racine du dépôt pour linux/amd64, pousse-le vers le registre Edgegap avec un nouveau tag, puis crée une application et une version d'application Edgegap correspondante : un port 7777 avec le protocole TCP/UDP nommé relay, de faibles ressources, stratégie de redémarrage

5. Déployer le relais et connecter les joueurs

Déployez votre version depuis le tableau de bord (Deploy, choisissez un emplacement proche de vos joueurs), ou demandez à votre agent :

« Déploie ma version de relais LightNet près de chez moi, attends qu'elle soit prête, montre-moi les journaux et donne-moi l'URL de l'hôte et le port externe. »

Lorsque le déploiement est Ready, les joueurs se connectent à son Host URL (<id>.pr.edgegap.net) et à son External Port. Edgegap mappe TCP et UDP sur le même port externe, ainsi les joueurs ne le transmettent qu'une seule fois :

  • Dans l'échantillon : définissez l'adresse et le port du relais dans TanksSettings.asset, ou utilisez -relay <host>.pr.edgegap.net -relayPort <external port> en ligne de commande.

  • Dans les journaux du relais, un pair qui se connecte et se déconnecte juste après le démarrage correspond au contrôle d'état de préparation d'Edgegap, et non à un joueur.

Maintenir les relais actifs :

  • Niveau gratuit : les déploiements s'arrêtent après 60 minutes, ce qui est suffisant pour tester.

  • Edge Cloud : les déploiements sont conçus pour être recyclés sous 24 heures, et vous êtes averti lorsque l'un d'eux s'exécute plus longtemps. Edge Cloud facture également les données sortantes, et un relais achemine chaque octet de chaque partie. En tant que tel, il peut être idéal pour des niveaux d'utilisation à la demande, ou pour le développement, les sessions de test et la préproduction, mais à grande échelle, nous recommandons aux studios d'utiliser des Private Fleets pour une plus grande rentabilité.

  • Private Fleets : une fois votre jeu en ligne et les relais fonctionnant 24h/24, les Private Fleets sont généralement la solution la plus adaptée : des hôtes réservés dans 58 emplacements à travers le monde, avec 6 To de données sortantes inclus par hôte, ce qui est suffisant pour presque tous les jeux, et des paramètres de persistance pour décider de la durée d'exécution de chaque relais.

  • Recyclage : quelle que soit la configuration, recycler régulièrement les relais est une bonne pratique, car un serveur de jeu tout juste redémarré est un serveur sain (voir le cycle de vie des déploiements d'Edgegap). Quand, comment et à quelle fréquence dépendent de votre jeu, et le guide de persistance explique comment planifier les redémarrages sans pénaliser les joueurs. Une méthode simple par région : démarrez un nouveau relais, donnez son adresse aux joueurs qui créent de nouvelles salles, puis arrêtez l'ancien relais dès que sa dernière salle se termine.

  • Relais de matchmaking : avec le système de matchmaking, un relais démarre près de ses premiers joueurs sur Edge Cloud et accueille jusqu'à 4 salles. Il s'arrête de lui-même lorsque sa dernière salle se termine, de sorte qu'il n'est facturé que lorsque les joueurs jouent. Sur le niveau gratuit, un seul déploiement s'exécute à la fois (un seul relais), et le système de matchmaking s'arrête 3 heures après chaque démarrage.

  • Déploiements de test : veillez à les arrêter depuis le tableau de bord ou par le biais de votre agent lorsque vous avez terminé, car un déploiement est facturé tant qu'il est en cours d'exécution.

6. Regrouper les joueurs : codes de salon ou matchmaking

L'échantillon regroupe les joueurs de deux manières : par des codes de salon ou, en option, via le matchmaker d'Edgegap.

Avec des codes de salon :

  1. Un joueur appuie sur Héberger. Le relais crée un salon et renvoie un code à 6 lettres, affiché dans le HUD.

  2. L'hôte partage le code : dans un écran de groupe, une liste d'amis, un chat ou un message Discord.

  3. Les autres joueurs saisissent le code et appuient sur Rejoindre le salon.

Les codes évitent le I et le O afin d'être faciles à lire à voix haute. Le salon dure tant que l'hôte reste : lorsque l'hôte le quitte, le relais ferme le salon et déconnecte les autres. L'hôte peut également expulser un joueur.

Pour intégrer cela dans votre jeu, affichez le code dans votre propre interface utilisateur et transmettez-le via le moyen qui connecte déjà vos joueurs, comme les invitations d'amis Steam ou Epic Online Services.

Avec le matchmaker Edgegap (facultatif, désactivé par défaut) :

  1. Dans le tableau de bord, ouvrez Matchmaker → Créer un Matchmaker. Téléversez matchmaker-config.json depuis le dépôt, avec application.name et version définis sur la version de l'application de votre relais, puis cliquez sur Créer et Démarrer. Le fichier utilise le matchmaker 3.3.3, le profil casual et une expiration de ticket de 30 s. Pendant ses 10 premières secondes, un ticket ne peut rejoindre qu'un relais en cours d'exécution ; ensuite, 2 à 4 joueurs en attente en obtiennent un nouveau. Une règle de latence maintient les joueurs ensemble uniquement si chacun a au plus 150 ms vers une balise Edgegap et que leurs pings diffèrent d'au plus 100 ms.

  2. Sur la version de l'application de votre relais, ajoutez les variables d'environnement MATCHMAKER_URL et MATCHMAKER_TOKEN : l'URL de l'API et le jeton d'authentification du matchmaker. Sans elles, le relais enregistre « backfill: off » et ses salons n'accueillent jamais de joueurs ultérieurs.

  3. Dans TanksSettings.asset, activez Use Matchmaker et collez les mêmes API URL et Auth Token. Le jeton peut être intégré en toute sécurité dans un client de jeu. Le jeu envoie ses pings aux balises d'Edgegap avec chaque ticket (matchmakerLatencyBeacons, activé par défaut). Version en ligne de commande : -matchmaker <url> -matchmakerToken <token> -findMatch. Pour vous connecter via wss://, activez également matchmakerUseWebSocket (-matchmakerWebSocket).

  4. Les joueurs appuient sur Trouver une partie. Si un relais à proximité a de la place, le joueur le rejoint : en priorité un salon avec une place libre, sinon un nouveau salon sur ce relais, que le joueur héberge. Si aucun n'a de place, après environ 10 secondes, le matchmaker déploie un nouveau relais pour 2 à 4 joueurs en attente proches les uns des autres. Le premier joueur apparié à atteindre un salon en devient l'hôte, et les autres le rejoignent automatiquement, sans aucun code à saisir.

  5. Chaque relais contient jusqu'à 4 salons de 4 joueurs maximum (RELAY_MAX_ROOMS, RELAY_MATCH_MAX_PLAYERS) et maintient au plus 5 backfills ouverts : des requêtes auprès du matchmaker qui transmettent l'adresse du relais et les pings de ses joueurs. Il ne propose un nouveau salon qu'une fois ses salons pleins, de sorte que deux joueurs effectuant une recherche au même moment se retrouvent ensemble.

  6. Un hôte laissé seul pendant 2 minutes (RELAY_SOLO_ROOM_SECONDS) en est informé, et le jeu relance la recherche de lui-même. Lorsqu'un hôte quitte, ce salon se ferme. Dès que son dernier salon prend fin, le relais ferme ses backfills et arrête son propre déploiement, cessant ainsi la facturation.

Un relais déployé sans le matchmaker continue de fonctionner avec des codes de salon. Les joueurs peuvent rejoindre un salon en cours, votre jeu doit donc accepter les joueurs en cours de partie, comme le fait Tanks. L'échantillon place les joueurs en file d'attente un par un ; pour les groupes, ajoutez une règle backfill_group_size afin qu'un groupe ne prenne jamais plus de places que le salon n'en a de libres. Les navigateurs ne peuvent pas envoyer de pings aux balises, une version WebGL nécessite donc un profil sans la règle de latence.

« Chargez la compétence edgegap-matchmaking. Créez une configuration de matchmaker (version 3.3.3) pour la version de mon application de relais LightNet : profil casual, 1 équipe, taille d'équipe min et max à 9999 au début pour que les tickets ne rejoignent les relais en cours que via le backfill, puis un élargissement à 10 s pour 2 à 4 joueurs, une règle de latence de balises (latence max 150 ms, différence 100 ms) et une expiration de ticket de 30 s. Expliquez-moi comment la créer dans le tableau de bord, ajouter MATCHMAKER_URL et MATCHMAKER_TOKEN à ma version d'application, et placer l'URL et le jeton dans TanksSettings.asset avec Use Matchmaker activé. »

Matchmaking avec des inconnus : Le matchmaker réunit des inconnus dans le même salon, mais le jeu de l'hôte en reste le propriétaire, ce qui signifie qu'un hôte qui triche peut gâcher la partie, et le salon se ferme pour tous ses participants, y compris ceux arrivés plus tard, lorsque l'hôte quitte. Pour les parties publiques occasionnelles ou classées, confiez la partie à un serveur : étendez le relais avec votre logique de jeu, ou commencez avec Mirror Networking, Fish-Networking, PurrNet ou Netcode for GameObjects, qui prennent en charge les serveurs dédiés et le Matchmaking d'Edgegap de bout en bout.

7. Tester avec deux joueurs

  1. Compilez le client Windows : Tanks > Build Windows client.

  2. Lancez deux copies. Dans la première, appuyez sur Host et notez le code de la salle. Dans la seconde, saisissez le code et appuyez sur Join room.

  3. Les deux tanks apparaissent dans les deux jeux. Conduisez et tirez : l'hôte voit l'autre tank se déplacer et ses tirs toucher leur cible.

Test automatisé : Avec le relais en cours d'exécution, ./e2e.sh <host>.pr.edgegap.net <port externe> démarre un hôte et un client sur chaque netcode et vérifie que les deux jeux voient deux tanks, que les données fiables et non fiables ont transité par le relais et qu'un projectile a été généré. Nommez les netcodes pour n'en tester que certains : ./e2e.sh <host>.pr.edgegap.net <port externe> FishNet NGO. Cela exécute la version Windows depuis un shell Bash, tel que Git Bash. L'échantillon a réussi ce test sur Edgegap sur l'ensemble des quatre netcodes le 29 octobre 2026.

Avec le matchmaker : Lancez deux copies et appuyez sur Find Match dans les deux. L'une fait office d'hôte et l'autre rejoint. Automatisé : ./e2e-matchmaker.sh <url du matchmaker> <token> lance des jeux via le matchmaker sur chaque netcode (ajoutez FishNet NGO pour n'en tester que certains). Préfixez-le avec BACKFILL=1 pour ajouter ultérieurement un troisième joueur, MULTIROOM=1 pour remplir une salle puis héberger et rejoindre une deuxième salle sur le même relais, ou MM_WEBSOCKET=1 pour fonctionner sur wss://. Avec de vrais pings depuis Montréal, l'échantillon a réussi chacun d'eux sur Edgegap sur l'ensemble des quatre netcodes le 2 novembre 2026 : la deuxième salle s'est terminée pendant que la première continuait à jouer, chaque relais s'est arrêté de lui-même après sa dernière salle, et un joueur ayant des pings élevés n'a jamais été placé dans la salle en cours. Sur WebSocket avec des codes de salle : ./e2e.sh wss://<host>.pr.edgegap.net:<port> 0.

Dans le navigateur : Servez tanks/Builds/WebGL depuis n'importe quel serveur de fichiers statiques et ouvrez-le avec une adresse de relais wss:// dans l'URL. L'échantillon a réussi sur Edgegap le 9 novembre 2026 avec la version WebGL dans Chrome en mode headless, via un relais à Toronto, sur l'ensemble des quatre netcodes : un hôte de bureau avec un client navigateur, un hôte navigateur avec un client de bureau, et un hôte navigateur avec un client navigateur.

Arrêtez le déploiement lorsque vous avez terminé.

Étapes suivantes

Étapes suivantes

Prêt pour l'autorité serveur ? Aucun avantage d'hôte, aucune triche de l'hôte, et le match continue même si quelqu'un quitte la partie : consultez les guides pour Mirror Networking, Fish-Networking, PurrNet et Netcode for GameObjects. Ou étendez le relais LightNet avec votre propre logique de jeu. Vous préférez un relais géré plutôt que d'exécuter le vôtre ? Consultez Unity Relays.

Bloqué ? Posez vos questions à notre équipe et à d'autres studios sur le Discord Edgegap.

Questions Fréquemment Posées

Questions fréquentes sur l'exécution d'un relais LightNet extensible sur un serveur dédié pour un jeu Unity hôte-client.

Qu'est-ce que LightNet ?

LightNet est une bibliothèque réseau C# légère et open source (Apache 2.0) proposant des modes serveur et client, des canaux fiables et non fiables, et aucune logique de jeu intégrée. Le fork d'Edgegap l'exécute en tant que relais : une application .NET 8 dans un conteneur qui transfère le trafic entre un joueur hôte et les autres dans chaque salon, et ajoute des connexions WebSocket, y compris à partir de builds Unity WebGL, un protocole UDP fonctionnant à travers les NAT, ainsi que la prise en charge du matchmaker d'Edgegap.

Un relais extensible est-il un serveur de jeu dédié ?

Pas immédiatement prêt à l'emploi. Il fonctionne sur un serveur dédié, mais tel quel, il n'exécute aucune logique de jeu : le jeu du joueur hôte possède la partie, comme en peer-to-peer. Ce qu'il apporte par rapport au peer-to-peer et aux services de relais partagés, c'est votre propre relais : adresses IP masquées, aucune redirection de port, un emplacement que vous choisissez et du code que vous pouvez étendre. Ajoutez de la logique de jeu au relais et il devient un serveur dédié multi-salles avec l'efficacité des ressources propre à un relais.

Un relais empêche-t-il la triche ?

Pas à lui seul. Quiconque détient l'état de la partie peut le modifier, et avec un relais, c'est le jeu de l'hôte. Un tricheur gâche la partie de tout le monde, qu'elle soit amicale ou classée. Le relais LightNet bloque bien les attaques sur les connexions des joueurs, puisque personne ne voit l'adresse IP d'un autre joueur. Empêcher la triche nécessite l'autorité du serveur : ajoutez une logique de jeu pour que le relais gère la partie, ou utilisez un petit serveur dédié par partie.

Quels netcodes cet exemple prend-il en charge ?

Mirror, Fish-Networking, PurrNet et Netcode for GameObjects, dans un seul build Unity 6, avec un seul paramètre pour basculer. Le relais ne sait pas quel netcode est utilisé : il transfère des octets. Un autre netcode a besoin de son propre transport autour du client RelayPeer de l'échantillon.

En quoi cela diffère-t-il des relais Unity d'Edgegap ?

Les relais Unity sont les relais distribués gérés d'Edgegap : vous créez une session par match à partir d'un appel API, et Edgegap choisit le relais. Avec LightNet, vous exécutez vous-même le relais en tant que déploiement Edgegap, avec votre propre code et vos propres codes de salon, vous choisissez où il s'exécute, et vous pouvez l'étendre avec votre propre logique. Les relais gérés d'Edgegap sont uniquement en UDP, donc les builds de navigateur (WebGL) ne peuvent pas les utiliser ; la connexion WebSocket de LightNet le permet.

Les joueurs peuvent-ils trouver une partie sans code de salon ?

Oui. Activez le matchmaking Edgegap optionnel de l'exemple. Les joueurs appuient sur Trouver une partie : si un relais à proximité a de la place, ils le rejoignent, dans une salle en cours ou une nouvelle ; sinon, le système de matchmaking regroupe les joueurs proches les uns des autres et lance un relais pour eux. Le relais choisit un joueur pour héberger chaque salle et n'autorise que les joueurs associés à entrer. Le jeu de l'hôte contrôle toujours la partie, comme avec les codes de salle. Vous préférez votre propre salon ou système de matchmaking ? Conservez les codes de salle et faites-les transiter par celui-ci.

Clients

Découvrez les témoignages de clients qui ont intégré Edgegap

31 études de cas sont disponibles auprès de studios ayant migré d'une autre plateforme vers Edgegap.

Principales raisons pour lesquelles ils ont choisi Edgegap

Découvrez l’impact de l’orchestration automatisée des serveurs de jeu d’Edgegap pour une expérience multijoueur impeccable.

Coût

Prix

Prix

Optimisez les coûts et les performances grâce à l'orchestration hybride

Optimisez les coûts et les performances grâce à l'orchestration hybride

Optimisez les coûts et les performances grâce à l'orchestration hybride

Cloud de périphérie

À la demande

0,00115 $

/ vCPU

/ MINUTE

Facturé à la minute, uniquement à l'utilisation

Payez quand les joueurs jouent. 0 serveur actif = 0 $

Déployez des serveurs de jeu dans le monde entier, par instance, dans plus de 615 emplacements edge cloud. Sans engagement.

Ajoutez simplement une carte de crédit.

Cloud de périphérie

À la demande

0,00115 $

/ vCPU

/ MINUTE

Facturé à la minute, uniquement à l'utilisation

Payez quand les joueurs jouent. 0 serveur actif = 0 $

Déployez des serveurs de jeu dans le monde entier, par instance, dans plus de 615 emplacements edge cloud. Sans engagement.

Ajoutez simplement une carte de crédit.

Private Fleet (Bare Metal)

Capacité réservée

0,0261 $

/ vCPU

/ HEURE

Facturé mensuellement, toujours actif

280 $ par hôte/mois (tarif sur 12 mois), ou 350 $ par mois

Optimisez la rentabilité de votre serveur de jeu grâce à l'hébergement sans frais de transfert de données sortantes (egress-free) des flottes privées (Private Fleets).

Permanent, disponible 24h/24 et 7j/7, exclusif à votre studio.

Private Fleet (Bare Metal)

Capacité réservée

0,0261 $

/ vCPU

/ HEURE

Facturé mensuellement, toujours actif

280 $ par hôte/mois (tarif sur 12 mois), ou 350 $ par mois

Optimisez la rentabilité de votre serveur de jeu grâce à l'hébergement sans frais de transfert de données sortantes (egress-free) des flottes privées (Private Fleets).

Permanent, disponible 24h/24 et 7j/7, exclusif à votre studio.

Votre facture varie selon le tarif et l'utilisation, qui peuvent varier en fonction
du type de jeu, du nombre de joueurs et plus encore.

Votre facture varie selon le tarif et l'utilisation, qui peuvent varier en fonction
du type de jeu, du nombre de joueurs et plus encore.

Modélisez votre utilisation avec notre calculateur d'estimation ->

Modélisez votre utilisation avec notre calculateur d'estimation ->

Fonctionnalités et tarifs d'Edgegap : comparaison détaillée entre Edge Cloud et Private Fleets

Fonctionnalités et tarifs d'Edgegap : comparaison détaillée entre Edge Cloud et Private Fleets

COMPARER

Essai gratuit

Cloud de périphérie

Flottes privées

FONCTIONNALITÉS

Analyses et surveillance

Alertes de facturation

Cliquer pour agrandir

28 lignes de plus

Déverrouille

Les fonctionnalités sont débloquées lorsqu'une carte de crédit est ajoutée au compte.

COMPARER

Essai gratuit

Cloud de périphérie

Flottes privées

FONCTIONNALITÉS

Analyses et surveillance

Alertes de facturation

Cliquer pour agrandir

28 lignes de plus

Déverrouille

Les fonctionnalités sont débloquées lorsqu'une carte de crédit est ajoutée au compte.

COMPARER

Essai gratuit

Cloud de périphérie

Flottes privées

FONCTIONNALITÉS

Analyses et surveillance

Alertes de facturation

Cliquer pour agrandir

28 lignes de plus

Déverrouille

Les fonctionnalités sont débloquées lorsqu'une carte de crédit est ajoutée au compte.