Découvrez comment fonctionne Edgegap

Découvrez comment fonctionne Edgegap

Unity Engine

Megacity Metro (Mobile)

Déployer sur Edgegap

Megacity Metro (Mobile) : Exécutez le jeu de tir Netcode for Entities d'Unity sur les serveurs dédiés d'Edgegap, avec Matchmaking

Publié

Publié

dernière vérification de l'exactitude

dernière vérification de l'exactitude

Exemple de jeu Megacity Metro (moteur Unity) fonctionnant sur des serveurs de jeu dédiés Edgegap

Megacity Metro est l'exemple de jeu de tir multijoueur d'Unity : jusqu'à 150 joueurs volent à travers une ville au cours d'une même partie, développé avec Netcode for Entities (DOTS/ECS). En amont, il fonctionne sur Unity Gaming Services. Le fork d'Edgegap exécute son serveur dédié sur Edgegap et trouve des parties grâce au matchmaker d'Edgegap.

Le netcode du jeu ne change pas : même Netcode for Entities avec autorité côté serveur, même prédiction et compensation de lag. Le fork ajoute quelques fichiers Edgegap et deux petits hooks. Si les paramètres Edgegap sont laissés vides, le jeu se comporte exactement comme en amont.

Les joueurs appuient sur Trouver une partie, le matchmaker démarre un serveur dédié, et les joueurs qui recherchent plus tard rejoignent ce serveur en cours d'exécution via le backfill, jusqu'à 150 par serveur. Le serveur arrête son propre déploiement lorsque plus personne ne joue.

État pour le mobile au 30 octobre 2026 : les téléphones rejoignent via Trouver une partie, car les builds de production pour mobile masquent l'option de connexion directe. Ce chemin de matchmaker a été testé avec des clients Windows. Un APK Android compile et a atteint le menu principal dans l'émulateur Android, où son client de matchmaker a indiqué que le matchmaker était opérationnel ; aucun téléphone n'a encore rejoint de serveur Edgegap, et iOS n'a pas été compilé.

Le réseau d'Edgegap s'étend sur plus de 615 emplacements Edge Cloud (en savoir plus). Chaque serveur est déployé sur le meilleur emplacement disponible pour ses joueurs et n'est facturé que pendant son exécution.

Plateformes : Serveur dédié Linux. Clients testés : Windows. L'APK Android se compile et s'exécute dans l'émulateur Android ; les téléphones, iOS et macOS sont pris en charge par le jeu d'origine mais pas encore testés sur Edgegap. Jeu original créé par Unity Technologies, sous Unity Companion License.

Comment ça fonctionne

  1. Un joueur appuie sur Trouver une partie. Le client envoie un ticket solo au matchmaker Edgegap, sans connexion à Unity Gaming Services.

  2. Le matchmaker regroupe les joueurs dans le profil metro (une équipe de 2 à 150) et lance un déploiement Edgegap pour la partie.

  3. Le serveur démarre, écoute sur le port UDP 7979 et ignore les sessions UGS. Chaque client reçoit l'adresse IP et le port externe du serveur, se connecte et envoie son ID de ticket afin que le serveur puisse compter les places disponibles.

  4. Tant que des places sont libres, le serveur maintient ouverts les tickets de backfill. Un joueur qui lance une recherche ultérieurement est redirigé vers ce serveur en cours d'exécution au lieu d'un nouveau.

  5. Quand il ne reste plus personne, le serveur ferme ses backfills et arrête son propre déploiement, ce qui met fin à la facturation.

Ce que le fork a modifié :

Chemin

Ce qu'il fait

Assets/Scripts/Gameplay/Mix/Multiplayer/Edgegap/EdgegapEnvironment.cs

Lit ce qu'Edgegap injecte dans un déploiement, ainsi que la cible de connexion directe du client.

Assets/Scripts/Gameplay/Mix/Multiplayer/Edgegap/EdgegapServerLifecycleSystem.cs

Serveur : arrête le déploiement lorsque personne ne rejoint ou que tout le monde est parti.

Assets/Scripts/Gameplay/Mix/Multiplayer/Edgegap/EdgegapMatchmakerClient.cs

Client : met en file d'attente un ticket solo et renvoie l'adresse IP et le port du serveur.

