Configurer un proxy Velocity pour un réseau Minecraft

Pourquoi créer un réseau de serveurs Minecraft, et comment fonctionne Velocity

Un réseau permet de faire tourner différents modes de jeu côte à côte sous une seule adresse, de donner à chacun ses propres plugins et ressources, et de redémarrer un serveur sans déconnecter tout le monde sur les autres.

Les joueurs se connectent uniquement au proxy. Le proxy les authentifie auprès de Mojang, puis les transfère vers l'un des serveurs backend — des serveurs Paper ordinaires qui hébergent les mondes. Quand un joueur tape /server survival, Velocity le déplace vers un autre backend sans déconnexion.

• Le proxy est léger : il ne contient aucun monde, il a donc besoin de bien moins de mémoire qu'un serveur de jeu.
• Les backends tournent en mode hors ligne et comptent sur le proxy pour leur dire qui est chaque joueur. C'est cette confiance qu'il faut sécuriser.
• Velocity 4, la version actuelle, nécessite Java 25 et fonctionne avec Minecraft de la 1.7.2 jusqu'à la dernière version.

Installer Velocity

1. Téléchargez Velocity depuis papermc.io dans un dossier vide.
2. Lancez-le une première fois avec Java 25 :

java -Xms512M -Xmx512M -jar velocity.jar

Le premier démarrage crée velocity.toml et un fichier forwarding.secret contenant un secret aléatoire. Arrêtez le proxy avec end et ouvrez la configuration.

Configurer velocity.toml

Les paramètres qui comptent pour un premier réseau :

bind = "0.0.0.0:25565"
motd = "<#09add3>My Network"
online-mode = true
player-info-forwarding-mode = "modern"
forwarding-secret-file = "forwarding.secret"

[servers]
lobby = "203.0.113.10:25566"
survival = "203.0.113.11:25567"
try = ["lobby"]

• bind — l'adresse et le port auxquels les joueurs se connectent.
• player-info-forwarding-mode — réglez-le sur modern. La valeur par défaut est none, qui attribue à chaque joueur un UUID hors ligne ; legacy est l'ancien format BungeeCord et n'a d'intérêt que pour les serveurs en 1.12 et antérieurs.
• [servers] — un nom et une adresse pour chaque backend. Le nom est celui que les joueurs utilisent avec /server.
• try — où vont les joueurs à la connexion, et où ils sont envoyés si un backend les expulse.

Les forced hosts, sous [forced-hosts], peuvent envoyer les joueurs vers un backend selon l'adresse saisie — par exemple survival.yourserver.com directement vers le survie.

Configurer les backends Paper pour le forwarding moderne

Sur chaque backend Paper, effectuez trois modifications puis redémarrez :

1. server.properties: online-mode=false — c'est désormais le proxy qui gère l'authentification Mojang.
2. spigot.yml: settings.bungeecord: false.
3. config/paper-global.yml:

proxies:
  velocity:
    enabled: true
    online-mode: true
    secret: 'paste the contents of forwarding.secret here'

Ici, online-mode doit correspondre à velocity.toml, et secret doit être exactement le texte du fichier forwarding.secret du proxy. Le forwarding moderne fonctionne à partir de Minecraft 1.13 ; les serveurs Spigot ne le prennent pas en charge, utilisez donc Paper ou un fork de Paper.

Autres backends : les serveurs Fabric utilisent le mod FabricProxy-Lite avec le même secret, et les serveurs Forge au-delà de 1.20.2 ont besoin de ProxyCompatibleForge. Les plugins BungeeCord ne fonctionnent pas sur Velocity.

Protéger les backends

Un serveur en mode hors ligne accepte n'importe quel pseudo. Ce n'est sûr que si les joueurs ne peuvent pas atteindre les backends sans passer par le proxy.

• Le forwarding moderne est votre principale protection. Un backend Paper avec le forwarding Velocity activé refuse quiconque se connecte directement : sans les données signées du proxy, la connexion est rejetée avec This server requires you to connect with Velocity.
• Gardez le secret secret. Toute personne disposant de forwarding.secret peut se faire passer pour votre proxy. Ne le publiez jamais, et changez-le partout s'il fuite.
• Protégez les backends par un pare-feu quand c'est possible. La documentation de Velocity est claire : le forwarding moderne ne remplace pas un pare-feu. Si le proxy et les backends partagent une machine, liez chaque backend à 127.0.0.1 et déclarez-les sous la forme 127.0.0.1:port.
• Ne faites jamais tourner un backend en mode hors ligne avec le forwarding désactivé. N'importe qui pourrait alors se connecter sous n'importe quel pseudo, y compris celui d'un opérateur.

Faire tourner un réseau Velocity chez HytHost

Chaque partie du réseau est un serveur à part : un pour le proxy et un pour chaque backend. Le proxy a besoin de peu de mémoire, la plus petite offre lui suffit donc ; dimensionnez les backends selon leurs mondes et leurs joueurs sur l'hébergement Minecraft.

1. Transformez un serveur en proxy. Dans son onglet Version, choisissez Velocity. Le panel l'installe et règle bind sur le port propre du serveur. Vérifiez que Java 25 est sélectionné dans l'onglet Startup.
2. Activez vous-même le forwarding moderne. Le panel écrit un velocity.toml de base avec une liste de serveurs vide. Dans le gestionnaire de fichiers, réglez player-info-forwarding-mode = "modern" et ajoutez vos backends sous [servers] avec l'adresse et le port que chacun affiche dans son panel.
3. Configurez chaque backend comme dans la section Paper ci-dessus, avec le forwarding.secret du proxy.
4. Pointez votre domaine vers le proxy et ne donnez aux joueurs que cette adresse.

Chaque backend possède sa propre adresse publique, c'est donc le forwarding moderne qui bloque les connexions directes — ne laissez pas un backend en mode hors ligne avec le forwarding désactivé. Pour les permissions sur tout le réseau, faites tourner LuckPerms sur chaque serveur avec une seule base MySQL partagée ; chaque offre inclut des bases de données.