Plugin de mise en réseau de miroir - Hébergement de serveur de jeu automatisé - Tutoriel Unity

Nous allons couvrir comment configurer le netcode gratuit et open source de Mirror Networking en combinaison avec l'hébergement d'Edgegap dans votre projet pour déployer et héberger un serveur de jeu automatisé directement depuis l'éditeur de Unity. Pour que votre jeu soit en ligne et jouable, partout dans le monde, en quelques secondes.

Allons-y.

Chapitre 1 : Configuration

Avant d'utiliser le plugin, il y a trois exigences pour s'assurer que tout fonctionne.

Tout d'abord, assurez-vous d'utiliser le dernier plugin Mirror. Il peut être téléchargé directement depuis le magasin d'actifs Unity. Un lien direct se trouve dans la description.

Une fois installé et importé depuis le magasin, accédez à Mirror en sélectionnant “Fenêtre” dans le menu supérieur, puis sélectionnez “Gestionnaire de paquets.” Ensuite, dans le menu déroulant, sélectionnez “Mes actifs” pour trouver le plugin Mirror. Pour les nouveaux utilisateurs, nous recommandons fortement de regarder les incroyables tutoriels de la communauté pour utiliser Mirror à son plein potentiel.

Deuxièmement, dans Unity, allez dans le Hub d’Unity pour confirmer que vous avez installé le module “Support de construction de serveur dédié Linux” dans votre projet. Sinon, cliquez simplement sur le paquet et installez-le.

La troisième et dernière exigence est d'installer et d'exécuter Docker. Cela conteneurise vos serveurs de jeu pour aider à les déployer et à les faire fonctionner plus rapidement. Si vous ne l'avez pas encore fait, vous pouvez regarder notre vidéo d'installation de Docker, ou vous rendre sur Docket dot com et suivre la procédure d'installation. C'est facile et cela ne prend que quelques minutes. 

Maintenant, commençons !

Chapitre 2 : Mirror Networking

Chargez votre projet. Dans notre cas, nous utilisons le projet d'exemple de tank de Mirror Networking qui est déjà configuré pour des serveurs de jeu dédiés.

Pour s'assurer que cela fonctionne sans problème, sélectionnez l'objet de jeu “Gestionnaire de réseau” dans la scène du plugin Mirror et dans l'inspecteur de composants, confirmez que les trois configurations, à savoir “Ne pas détruire au chargement”, “Exécuter en arrière-plan” et “Démarrer automatiquement la construction du serveur” sont activées.

De plus, si vous avez différentes scènes selon que le joueur est hors ligne ou en ligne, vous pouvez faire glisser et déposer des scènes depuis vos actifs vers la section appropriée “Gestion de scène”. Cela garantit une transition automatique entre les serveurs en ligne hébergés et le jeu hors ligne.

Enfin, notez que l’“Adresse réseau” doit être actuellement définie sur “Hôte local”. Cela sera échangé pour l'adresse d'hébergement plus tard après le déploiement du serveur de jeu Edgegap. De même, la valeur de port de la “Configuration de transport” est probablement définie sur un état interne par défaut tel que 7777 qui devra également être mise à jour.

Chapitre 3 : Plugin Edgegap

Le plugin Edgegap devrait être inclus dans le dernier package Mirror. Pour l'utiliser, sélectionnez l'option “Outil” de la barre de navigation, puis sélectionnez “Hébergement Edgegap”, ce qui ouvrira la fenêtre du plugin.

Pour fonctionner, vous devrez générer un jeton.

Pour ce faire, vous devez créer un compte Edgegap. Cliquez sur le bouton “Obtenir un jeton” qui ouvrira votre navigateur.

S'inscrire est gratuit et prend quelques secondes seulement. Tout d'abord, sélectionnez “Commencer” en bas, puis à partir de l'écran de connexion, saisissez votre e-mail et un mot de passe et optez pour nos conditions. Vous recevrez ensuite un e-mail de vérification instantanément. Cliquez sur “Confirmer votre e-mail” pour valider votre compte. Enfin, saisissez le nom de votre organisation et confirmez.   