Assets/Scripts/Gameplay/Mix/Multiplayer/Edgegap/EdgegapBackfillSystem.cs, EdgegapTicketRpc.cs

Serveur : maintient ouverts les backfills tant que des places sont libres, et fait correspondre les connexions aux tickets.

Assets/Scripts/Gameplay/Mix/Multiplayer/Edgegap/EdgegapMatchmakerSettings.cs, Assets/Resources/EdgegapMatchmakerSettings.asset

URL du matchmaker, jeton d'authentification, limites de profil et de backfill, partagés par le client et le serveur.

Assets/Scripts/Gameplay/Mix/Multiplayer/SDK/Server/ServerManager.cs

Hook : sur Edgegap, ignore les sessions UGS.

Assets/Scripts/Gameplay/Mix/UI/MonoBehaviours/Matchmaker/MatchMakingConnector.cs

Hook : Trouver une partie utilise le matchmaker Edgegap, ou se connecte directement à un serveur.

Assets/Edgegap/Editor/EdgegapPluginBuild.cs, EdgegapClientBuild.cs

Exécute le serveur de build du plugin Unity d'Edgegap depuis la ligne de commande, et compile les clients de test Windows et Android.

.dockerignore, matchmaker-config.json

Image serveur et configuration du matchmaker.

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.

Megacity Metro skyline at dusk, with a flying vehicle near a glowing tower, and the Unity logo.

Megacity Metro d'Unity, un jeu de tir utilisant Netcode for Entities, avec son serveur sur Edgegap.

Guide étape par étape

Exécuter l'exemple

1. Avant de commencer

  • Un compte Edgegap gratuit. Aucune carte de crédit n'est requise pour tester.

  • Unity 6000.1.0f1 avec Linux Build Support (IL2CPP), Linux Build Support (Mono) et Linux Dedicated Server Build Support, ainsi que le module correspondant à la plateforme de votre client (Windows Build Support (IL2CPP) pour le client testé).

  • Docker Desktop, en cours d'exécution.

  • Git LFS, installé avant de cloner : le projet contient environ 415 Mo de contenu LFS. Prévoyez du temps : Unity indique que le premier clonage, la première ouverture du projet et la première compilation peuvent prendre chacun entre 20 et 50 minutes.

  • Clonez le fork. Le téléchargement sous forme de fichier ZIP ne fonctionne pas pour ce projet.

Git : Unity nécessite un client Git (2.14.0 ou plus récent) dans votre PATH pour installer des packages à partir d'une URL Git, comme le plugin Edgegap. macOS en possède généralement déjà un (outils en ligne de commande Xcode) ; sur Windows, installez Git.

2. Compiler, tester et téléverser le serveur

Dans l'Éditeur : Tools → Edgegap Server Hosting → Sign in with Edgegap (ou collez un jeton, puis Valider) → Build server. Le plugin bascule sur Linux avec la sous-cible Dedicated Server avant de compiler. Depuis la ligne de commande, avec le projet fermé dans l'Éditeur :

Unity -batchmode -buildTarget Linux64 -standaloneBuildSubtarget Server -projectPath . -executeMethod EdgegapPluginBuild.BuildServer -logFile build.log

Conservez -buildTarget Linux64 -standaloneBuildSubtarget Server : sans eux, la compilation du contenu Entities échoue avec le message « Unable to build with the current configuration ».

Le build est généré dans Builds/EdgegapServer/ (environ 3,4 Go, principalement des fichiers de débogage). Le fichier .dockerignore du fork les exclut, de sorte que l'image fait environ 537 Mo.

Ensuite, dans la fenêtre du plugin :

Containerize with Docker : nom de l'image megacity-metro, tag laissé vide (le plugin utilise l'heure UTC actuelle), Dockerfile par défaut.

Test Your Server Locally : paramètres Docker Run optionnels -p 7979:7979/udp -e UNITY_COMMANDLINE_ARGS="-port 7979", puis Deploy local container. Sans -port 7979, Megacity se lie à 127.0.0.1, ce que rien en dehors du conteneur ne peut atteindre.

Upload to Edgegap : nom de l'application megacity-metro, puis Upload image et Create app version. Le plugin pousse l'image et ouvre le formulaire de version du tableau de bord. Pour les builds ultérieurs, Rebuild from Source compile, conteneurise et pousse en un seul clic.

3. Créer la version de l'application

