Comment construire un réseau Minecraft avec Velocity ou BungeeCord

Un proxy permet aux joueurs de rejoindre une seule adresse et de passer d’un serveur Minecraft à l’autre, comme un lobby, un monde survie et un serveur de mini-jeux. Le proxy lui-même n’a pas de monde. Les joueurs se connectent à lui, et il les transmet aux serveurs placés derrière, appelés serveurs backend.

Sur PlayNHost, chaque serveur backend et le proxy sont des serveurs distincts, chacun avec sa propre offre et sa propre adresse. Les instances ne peuvent pas les remplacer, car une seule instance d’un serveur tourne à la fois. Voir Comment utiliser les instances pour passer d’un monde à l’autre.

Quel proxy choisir

Ce guide utilise Velocity avec des serveurs Paper derrière. BungeeCord et Waterfall sont traités à la fin. Les trois apparaissent comme types de serveur sous Proxies dans Modifier le type de serveur. Voir Les types de serveur Minecraft expliqués.

Avant de commencer

• Commandez ou configurez le serveur proxy et au moins deux serveurs backend. Mettez-les au même emplacement, pour que les joueurs n’attendent pas à cause de longs sauts entre eux. Voir Où tourne votre serveur et comment fonctionne l’emplacement.
• Les serveurs backend doivent tourner sous Paper ou un fork de Paper comme Purpur. Le forwarding sécurisé de Velocity se règle dans les paramètres de Paper.
• Les joueurs ne reçoivent jamais que l’Adresse du serveur du proxy. Gardez les adresses des backends pour vous.

Le principal point faible de cette configuration. Chaque serveur PlayNHost a sa propre adresse : un joueur qui apprend l’adresse d’un backend pourrait donc essayer de le rejoindre directement et sauter le proxy. Le forwarding sécurisé avec le secret empêche une connexion directe de fonctionner : gardez donc le secret privé et ne publiez jamais l’adresse d’un backend. Voir le premier point de « Ce qui piège les gens » plus bas.

• La version de chaque serveur backend doit être une version que le proxy et vos joueurs peuvent utiliser. Les joueurs rejoignent le proxy : leur version du jeu doit donc correspondre à ce que les backends acceptent.

Étape 1 : démarrer le proxy et copier son secret

1. Configurez un serveur de type Velocity. Il ne demande pas de choix de version. Démarrez-le une fois, puis arrêtez-le. Il crée son fichier de paramètres, velocity.toml, et un fichier de secret, forwarding.secret.
2. Ouvrez Files sur le proxy et ouvrez forwarding.secret. Copiez le texte qu’il contient. C’est un mot de passe pour votre réseau. Ne le partagez pas, ne le mettez pas dans un ticket et ne donnez de backup à personne.

Étape 2 : configurer chaque serveur backend

Faites-le sur chaque serveur Paper qui sera derrière le proxy.

1. Démarrez le serveur une fois pour que ses fichiers de paramètres existent, puis arrêtez-le.
2. Ouvrez Paramètres, puis Server Properties (Java). Désactivez Mode en ligne et cliquez sur Enregistrer seulement. La documentation de Velocity l’exige sur chaque serveur backend, car c’est le proxy qui fait la vérification de connexion à la place.

3. Ouvrez Paramètres, puis Paper's Global Settings. Cette page existe sur Paper 1.19 et plus récent. Les anciennes versions de Paper gardent ces paramètres dans un autre fichier (paper.yml) et n’ont pas cette page : mettez-les d’abord à jour ou ouvrez un ticket. Utilisez la zone de recherche pour trouver ces trois paramètres sous proxies.velocity, changez-les, et cliquez sur Enregistrer seulement :

   • enabled : activez-le.
   • online-mode : il doit correspondre à online-mode dans le velocity.toml du proxy. Il est activé sauf si vous l’avez changé.
   • secret : collez le texte que vous avez copié depuis forwarding.secret.
4. Démarrez le serveur.

Désactiver le Mode en ligne n’est sûr que derrière un proxy qui transmet les joueurs de façon sécurisée, ce que ces étapes mettent en place. Un serveur backend avec le Mode en ligne désactivé et sans forwarding laisse n’importe qui se connecter sous n’importe quel nom, y compris le vôtre. Voir Comment rejoindre votre serveur Minecraft.

Étape 3 : indiquer les backends au proxy