Ceci est le tableau de bord de l'application Edgegap. Nous recommandons vivement de l'explorer avec la visite, mais nous allons le sauter pour cette vidéo. Automatiquement, un pop-up avec votre unique Jeton OneClick apparaît. Copiez-le simplement en cliquant sur l'icône du presse-papiers et collez-le directement dans la zone de texte du plugin.

Ensuite, sélectionnez vérifier, ce qui confirme que le jeton est valide. L'onglet “Informations sur l'application” s'ouvre maintenant automatiquement.

Si vous avez déjà une application sur notre plateforme, saisissez son nom dans la zone de texte et chargez-la en tant qu'application existante. Sinon, ce qui est le cas dans ce tutoriel, il vous suffit de saisir le nom de votre projet. Il doit être en minuscules, sans espaces.

Le bouton “Créer une application” est maintenant activé. Sélectionnez-le. Cela ouvre les onglets “Registre de conteneurs” et “Déploiement”.

Le registre de conteneurs est l'endroit où le conteneur de votre serveur de jeu est stocké. Tout ce que vous avez à faire est de vous assurer que le port et les types de protocoles sont précis par rapport aux transports de votre netcode pour garantir que le serveur écoute correctement la connexion.

Cette information peut être trouvée dans l'onglet inspecteur du gestionnaire de réseau. Voici le port du projet d'exemple de Mirror Network, trouvé sous “Configuration de transport”. Quant au Type de Protocole, il est précis dans ce cas car ce projet d'exemple particulier de Mirror utilise UDP. Si vous n'êtes pas sûr, référez-vous à la documentation de votre netcode pour confirmer quel transport il utilise ou sélectionnez l'option appropriée en fonction de votre choix unique.  

“Nouvelle étiquette de version” fait référence à la version unique de votre serveur. Ce champ nécessite votre saisie manuelle. Nous recommandons de changer la valeur chaque fois que vous procédez à des mises à jour de votre serveur de jeu.

Pour les utilisateurs avancés, Edgegap propose l'option d'utiliser un “Registre de conteneurs personnalisé”. Pour ce tutoriel, nous allons utiliser celui par défaut d'Edgegap.

L'avant-dernière étape consiste à sélectionner “Construire et Pousser”. Cela compile automatiquement le projet en un serveur Linux dédié, puis crée un conteneur Docker qui est déployé dans le registre d'Edgegap.

La dernière étape consiste à créer un nouveau déploiement. Sous “Statut”, vous verrez son avancement. Une fois prêt, une URL apparaît. Copiez-la en cliquant sur le bouton du presse-papiers, puis collez les informations dans l'onglet inspecteur du gestionnaire de réseau. Sous “Informations sur le réseau”, remplacez l’“Adresse réseau” actuelle en collant l'URL. Assurez-vous de supprimer la valeur du port, qui doit être saisie dans le champ “Port” sous la section “Configuration de transport”.

Désélectionnez l'option “Démarrer automatiquement la construction du serveur”, car cela vous permet de vous connecter en tant que client directement depuis l'éditeur de Unity.

Enfin, commencez votre scène de jeu en cliquant sur le bouton de lecture en haut de l'éditeur.

Félicitations, votre jeu est maintenant en ligne pour que le monde puisse y jouer !

Chapitre 4 : Test

Évidemment, testez d'abord les choses. Dans notre cas, en utilisant le projet d'exemple de Mirror, nous confirmons que l'adresse du client est correcte et pouvons lancer une session en sélectionnant “Client”.

Une fois que vous avez terminé les tests, retournez au plugin Edgegap pour arrêter automatiquement l'instance du serveur en sélectionnant “Arrêter le serveur”.

C'est tout pour le plugin Mirror sur Unity utilisant le serveur de jeu et l'hébergement Edgegap.

La prochaine étape probable dans votre développement de jeu sera de connecter des joueurs. Pour plus d'informations sur le logiciel de matchmaking gratuit, simple et totalement automatisé d'Edgegap, vous pouvez consulter notre tutoriel.

Merci d'avoir regardé !