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

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 :
Ce dont vous avez besoin avant de commencer
Connecter votre agent de codage à Edgegap (facultatif)
Choisir votre netcode dans l'exemple
Conteneuriser le relais et créer une version de l'application
Déployer le relais et connecter les joueurs
Regrouper les joueurs avec des codes de salon
Mettre en relation les joueurs avec le matchmaker d’Edgegap, y compris pour rejoindre des parties en cours (facultatif)
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.
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 |
|---|---|---|
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 |
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 | |
Le serveur | Les parties où l'équité est primordiale, chacune sur un serveur à vCPU fractionnaire déployé au plus près de ses joueurs | |
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 :
Principaux cas d'usage : jeux en coop, jeux mobiles y compris hybrid-casual, PvP en temps réel entre amis ou dans des salons privés, RTS et jeux de cartes (TCG), et jeux Unity WebGL dans le navigateur, tous sans logique serveur. D'autres types de jeux peuvent également fonctionner.
Pour la coop en particulier, découvrez pourquoi les jeux casual en coop ont également besoin d'un serveur de jeu dédié.
Pour une comparaison côte à côte de chaque modèle de réseau, consultez serveurs faisant autorité, relais et peer-to-peer.
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 |
|
Fish-Networking | 4.7.4 |
|
PurrNet | 1.24.1 |
|
Netcode for GameObjects | 1.13.0 |
|
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) etRELAY_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 :
Un joueur appuie sur Héberger. Le relais crée un salon et renvoie un code à 6 lettres, affiché dans le HUD.
L'hôte partage le code : dans un écran de groupe, une liste d'amis, un chat ou un message Discord.
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) :
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.
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.
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).
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.
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.
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
Compilez le client Windows : Tanks > Build Windows client.
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.
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é.
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.

Un lancement mondial impeccable pour Rivals of Aether 2
Aether Studios
Découvrez comment Aether Studios a rapidement ajouté Edgegap et a offert un lancement et un post-lancement sans faille à sa communauté.
Étude de cas

Surmontez la latence introduite par l'utilisation de WiFi par la réalité virtuelle dans les jeux multijoueurs compétitifs.
Halfbrick Studios
Découvrez comment Halfbrick a réussi à lancer et à maintenir un accès anticipé axé sur le multijoueur sur la plateforme VR META Quest.
Étude de cas

L'application sociale de MENA ajoute des jeux en ligne
WOLF
Découvrez comment l'application sociale très populaire de la région MENA a facilement ajouté des jeux de matchmaking et d'orchestration multijoueur à WOLF Qanawat.
Étude de cas

L'orchestration hybride maintient Kickoff Tactics prêt pour tout type de trafic
Birch Games
Comment l'orchestration hybride d'Edgegap pour gérer tant le le trafic prévisible et imprévisible, grâce aux flottes "egress-free" et le cloud.
Étude de cas

La guerre en ligne authentique nécessite l'orchestration ultime
Highwire Games
Découvrez comment le besoin de performance de Highwire nécessite une orchestration que seul Edgegap peut fournir.
Étude de cas

22 000 avis, 4,8 étoiles et une infrastructure qui s'est adaptée automatiquement
Sinn Studios
Comment une intégration simple, prise en charge par Slack, a permis au titre VR à succès de Sinn Studio d'être mis en ligne rapidement et de s'y maintenir.
Étude de cas

Orchestration de Serveurs Dynamiques
Under NDA - AAA Studio
Découvrez comment l'un des plus grands studios AAA du monde a amélioré son expérience multijoueur pair à pair grâce à l'informatique en périphérie.
Étude de cas

Latence presque nulle pour un jeu de combat AAA
AAA Studio - Under NDA
Comment un projet non annoncé a permis d'obtenir le délai d'attente le plus bas possible et d'améliorer l'équité dans son jeu 1v1.
Étude de cas

Jouez aux dieux avec la physique multiplayer
Squido Studio
Découvrez comment Squido utilise les serveurs de jeu optimisés par Edgegap pour offrir un gameplay VR époustouflant et chaotique.
Étude de cas

Des solutions entièrement gérées qui font gagner du temps à un jeu VR
Dirty Pearl Studios
Découvrez comment Dirty Pearl Studios a gagné du temps de développement grâce à l'intégration facile d'Edgegap et à l'orchestration automatisée de son intégration avec Nakama.
Étude de cas

Lunes de sang de 7 jours
The Fun Pimps & iLLOGIKA
Découvrez comment Illogika a considérablement réduit ses coûts de serveur et garanti l'expérience en ligne attendue par la franchise 7 Days to Die.
Étude de cas

Déploiement instantané de serveurs globaux pour l'éducation médicale en XR
AlensiaXR
Comment AlensiaXR utilise Edgegap pour offrir des sessions d'anatomie partagées à faible latence et toujours disponibles aux étudiants en médecine du monde entier.
Étude de cas

FunPlus
FunPlus
Étude de cas

