Colyseus Realtime Tanks
Hébergez un jeu de chars multijoueur Colyseus 0.17 sur Edgegap avec un serveur dédié par partie, en utilisant une connexion directe ou le système de matchmaking Edgegap.
Découvrez comment héberger Colyseus des serveurs sur Edgegap en utilisant les techniques du Realtime Tanks exemple de l'équipe Colyseus.
L'exemple comprend un serveur Colyseus faisant autorité et 9 clients créés avec différents moteurs - Three.js, PlayCanvas, Construct 3, Godot, Unity, Defold, GameMaker, Haxe et MonoGame. Chaque partie dispose de son propre serveur, lancé près de ses joueurs, et le serveur s'arrête de lui-même lorsque la partie est terminée.
Cet exemple montre :
Colyseus 0.17 serveur dans un
linux/amd64image Docker, à l’écoute sur le port2567,un serveur par partie - le serveur arrête son propre déploiement lorsque personne ne se joint, lorsqu'il reste vide, ou après un nombre défini de manches,
mode direct - démarrez un déploiement et transmettez son URL à l'un des 9 clients avec
?server=ou--server=,Matchmaker Edgegap (facultatif) - intégré aux clients Three.js, Unity et Godot, pour les versions web et desktop,
un port WebSocket avec mise à niveau TLS - transportant à la fois la requête HTTP de matchmaking Colyseus et le WebSocket de la salle.
✔️ Préparation
Avant de commencer, vous aurez besoin de :
projet d'exemple Realtime Tanks (modifié pour Edgegap),
Node.js, pour exécuter le serveur localement et le script de déploiement.
En local, le serveur se comporte comme la version amont. Depuis le serveur dossier, exécutez npm install puis npm run dev.
⚡ Déployer et connecter
1. Construire l’image du serveur
☑️ Pour commencer, vous devrez créer un compte gratuit sur Edgegap. Aucune carte de crédit requise.
☑️ Trouvez votre Container Registry nom du projet et identifiants.
☑️ Connectez-vous au registre de conteneurs d’Edgegap avec Docker, en utilisant le nom de projet de votre registre, votre nom d’utilisateur et votre jeton :
☑️ Construisez et poussez l'image de votre serveur :
☑️ Facultativement, testez d'abord votre image en local. ARBITRIUM_REQUEST_ID lui fait se comporter comme sur Edgegap - sans URL de suppression définie, l'auto-arrêt l'enregistre et quitte :
✅ Vous pouvez maintenant passer à l’étape suivante.
2. Créer une version d’application
☑️ Créez une application nommé realtime-tanks, et une version nommée v1 avec :
image
registry.edgegap.com/<project>/realtime-tanks, tagv1,votre nom d’utilisateur et jeton du registre de conteneurs, afin qu’Edgegap puisse extraire votre image,
ressources 0,25 vCPU et 512 Mo de mémoire,
port
2567, nommégameport, protocole WS, avec mise à niveau TLS activé,durée maximale 60 minutes pour les tests.
Facultativement, définissez des variables d’environnement sur votre version d’application :
MATCH_ROUNDS- terminez la partie après ce nombre de manches gagnées (par défaut0, une arène sans fin),FIRST_JOIN_TIMEOUT_S- secondes avant qu’un serveur que personne n’a rejoint ne s’arrête de lui-même (par défaut120),EMPTY_TIMEOUT_S- nombre de secondes avant qu’un serveur dont tout le monde est parti s’arrête tout seul (par défaut30).
✅ Vous pouvez maintenant passer à l’étape suivante.
3. Connexion directe
☑️ Démarrez un serveur près de vous avec le script de déploiement de l’exemple. Votre jeton API Edgegap reste sur votre machine :
Le script affiche wss://<request_id>.pr.edgegap.net:<port> et comment le transmettre à chaque client.
☑️ Transmettez l'URL à vos clients :
Three.js, PlayCanvas, Construct 3 -
?server=wss://...dans l'URL de la page,Godot -
--server=wss://...(après--dans les arguments d'exécution principaux de l'éditeur), exportation web?server=wss://...,Unity -
--server=wss://...en ligne de commande, WebGL?server=wss://..., ou leserverUrlchamp,Defold - HTML5
?server=wss://..., natif--config=tanks.server_url=wss://...ou[tanks] server_urldansgame.project,GameMaker -
--server=wss://...en ligne de commande, HTML5?server=wss://...,Haxe - JS
?server=wss://..., HashLink--server=wss://...,MonoGame -
--server=wss://...ouTANKS_SERVER_URLvariable d'environnement.
🙌 Félicitations pour votre premier déploiement sur Edgegap !
4. Ajouter le Matchmaker (facultatif)
☑️ Ouvrez la page Matchmaker page du tableau de bord, cliquez sur Créer, et téléversez edgegap/matchmaker-config.json depuis l’exemple.
La configuration contient un seul casual profil pour 2 à 8 joueurs par partie. Après 15 secondes, il démarre une partie avec tous les joueurs en attente, avec au moins 2 joueurs.
☑️ Ajoutez chaque origine qui sert votre jeu à allowed_cors_origins, car les builds navigateur appellent le matchmaker depuis la page (voir CORS). La configuration permet http://localhost:5173 (Vite), http://localhost:8060 (Godot web) et http://localhost:8080.
☑️ Cliquez sur Créer et démarrer. Une fois que votre matchmaker affiche En ligne, copiez son URL API et jeton d’authentification.
☑️ Démarrez vos clients avec les paramètres du matchmaker :
Three.js -
http://localhost:5173/?mm=<API URL>&mmToken=<Auth Token>, ouVITE_MM_URL/VITE_MM_TOKENdans.env.local,Unity -
--mm=<API URL> --mm-token=<Auth Token>, WebGL?mm=...&mmToken=..., ou Matchmaker Edgegap champs dansGameManager,Godot -
-- --mm=<API URL> --mm-token=<Auth Token>, exportation web?mm=...&mmToken=....
☑️ Ouvrez deux clients - le matchmaking nécessite au moins 2 joueurs, et ils peuvent utiliser des moteurs différents.
Chaque client affiche « Recherche de joueurs... » et se connecte une fois qu'un serveur lui est attribué. Un serveur paramètre a toujours priorité sur le matchmaker.
🙌 Félicitations pour votre premier déploiement avec matchmaking sur Edgegap !
🔄 Cycle de vie de la partie
Le client crée un ticket avec
POST /ticketspendantcasualprofil, puis le vérifie toutes les 2 secondes avecGET /tickets/{id}.Le matchmaker déploie
realtime-tanksprès des joueurs. Lorsque le ticket atteintHOST_ASSIGNED, le client lit le FQDN et le port externe de l'attributiongameport.Le client rejoint
wss://<fqdn>:<port>. Un serveur tout juste démarré peut répondre 502 pendant quelques secondes, donc les clients réessaient de se connecter pendant jusqu'à 20 secondes (voir Se connecter au serveur).Appels du serveur
ARBITRIUM_DELETE_URLpour arrêter son propre déploiement lorsque personne n'a rejoint dans un délai deFIRST_JOIN_TIMEOUT_S, lorsque tout le monde est parti pendantEMPTY_TIMEOUT_S, ou lorsqueMATCH_ROUNDSdes manches ont été remportées. La durée maximale de votre version d'application sert de filet de sécurité.
Le client du matchmaker est léger et sans dépendances, il se porte donc facilement vers d'autres clients - voir web-threejs/src/Matchmaker.ts, unity/Assets/Scripts/EdgegapMatchmaker.cs et godot/scripts/edgegap_matchmaker.gd.
Voir Matchmaking et Déploiements pour en savoir plus.
🚀 Aller plus loin
Valider les joueurs qui rejoignent - les déploiements du matchmaker obtiennent
MM_TICKET_IDS. Faites passer aux clients l'identifiant de leur ticket dans les options de connexion et vérifiez-le dansonAuth, afin que seuls les joueurs appariés puissent rejoindre.Avant le lancement - définissez
inspectàfalsedans votre configuration de matchmaker, listez vos véritables origines et augmentez la durée maximale pour qu'elle corresponde à vos parties (voir Avant la mise en production).
⚠️ Problèmes connus
Testé de bout en bout sur Edgegap avec Colyseus 0.17, matchmaker 3.3.2, Godot 4.5.2 et Unity 6000.3 :
direct - les clients Node Colyseus et le client Godot de bureau ont rejoint un déploiement via
wss://, et le serveur s'est arrêté de lui-même après le départ de tous,matchmaker - Three.js dans le navigateur et le client Godot de bureau ont été appariés sur un seul serveur, puis Three.js et une version Windows de Unity.
Construct 3, Defold, GameMaker, Haxe et PlayCanvas
serveurles remplacements, l'exportation web Godot et Unity WebGL ne sont pas encore testés.
Mis à jour
Ce contenu vous a-t-il été utile ?

