Monter un réseau de serveurs avec Velocity
14 septembre 2026 · mis à jour le 07 octobre 2026 · 2 min de lecture
Un réseau, c'est plusieurs serveurs Minecraft derrière une seule adresse. Les joueurs se connectent à un proxy, qui les envoie vers le lobby, puis vers le jeu de leur choix, sans jamais se déconnecter. Velocity est aujourd'hui le proxy recommandé : plus rapide et plus sûr que BungeeCord, maintenu par l'équipe de Paper.
L'architecture
- Velocity écoute sur le port public 25565 et vérifie les comptes (
online-mode = true). - Chaque serveur Paper écoute sur un port local (25566, 25567…) et n'accepte que le proxy.
- Les informations du joueur (pseudo, UUID, skin) voyagent du proxy aux serveurs, signées par un secret partagé.
Installation pas à pas
- Téléchargez Velocity et lancez-le une première fois : il crée
velocity.tomletforwarding.secret. - Dans
velocity.toml:
bind = "0.0.0.0:25565"
online-mode = true
player-info-forwarding-mode = "modern"
[servers]
lobby = "127.0.0.1:25566"
survie = "127.0.0.1:25567"
try = ["lobby"]
- Sur chaque serveur Paper, dans
config/paper-global.yml:
proxies:
velocity:
enabled: true
online-mode: true
secret: "le contenu de forwarding.secret"
- Toujours sur chaque serveur, dans
server.properties:online-mode=false(c'est le proxy qui vérifie),server-portdifférent, etserver-ip=127.0.0.1si tout tourne sur la même machine.
La règle de sécurité à ne jamais oublier
Un serveur en
online-mode=falsejoignable directement, c'est un serveur où n'importe qui se connecte sous le pseudo de votre administrateur.
Les serveurs derrière le proxy ne doivent jamais être accessibles depuis Internet : écoute sur 127.0.0.1, ou pare-feu qui n'autorise que l'adresse du proxy. Le générateur de server.properties signale ce montage dangereux.
Les plugins, où les mettre ?
- Sur le proxy : ce qui concerne tout le réseau, liste d'amis, messages privés entre serveurs, anti-bot, Geyser pour Bedrock.
- Sur chaque serveur : le gameplay, protections, économie, mini-jeux.
- LuckPerms sur tous, reliés à la même base de données MySQL/MariaDB : les grades suivent le joueur d'un serveur à l'autre.
Performances
Velocity est léger : 1 à 2 Go suffisent pour plusieurs centaines de joueurs. Utilisez les flags recommandés pour le proxy (l'outil flags de démarrage les donne), et coupez la compression sur les serveurs derrière lui (network-compression-threshold=-1) s'ils sont sur la même machine : le proxy compresse déjà.