Dans le tableau de bord, créez l'application megacity-metro et une version pour votre image :

  • L'image et le tag renseignés par le plugin, ainsi que la variable d'environnement UNITY_COMMANDLINE_ARGS = -port 7979. Assurez-vous que l'identifiant du registre est configuré : un profil de registre, ou le nom d'utilisateur et le jeton depuis la page Container Registry.

  • 1 vCPU et 2 Go, la taille testée. Un serveur inactif a utilisé environ 18 % de CPU et 323 Mo.

  • Un port : nom gameport, 7979, UDP.

Variables d'environnement facultatives sur la version : EDGEGAP_FIRST_PLAYER_TIMEOUT_S et EDGEGAP_EMPTY_TIMEOUT_S (temporisateurs d'arrêt automatique), EDGEGAP_MAX_PLAYERS et EDGEGAP_MAX_OPEN_BACKFILLS (limites de backfill), et UNITY_COMMANDLINE_ARGS pour les arguments de serveur supplémentaires.

4. Tester un serveur avec un client de bureau

Avant d'ajouter le matchmaker, vérifiez que le serveur fonctionne. Déployez la version depuis le tableau de bord, près de chez vous. Le journal du serveur affiche Running on Edgegap ... skipping UGS sessions.

Démarrez un client de bureau avec l'hôte et le port externe du déploiement (sur la page de déploiement ; ce n'est pas le 7979) :

<client executable> -edgegapConnect <host>:<external port>

Ou définissez EDGEGAP_CONNECT=<host>:<external port> avant de le lancer. L'hôte peut être l'adresse IP ou le FQDN. Avec une cible de connexion directe, le client ignore la connexion UGS et ne nécessite aucun projet UGS. Le serveur enregistre [Edgegap] Connected players: 1 lorsque vous le rejoignez.

La connexion directe est réservée aux tests sur ordinateur de bureau : les versions de production mobiles masquent l'option Connexion, de sorte que les téléphones utilisent Trouver un match (étape 6).

Pour obtenir rapidement un client de test Windows, compilez avec Mono plutôt qu'avec IL2CPP (la compilation IL2CPP Master a pris environ 40 minutes et 12 Go de RAM) :

Unity -batchmode -quit -buildTarget Win64 -standaloneBuildSubtarget Player -projectPath . -executeMethod EdgegapClientBuild.Build -edgegapClientTarget win64 -edgegapClientMono -logFile client.log

Le résultat se trouve dans Builds/Client/win64-mono/. Conservez -standaloneBuildSubtarget Player après une compilation de serveur, sinon la compilation échoue avec l'erreur « script class layout is incompatible ».

Arrêtez le déploiement lorsque vous avez terminé. Le niveau gratuit n'exécute qu'un seul déploiement à la fois.

5. Ajoutez-le à votre propre jeu Netcode for Entities

Le fork est une référence fonctionnelle : votre agent de codage peut copier ses fichiers testés au lieu de les écrire à partir de zéro. Cinq modifications permettent d'exécuter un jeu Netcode for Entities sur Edgegap :

  1. Le serveur ignore UGS sur Edgegap. Lorsque la variable ARBITRIUM_REQUEST_ID est définie, le serveur démarre sans sessions UGS (ServerManager.cs, EdgegapEnvironment.cs).

  2. Le serveur s'arrête lui-même. Un système côté serveur (server-world system) appelle ARBITRIUM_DELETE_URL lorsque personne ne rejoint ou que tout le monde est parti (EdgegapServerLifecycleSystem.cs).

  3. Trouver une partie (Find Match) utilise le matchmaker Edgegap. Le client place un ticket en file d'attente avec le SDK Unity d'Edgegap et transmet l'IP et le port renvoyés au flux de connexion existant du jeu (EdgegapMatchmakerClient.cs, MatchMakingConnector.cs).

  4. Les serveurs en cours d'exécution continuent de se remplir. Un système côté serveur maintient les remplissages automatiques (backfills) ouverts tant qu'il reste des places libres, et les clients envoient leur ID de ticket via un RPC après s'être connectés (EdgegapBackfillSystem.cs, EdgegapTicketRpc.cs).

  5. Un build de serveur Linux et une image. Le plugin Unity Edgegap compile et conteneurise le serveur (EdgegapPluginBuild.cs pour la ligne de commande) ; le fichier .dockerignore du fork exclut les fichiers de débogage de l'image, et la version de l'application transmet -port 7979 dans UNITY_COMMANDLINE_ARGS.

