Plugin Edgegap - Hébergement Automatisé de Serveur de Jeu - Tutoriel Unity
Bonjour,
Nous allons voir comment configurer facilement n'importe quel projet Unity pour démarrer et héberger, serveur de jeu dédié directement depuis l'éditeur de Unity en utilisant le plugin Edgegap. Pour mettre votre jeu en ligne et jouable, dans le monde entier, en quelques minutes.
Nous recommandons de suivre notre documentation.
Allons-y.
Avant d'utiliser le plugin, il y a trois exigences pour s'assurer que Unity fonctionne pour les serveurs dédiés.
La première consiste à télécharger et à installer Docker, pour aider à containeriser le serveur de jeu. Docker est utilisé par des millions d'utilisateurs et par les plus grandes entreprises du monde.
La deuxième consiste à utiliser une version de support à long terme de Unity (surnommée « LTS ») afin d'assurer la compatibilité du plugin, mais aussi de vos projets de développement en général. À ce jour (2025.12), la dernière version est Unity 6.3 LTS.
La troisième consiste à s'assurer que les modules de construction de serveur Linux sont installés. Depuis le HUB de Unity, sélectionnez « Gérer » puis « Ajouter des modules ». Ensuite, sélectionnez les deux modules de « Support de construction Linux » de « (Mono) » et « (IL2CPP) », ainsi que les modules de « Support de construction de serveur dédié Linux » et installez-les si vous ne l'avez pas déjà fait.
Avertissement
Assurez-vous d'ajouter le plugin Unity d'Edgegap en utilisant "Ajouter un projet à partir de Git" pour vous assurer d'utiliser la dernière version du projet.
Sélectionnez "Fenêtre" puis "Gestionnaire de paquets"
Cliquez sur l'icône "+", puis sélectionnez "Ajouter un projet depuis Git"
Collez l'URL du plugin Unity d'Edgegap : "https://github.com/edgegap/edgegap-unity-plugin.git"
Sélectionnez "Installer"
Maintenant dans Unity.
Chargez votre projet. Dans notre cas, nous utilisons le projet d'exemple de tank de Mirror Networking qui est déjà configuré pour les serveurs de jeux dédiés. Tout projet configuré pour un serveur dédié fonctionnera avec le plugin d'Edgegap.
La façon la plus simple d'ajouter le plugin d'Edgegap est via le gestionnaire de paquets d'Unity.
Sélectionnez « Fenêtre », puis « Gestion des paquets » et enfin sélectionnez « Gestionnaire de paquets ».
Juste au cas où votre projet aurait déjà une version du plugin d'Edgegap, nous allons d'abord supprimer le plugin actuel pour nous assurer d'avoir la dernière version. Sélectionnez « Gérer » puis « Supprimer ».
Le plugin d'Edgegap est hébergé sur GitHub. Sélectionnez le bouton « Code » et copiez l'URL du projet dans votre presse-papiers.
Dans Unity, sélectionnez l'icône « plus » dans l'onglet Gestionnaire de paquets, puis « Installer le paquet depuis l'URL Git ».
Ensuite, collez l'URL et sélectionnez « Installer ».
Après quelques secondes, le plugin Edgegap sera automatiquement installé. Ouvrez-le simplement sous « Outils ».
Cliquez sur « Se connecter à Edgegap » pour créer un compte Edgegap gratuit. Sélectionnez votre méthode de connexion comme Google ou GitHub et créez votre organisation.
Voici le tableau de bord d'Edgegap que nous vous invitons à explorer, mais pour l'instant, la plateforme vous fournit automatiquement votre jeton OneClick unique. Copiez-le en sélectionnant l'icône du presse-papiers.
Retournez à Unity. Sélectionnez « Valider le jeton ».
L'onglet « Build your Game Server » s'ouvre automatiquement.
Tout d'abord, vous pouvez valider si les dépendances du serveur Linux sont fonctionnelles en sélectionnant « Installer ». Comme nous l'avons fait plus tôt, il affiche « exigences installées ».
Ensuite, nous devons nous assurer que notre scène de jeu est sélectionnée. Sous « Paramètres de construction Unity », sélectionnez « Modifier les paramètres » et sous « Liste des scènes », sélectionnez le bouton « Ajouter les scènes ouvertes ». Ici, comme vous pouvez le voir, nous ajoutons la scène du Tank de Mirror. Supprimez toute scène non pertinente, comme l'exemple par défaut d'Unity ici.
Fermez l'onglet.
Sélectionnez « Build Server » qui compile le serveur de jeu. Après quelques secondes, la build est compilée avec succès.
Sous « Containerize your Server », confirmez que Docker Desktop fonctionne en sélectionnant « Valider ». Sinon, ouvrez Docker.
Nous passerons tous les paramètres optionnels pour ce tutoriel, mais pour les utilisateurs avancés, les détails de leur utilisation sont dans notre documentation.
Avançons et sélectionnons « Containeriser avec Docker ». Après une courte période, la containerisation est réussie.
L'étape suivante consiste à tester notre serveur de jeu localement. Il y a des paramètres supplémentaires optionnels, mais pour cette vidéo, nous allons simplement sélectionner « Déployer le conteneur local ».
Une fois terminé, nous pouvons confirmer qu'il fonctionne localement dans Docker Desktop. Après avoir terminé, terminez le déploiement local.
Pour le rendre accessible en ligne, l'étape suivante consiste à télécharger le serveur de jeu sur la plateforme d'Edgegap.
Assurez-vous que la bonne application est sélectionnée et cliquez sur le bouton « Télécharger l'image et créer une version de l'application ».
Après quelques secondes, un navigateur Web s'ouvre sur la plateforme. Cette page « Créer une version » est pré-remplie, mais vous pouvez configurer les paramètres optionnels, y compris l'utilisation des ressources vCPU, de la mémoire et plus encore, mais nous allons créer une nouvelle version avec les paramètres par défaut.
Faites défiler vers le bas et sélectionnez « Soumettre ».
La fenêtre pop-up « Créer un port » s'ouvre. Ici, assurez-vous que le port par défaut de votre netcode et le type de protocole soient corrects. Pour l'exemple de tank de Mirror, il s'agit de 7777 et UDP. Cela peut être différent avec d'autres netcodes. Assurez-vous donc de revoir la documentation de votre netcode pour le port précis à utiliser.
Cliquez sur « Soumettre ».
De retour dans Unity, nous devons déployer le vrai serveur de jeu containerisé précédemment. Sélectionnez la bonne application et sa version dans la liste.
Enfin, sélectionnez « Déployer sur le cloud » qui déploie automatiquement le serveur de jeu sur la plateforme d'Edgegap.
Après quelques secondes de chargement, votre serveur de jeu est prêt. Félicitations, votre jeu est maintenant en ligne pour que le monde entier puisse y jouer !
Évidemment, testez les choses d'abord. Commencez par sélectionner le déploiement.
Ceci est la page de détails du déploiement de votre serveur de jeu.
Elle inclut beaucoup d'informations, mais pour que nous puissions nous connecter au serveur de jeu, nous allons d'abord faire défiler vers le bas et copier l'URL hôte.
Lancez votre scène de jeu et collez l'« URL Hôte ». Nous ajouterons également le « Port Externe » unique de la page de détails.
Sélectionnez « Client » et comme vous pouvez le voir, nous nous sommes connectés avec succès au serveur de jeu dédié.
Maintenant, tous les projets n'ont pas une interface utilisateur pour entrer l'URL et le port dans la scène. Si c'est le cas, lorsque la scène est arrêtée, sélectionnez « Network Manager ».
Trouvez le champ « Adresse Réseau », dont le nom peut changer en fonction de votre netcode. Ici, remplacez « localhost » par l'URL du serveur de jeu.
Ensuite, trouvez le champ « Port » et remplacez-le également.
Commencez votre scène, et encore une fois nous parvenons à faire rejoindre le client aux serveurs de jeu dédiés.
Une fois que vous avez terminé les tests, assurez-vous de retourner à l'URL « localhost » par défaut de l'éditeur de réseau et du port. Sinon, vous inclurez cette information dans votre futur serveur de jeu si vous générez de nouvelles versions.
Maintenant, le multijoueur a généralement plus d'un joueur. Ce que nous devrons simuler.
ParrelSync est une option ici, mais nous utiliserons le « Play Mode » de Unity. Tout d'abord, sélectionnez « Window », allez dans « Multiplay » et ouvrez le « Centre Multiplay » de Unity.
Nouveau dans la version 6.3, Unity vous demande le genre de jeu et les joueurs. Remplissez les informations exactes pour vous.
Ici, Unity essaie de vous faire télécharger leurs solutions multijoueurs. Dans notre cas, nous changerons le Netcode en « tierce partie » pour éviter d'ajouter accidentellement le Netcode de Unity pour objets de jeu. Nous exclurons également le chat vocal de Unity.
Ce qui est important d'installer, ce sont les « Services Multijoueur » et le « Play Mode Multiplay ». Installez-les.
Assurez-vous que toute scène de jeu est arrêtée, et une fois de plus sélectionnez « Window », puis sous « Multiplay » les deux composants sont maintenant disponibles. Sélectionnez « Play Mode Multiplay ».
Simulez un deuxième joueur en sélectionnant « Joueur 2 ». Unity ouvre une nouvelle fenêtre d'éditeur pour le deuxième joueur. Arrangez vos fenêtres pour que vous puissiez voir les deux joueurs.
Maintenant, la scène de jeu démarre dans les deux fenêtres. Encore une fois, nous rejoindrons le serveur de jeu en tant que clients.
Félicitations, vous avez maintenant deux joueurs jouant à votre jeu en ligne !
C'est tout pour le plugin d'Edgegap pour Unity, qui permet aux développeurs de jeux de disposer d'un serveur de jeu automatisé et d'un hébergement simple.
Le prochain étape probable dans votre développement de jeu sera de démarrer et d'arrêter automatiquement les serveurs, et de connecter les joueurs. Pour plus d'informations sur le matchmaker gratuit, simple et entièrement automatisé d'Edgegap, consultez notre tutoriel.
