Relier plusieurs serveurs Minecraft (Bungeecord/Velocity)

Un proxy (Velocity, Waterfall ou BungeeCord) relie plusieurs serveurs Minecraft sous une seule adresse IP. Les joueurs se connectent au proxy et basculent entre les serveurs (lobby, survie, créatif) sans se déconnecter. Velocity est l’option moderne recommandée.

Cause / Le problème

Sans proxy, chaque serveur a sa propre IP et les joueurs doivent se déconnecter/reconnecter pour passer de l’un à l’autre, en perdant inventaire et statut. Un proxy unifie tout mais nécessite une authentification sécurisée entre le proxy et les serveurs backend pour éviter l’usurpation.

Solution

1. Préparez vos serveurs : 1 proxy + au moins 2 serveurs backend (ex. lobby, survie). Tous doivent tourner sur Paper/Spigot (backend) ; le proxy est Velocity, Waterfall ou BungeeCord.
2. Sur chaque backend, passez en online-mode=false dans server.properties : c’est le proxy qui gère l’authentification Mojang.

   online-mode=false

3. Pour Velocity, activez le forwarding moderne dans paper-global.yml de chaque backend :

   proxies:
     velocity:
       enabled: true
       secret: 'une-chaine-secrete-longue'
       online-mode: true

4. Configurez le proxy dans velocity.toml :

   player-info-forwarding-mode = "modern"
   forwarding-secret-file = "forwarding.secret"

   Velocity génère automatiquement un forwarding.secret — recopiez son contenu dans paper-global.yml des backends (les deux doivent être identiques).
5. Déclarez vos serveurs dans velocity.toml :

   [servers]
   lobby = "127.0.0.1:25566"
   survie = "127.0.0.1:25567"
   creatif = "127.0.0.1:25568"

6. Firewall : exposez uniquement le port du proxy (25565). Les backends ne doivent être joignables que par le proxy — sinon un attaquant peut contourner l’authentification.
7. Pour BungeeCord, utilisez plutôt ip_forward: true dans config.yml et installez BungeeGuard pour sécuriser (le forwarding legacy de BungeeCord est faible).
8. Testez : connectez-vous au proxy, tapez /server survie (avec le plugin SlashServer ou via Velocity commands).

Le forwarding moderne avec secret est ce qui empêche quiconque de lancer un faux proxy et d’envoyer de fausses données joueur aux backends. Ne réutilisez jamais le même secret entre serveurs différents.