Ensuite, créez la version de l'application et le matchmaker comme indiqué aux étapes 3 et 6.

Avec votre agent :

« Charge la compétence edgegap, puis edgegap-unity. Mon jeu utilise Netcode for Entities. En utilisant github.com/edgegap/netcode-game-sample-unity-dots-ecs-mobile-megacity-metro comme référence, ajoute un système côté serveur qui arrête le déploiement Edgegap lorsque le serveur est vide, fais en sorte que Trouver une partie se mette en file d'attente avec le matchmaker Edgegap et se connecte à l'adresse retournée, ajoute le backfill de serveur avec des ID de ticket envoyés via un RPC, et compile le serveur dédié Linux dans le Dockerfile du fork. »

Les compétences d'Edgegap ne disposent pas encore de modèles Netcode for Entities : edgegap-unity couvre le flux de travail Unity, et les systèmes ECS du fork servent de référence pour les parties liées au netcode.

Pour le détail de chaque étape, manuellement, consultez le guide d'intégration du moteur Unity.

6. Trouver une partie avec le système de matchmaking d'Edgegap

C'est le chemin qu'utilisent les téléphones. Il a été testé avec des clients Windows les 21 et 22 octobre 2026 ; un APK Android a atteint le menu principal dans l'émulateur Android, mais « Trouver une partie » n'a pas été lancé depuis celui-ci, et aucun téléphone n'y a encore joué.

  1. Définissez application.version dans matchmaker-config.json sur la version de votre application. Le profil metro correspond à une équipe de 2 à 150 joueurs. Deux joueurs cherchant ensemble obtiennent un serveur dès qu'ils sont associés, et un joueur seul en obtient un après environ 20 secondes (les tickets expirent après 30 secondes). Cela convient pour les tests ; augmentez le minimum pour de vraies parties.

  2. Dans le tableau de bord, ouvrez Matchmaker, sélectionnez Create Matchmaker, téléversez matchmaker-config.json, puis sélectionnez Create and Start.

  3. Lorsqu'il est ONLINE, copiez l'API URL et l'Auth Token dans Assets/Resources/EdgegapMatchmakerSettings.asset. L'Auth Token peut être intégré sans risque dans les clients : il ne donne aucun accès à votre compte Edgegap.

  4. Recompilez le serveur et les clients. Tous deux lisent cet asset : les clients pour trouver des parties, le serveur pour créer des backfills. Utilisez ensuite « Rebuild from Source » dans le plugin et enregistrez une nouvelle version de l'application.

Appuyez sur Find Match dans un client. Le statut passe par « Recherche en cours... », « Partie trouvée, démarrage du serveur... », puis le client se connecte. Les clients en mode batch (-batchmode -nographics) effectuent le matchmaking de manière autonome.