1. Sur le proxy, ouvrez Paramètres, puis Velocity Settings. Réglez player-info-forwarding-mode sur MODERN. Cliquez sur Enregistrer seulement.
2. Dans la section servers de velocity.toml, donnez à chaque backend un nom et son adresse sous la forme host:port. Velocity s’y connecte directement : aucun joueur n’a donc à la saisir. Commencez par l’Adresse du serveur affichée sur la page Aperçu de ce backend. Nous ne pouvons pas promettre qu’un proxy peut toujours joindre un backend avec cette adresse, car le panel décrit cette entrée comme une adresse interne plutôt que celle que les joueurs utilisent. Si le proxy ne peut pas joindre un backend (les joueurs sont renvoyés ou expulsés, et la Console du proxy affiche une erreur de connexion), ouvrez un ticket, choisissez le proxy sous Quel serveur ?, nommez le serveur backend dans le message, et demandez quelle adresse le proxy doit utiliser.
3. Dans la même section, try contient les noms des serveurs sur lesquels les joueurs arrivent en premier, dans l’ordre. Velocity utilise le suivant si le premier est en panne. Mettez votre lobby en premier.
4. Démarrez le proxy.

La page de paramètres ne modifie que les entrées qui existent déjà dans le fichier. Pour ajouter un nouveau backend, arrêtez le proxy, ouvrez velocity.toml dans Files, ajoutez une ligne sous la section servers, enregistrez, et redémarrez le proxy.

Se connecter et tester

1. Démarrez chaque serveur backend et attendez qu’il indique En ligne.
2. Démarrez le proxy.
3. Dans Minecraft Java Edition, connectez-vous avec l’Adresse du serveur du proxy. Vous devriez arriver sur le premier serveur de la liste try.
4. En jeu, tapez /server et le nom d’un autre backend pour y aller. Sur Velocity, un nom de la section servers fonctionne.
5. Si un joueur apparaît avec le mauvais nom, un autre UUID ou sans skin, le forwarding ne fonctionne pas. Vérifiez que le même secret est sur le proxy et sur chaque backend, et que player-info-forwarding-mode vaut MODERN.

Pour savoir lire la Console du proxy et ce que montrent ses filtres, voir Comment utiliser la console et lancer des commandes.

Ce qui piège les gens

• Les serveurs backend sont joignables par leur propre adresse. Les joueurs qui connaissent l’adresse d’un backend pourraient essayer de le rejoindre directement. Le guide de sécurité de Velocity dit qu’un pare-feu est le premier choix et que le forwarding moderne ne le remplace pas. Avec le forwarding moderne et le secret en place, un backend n’accepte pas de joueurs sauf si les données portent le secret. Gardez le secret privé et ne publiez pas les adresses des backends. Si vous avez besoin d’un accès plus strict, ouvrez un ticket et demandez ce qui est possible.
• Mauvais secret. Un backend qui a un secret différent rejette la connexion, et le joueur est renvoyé sur le premier serveur ou expulsé. Copiez à nouveau le secret.
• Limites de joueurs. Le nombre de joueurs affiché par le proxy n’est qu’un chiffre. Chaque backend applique toujours les slots de joueurs de sa propre offre. Voir Comment renommer votre serveur et changer les slots de joueurs.
• Whitelist, ops et bannissements sont stockés sur chaque serveur backend. Réglez-les sur chaque backend, ou utilisez un plugin de permissions qui couvre tout le réseau. Voir Comment configurer une whitelist et bannir des joueurs.
• Les plugins du proxy sont différents des plugins de Paper. Dans Modding, puis Plugins, un proxy n’affiche que des plugins de proxy. Voir Comment installer des plugins sur Paper, Spigot et Purpur.
• Les serveurs backend avec mods demandent des étapes supplémentaires qui dépendent du loader de mods. Ouvrez un ticket si vous voulez en essayer un.
• Les joueurs Bedrock peuvent se connecter via Geyser sur le proxy. Voir Comment permettre aux joueurs Bedrock de rejoindre votre serveur Java avec Geyser.

BungeeCord et Waterfall

La configuration est la même dans les grandes lignes, avec des paramètres différents.

1. Démarrez le proxy une fois. Ses paramètres se trouvent dans Paramètres, puis Proxy Settings, qui est le fichier config.yml.
2. Ajoutez les backends sous les entrées servers sous la forme host:port, et listez-les dans priorities sous listeners. La question de l’adresse de l’étape 3 s’applique aussi ici. Activez ip_forward pour que les joueurs gardent leur vraie identité.
3. Sur chaque backend, désactivez le Mode en ligne, et dans Paramètres, Spigot Settings, activez bungeecord sous settings. Le panel décrit ce paramètre comme sûr uniquement si le serveur ne peut pas être joint directement. Comme chaque serveur PlayNHost a sa propre adresse, le forwarding de BungeeCord offre une protection bien plus faible que celui de Velocity, et c’est une bonne raison de choisir Velocity pour un nouveau réseau.

Si vous ne pouvez pas décider, choisissez Velocity.

À lire aussi

• Problèmes de serveur Minecraft et solutions
• Comment trouver et changer les ports et l’adresse IP de votre serveur