Comment créer un réseau Velocity

Un réseau avec proxy regroupe plusieurs serveurs Minecraft derrière une seule adresse. Les joueurs se connectent au proxy, arrivent dans un lobby et peuvent passer sur d'autres serveurs, comme la survie ou des mini-jeux, sans se déconnecter. Ce guide explique une installation de base avec Velocity et des serveurs Paper.

Comment fonctionne un réseau

Le proxy est le seul serveur auquel les joueurs se connectent. Derrière lui tournent les serveurs backend, chacun étant un serveur Paper normal avec son propre monde et ses propres plugins, par exemple un lobby et un serveur survie. Le proxy gère les connexions et envoie chaque joueur vers un backend. Velocity est le proxy moderne et activement développé de l'équipe de Paper. BungeeCord est l'ancien proxy, et Waterfall en était un fork qui n'est plus maintenu. Velocity est le choix habituel pour les nouveaux réseaux.

Configurer velocity.toml

Lance Velocity une fois pour créer velocity.toml. Règle l'adresse à laquelle les joueurs se connectent avec bind (port 25565 par défaut), puis liste tes serveurs backend :

[servers]
lobby = "127.0.0.1:30066"
survival = "127.0.0.1:30067"
try = ["lobby"]

Chaque nom pointe vers l'adresse et le port d'un backend. La liste try est l'ordre des serveurs vers lesquels un joueur est envoyé quand il se connecte ou quand le serveur sur lequel il se trouve tombe.

Le modern forwarding

Les backends doivent connaître le vrai pseudo, l'UUID et le skin de chaque joueur. Velocity les transmet avec le modern forwarding, sécurisé par un secret partagé. Dans velocity.toml, mets :

player-info-forwarding-mode = "modern"

Velocity enregistre le secret dans un fichier à côté de sa config, généralement forwarding.secret. Copie cette valeur. Ensuite, sur chaque backend Paper, ouvre le fichier de config global de Paper (paper-global.yml dans le dossier config) et, dans la section Velocity sous proxies, mets enabled: true, online-mode: true et secret: à la même valeur. Laisse désactivée l'option BungeeCord de spigot.yml, car c'est une autre méthode de forwarding.

Des backends en offline mode, derrière un pare-feu

Comme c'est le proxy qui vérifie les comptes, le server.properties de chaque backend doit contenir online-mode=false. Ce n'est sûr que si les joueurs ne peuvent pas joindre les backends directement. Sinon, n'importe qui pourrait se connecter au port d'un backend avec n'importe quel pseudo, y compris celui d'un admin.

• Fais tourner les backends sur des ports que seul le proxy peut joindre. Lie-les à 127.0.0.1 s'ils sont sur la même machine, ou bloque leurs ports dans le pare-feu sauf depuis l'IP du proxy.
• Le modern forwarding avec un secret ajoute une couche de protection, car le backend refuse les connexions qui n'ont pas le bon secret.
• Garde le secret privé, et change-le s'il fuite un jour.

Les votes et l'inscription de ton réseau

Pour les récompenses de vote sur un réseau, installe NuVotifier sur le proxy et utilise son forwarding pour envoyer chaque vote aux serveurs backend, comme expliqué dans comment configurer Votifier. Teste-le avec notre testeur Votifier. Quand tu inscris le réseau sur CraftRank, utilise l'adresse du proxy, et vérifie-la depuis l'extérieur avec notre vérificateur de statut de serveur. Les joueurs qui passent par Geyser peuvent aussi rejoindre un réseau Velocity : installe Geyser et Floodgate sur le proxy, comme expliqué dans le guide du crossplay.