Backfill (rejoindre une partie en cours). Chaque ticket comporte un attribut backfill_group_size : les clients envoient ["new", "1"] (une nouvelle partie, ou une place sur un serveur en cours d'exécution), et le serveur envoie ["1"]. Le serveur accorde 60 secondes à chaque joueur mis en correspondance pour se connecter, maintient jusqu'à 3 backfills ouverts tant que des places sont libres, et les ferme tous avant de s'arrêter.

Arrêt automatique. Le serveur arrête son déploiement 300 secondes après le démarrage si aucun joueur ne s'est jamais connecté, ou 60 secondes après le départ du dernier joueur. Les joueurs mis en correspondance mais toujours en cours de connexion le maintiennent actif.

Avec le forfait gratuit, le matchmaker s'arrête 3 heures après chaque démarrage ; redémarrez-le depuis le tableau de bord (son URL et son jeton restent les mêmes). Lorsque vous déployez une nouvelle version du serveur, mettez à jour application.version dans le matchmaker (Stop, Edit, Start).

Limites connues

  • Les téléphones ne sont pas encore testés. L'APK Android (IL2CPP, ARM64, repli OpenGL ES 3.1) se compile et a atteint le menu principal dans l'émulateur Android, mais aucun téléphone n'a encore rejoint un serveur Edgegap, et iOS nécessite un Mac pour être compilé. Aucun test de jeu sur ordinateur en mode fenêtré n'a été effectué non plus ; les clients testés fonctionnaient en mode sans interface graphique (headless).

  • Aucune validation de ticket. Le serveur enregistre une connexion pour laquelle aucun ticket ne lui a été fourni, mais la laisse quand même entrer.

  • Les remplissages automatiques (backfills) survivent à un arrêt externe. Si un déploiement est arrêté depuis le tableau de bord, l'API ou en raison de sa durée maximale, le serveur se ferme sans clôturer ses backfills. Pendant un délai pouvant aller jusqu'à 30 secondes, jusqu'à leur expiration, ils peuvent envoyer un joueur vers le serveur arrêté ; la connexion de ce joueur expire par dépassement de délai (timeout), et la recherche de partie (« Find Match ») suivante fonctionne.

  • Les connexions Vivox et UGS restent inchangées. Les chemins Edgegap ne les utilisent pas, et le navigateur de sessions du mode Connect en jeu répertorie toujours les sessions UGS.

Ce qui a été testé

Testé sur Edgegap avec Unity 6000.1.0f1 et une version d'application 1 vCPU / 2 Go sur 7979/UDP. Les clients étaient des builds Windows, exécutés en mode headless (-batchmode -nographics).

  • 20 octobre 2026, connexion directe : un client Windows IL2CPP s'est connecté avec -edgegapConnect et le serveur a enregistré l'arrivée du joueur. Le déploiement s'est arrêté de lui-même sans joueur (1502 s, délai d'expiration défini à 1500 s) et environ 60 s après que le client a quitté.

  • 21 octobre 2026, matchmaker (niveau gratuit, profil metro) : deux clients Windows (builds Mono) se sont mis en file d'attente ensemble, ont reçu MATCH_FOUND puis HOST_ASSIGNED pour le même déploiement, et se sont tous deux connectés. Un troisième client est passé de SEARCHING directement à HOST_ASSIGNED sur ce déploiement en cours via un backfill, et a rejoint. Après que les trois ont quitté, le déploiement s'est arrêté de lui-même.

  • En local (serveur dans Docker, variables Edgegap simulées, vrai matchmaker) : lorsqu'aucun joueur apparié ne s'est connecté dans les 60 s, les places ont été libérées et les backfills fermés.

  • 22 octobre 2026, émulateur Android (image Android 14 x86_64) : l'APK ARM64 + x86_64 a atteint le menu principal et son client matchmaker a signalé le matchmaker comme étant opérationnel. Find Match n'a pas été exécuté depuis l'émulateur. Non testé : téléphones, clients iOS et macOS. La version du plugin (29 octobre) a été vérifiée dans un conteneur local, pas encore sur Edgegap avec des clients.

Questions Fréquemment Posées

Questions sur l'exécution de Megacity Metro et Netcode for Entities d'Unity sur Edgegap.

Netcode for Entities peut-il fonctionner sur les serveurs dédiés Edgegap ?

Oui. Créez le jeu pour la cible Serveur Dédié Linux et exécutez-le dans un conteneur sur Edgegap. Le serveur de Megacity Metro fonctionne sur Edgegap sans modifier son netcode : le fork ajoute uniquement quelques fichiers Edgegap et deux petits hooks.

L'échantillon Megacity Metro fonctionne-t-il sur mobile avec Edgegap ?

Pas encore sur téléphone. Les téléphones rejoignent via Trouver une partie, qui utilise le système de matchmaking Edgegap et fonctionne avec les clients Windows. L'APK Android se compile et a atteint le menu principal dans l'émulateur Android ; aucun téléphone n'a encore rejoint de serveur Edgegap.

Les joueurs peuvent-ils rejoindre une partie de Megacity Metro qui a déjà commencé ?

Oui, grâce au backfill. Tant qu'un serveur a des places libres, il maintient des tickets de backfill ouverts auprès du matchmaker Edgegap, de sorte que les joueurs qui lancent une recherche plus tard le rejoignent, jusqu'à 150 par serveur.

Ai-je toujours besoin d'Unity Gaming Services ?

Pas pour l'hébergement ou le matchmaking. Sur Edgegap, le serveur ignore les sessions UGS, et Find Match ainsi que la connexion directe ignorent la connexion à UGS. Le chat vocal Vivox utilise toujours UGS.

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.