The Lightkeepers : un jeu coopératif social en VR avec des serveurs dédiés
Spectral Games
Comment Spectral Games a utilisé Edgegap Matchmaking et Server Browser pour lancer des serveurs dédiés pour son salon social VR, sans aucune expérience préalable des serveurs.
Étude de cas

Déploiements rapides & fiables dans le monde pour le PvPvE Gravebound
Crater Studios
Comment l'orchestration et le matchmaking d'Edgegap ont aidé Crater Studios à se concentrer sur le gameplay plutôt que sur l'infrastructure.
Étude de cas

Échelle rapide du métavers web
Hiber
Découvrez comment Hiber a éliminé les incertitudes de sa planification de capacité serveur avec Edgegap.
Étude de cas

Exigences matérielles élevées et pools de serveurs de jeux personnalisés
Alderon Games
Découvrez comment Alderon Games utilise instantanément une pool personnalisée de serveurs de jeux à travers plusieurs fournisseurs dans le monde pour son MMO populaire.
Étude de cas

Intégration facile pour les développeurs indépendants
WhaleFood Games
Découvrez comment WhaleFood Games a "chassé" ses problèmes de netcode avec Edgegap.
Étude de cas

Une technologie qui propulse le premier jeu eSports de l'Asie du Sud-Est.
Anantarupa Studios
Découvrez comment Edgegap a transformé le paysage du jeu en Asie du Sud-Est en démocratisant des infrastructures complexes avec sa solution.
Étude de cas

Une frappe. Portée mondiale.
Triple Hill Interactive
Comment Triple Hill Interactive tire parti de l'orchestration d'Edgegap pour offrir une faible latence et améliorer l'équité dans un genre où chaque milliseconde compte.
Étude de cas

Un Battle Royale en équipe au rythme effréné... avec des peluches d'animaux armées jusqu'aux dents !
SANDYFLOOR
Découvrez comment un studio indépendant basé en Corée a lancé son jeu multijoueur dans le monde entier.
Étude de cas

Les courses de chevaux sur mobile disponible mondialement grâce à Edgegap.
Mirai Labs
Comment Mirai Labs propulse les courses multijoueurs mondiales de Pegaxy Blaze grâce au déploiement de serveurs juste-à-temps et au vCPU fractionné pour maintenir un coût bas.
Étude de cas

Gestion et distribution des serveurs
Matrioshka Games
Lisez comment Matrioshka Games a réussi à expédier un Battle Royale en accès anticipé avec des ressources limitées.
Étude de cas

À mon signal, déchaînez l'enfer !
TyGames
Découvrez comment le studio indépendant TyGames immerge les joueurs dans un combat multijoueur de gladiateurs à la troisième personne.
Étude de cas

Orchestration Instantanée Mondiale
Soliton Interactive
Découvrez comment Soliton Interactive a réalisé l'impossible… Livrer son premier jeu jouable en mode multijoueur !
Étude de cas

Le jeu de hockey avec une physique côté serveur & une latence sous les 50ms
NS7
Découvrez pourquoi seul Edgegap pourrait permettre à un studio indépendant de réaliser sa vision d'un gameplay sportif F2P de qualité AAA grâce à la physique côté serveur et à l'autorité.
Étude de cas

Déploiements régionaux pour les jeux en ligne
X1 Contra 1
X1 Contra 1 propose des jeux PvP décontractés en temps réel à sa base de joueurs brésilienne grâce à un hébergement économique et à des déploiements régionaux
Étude de cas

Payez uniquement lorsque les joueurs jouent : une infrastructure abordable
Meltdown Interactive
Comment Edgegap a aidé le développeur indépendant Meltdown Interactive Media à résoudre la mise à l’échelle rentable et le matchmaking sans complexité
Étude de cas

Une plateforme Edgegap, trois profils réseau très différents
Warped Games
Comment Warped Games gère un hub social, du coopératif en temps réel et du coopératif au tour par tour, le tout sur la même API de déploiement Edgegap et le même pipeline de conteneurs.
Étude de cas

Pool Live Tour Max
RETA Games
Étude de cas

Le tireur d'extraction POP Web3 de Corée devient mondial, instantanément
NDUS Entertainment
Comment XOCIETY a facilement ajouté l'orchestration Edgegap et intégré un matchmaking personnalisé en travaillant aux côtés des Edgegap Ping Beacons pour optimiser la latence.
Étude de cas

Multijoueur dans chaque dimension
Arcadia.tv
Découvrez comment Arcadia.tv utilise le réseau edge d'Edgegap pour offrir un sport VR innovant basé sur l'équipe et la localisation.
Étude de cas

Un jeu mobile F2P réduit ses coûts d'infrastructure grâce aux serveurs JIT
Game Changers Worldwide
Comment Game Changer Worldwide a hébergé le PvP 3v3 en temps réel de Rumble Rush à l'échelle mondiale sur mobile.
Étude de cas
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.









