Configurer Velocity comme proxy Minecraft

Configurer Velocity comme proxy Minecraft multi-serveurs

Velocity est un proxy moderne pour relier plusieurs serveurs Minecraft (lobby, survie, minigames) derrière une seule adresse IP. Plus performant et sécurisé que BungeeCord legacy, il convient aux réseaux hébergés chez Anthony IT Solutions avec plusieurs instances Minecraft.

Différence avec le guide BungeeCord : Velocity utilise le forwarding moderne (Player Info Forwarding) et une architecture async optimisée pour Paper 1.13+.

Prérequis

• Au minimum 2 serveurs Minecraft (1 proxy + 1 backend, idéalement 3+)
• Egg Velocity ou installation jar proxy sur instance dédiée
• Même écosystème : Paper recommandé en backend
• Ports ouverts : 25565 (proxy public), ports internes backend (25566, 25567…)

Étape 1 : préparer le proxy Velocity

1. Commandez une instance avec egg Velocity ou Bungeecord selon panel
2. Notez le port public du proxy (ex. 25565)
3. Générez une clé forwarding : fichier forwarding.secret (chaîne aléatoire longue)
4. Configurez velocity.toml :
   • bind = "0.0.0.0:25565"
   • online-mode = true (mode premium Mojang)
   • player-info-forwarding-mode = "modern"
   • forwarding-secret-file = "forwarding.secret"

Étape 2 : déclarer les serveurs backend

Dans velocity.toml, section [servers] :

lobby = "127.0.0.1:25566"
survie = "127.0.0.1:25567"
minigames = "127.0.0.1:25568"
try = ["lobby"]

Si les backends sont sur d'autres machines, remplacez 127.0.0.1 par l'IP interne ou publique de chaque serveur.

Étape 3 : configurer Paper (backend)

Sur chaque serveur backend Paper :

1. Éditez config/paper-global.yml (ou paper.yml selon version)
2. Section proxies :
   • velocity.enabled: true
   • velocity.online-mode: true
   • velocity.secret: "MÊME_SECRET_QUE_forwarding.secret"
3. settings.bungeecord: false, ne pas mélanger BungeeCord et Velocity
4. Redémarrez chaque backend

Étape 4 : plugins proxy (lobby)

• MiniMessage / Adventure, messages modernes
• LuckPerms Velocity, permissions globales réseau
• MiniMOTD ou équivalent, MOTD et favicon
• Server switcher, NPC ou GUI pour /server survie

Commandes et bascule

• /server <nom>, bascule vers backend défini dans velocity.toml
• /glist, liste joueurs (plugin Velocity ou Paper)
• Maintenance : retirez un backend du try list ou utilisez un plugin maintenance

Sécurité forwarding

• Firewall : autorisez 25565 public, backend en IP interne ou whitelist
• Sans forwarding correct, les UUID/skin peuvent être spoofés

Performances réseau

• Proxy léger : 512 Mo-1 Go RAM suffisent
• Allouez la RAM aux backends selon charge, optimisation TPS
• Colocalisez proxy + backends même datacenter (Equinix PA5) pour latence minimale

Dépannage

• « Unable to connect to server », backend offline ou mauvais port dans velocity.toml
• UUID différent entre serveurs, forwarding mal configuré, secret différent
• « If you wish to use IP forwarding… », velocity.enabled manquant sur Paper
• Boucle de connexion, try list pointe vers serveur down

Questions fréquentes

Velocity ou BungeeCord ?
Velocity est recommandé pour nouveaux projets Paper 1.13+. Voir aussi BungeeCord/Velocity.

Un seul serveur suffit-il ?
Non, un proxy nécessite au moins un backend supplémentaire.

Guides liés

• Réseau BungeeCord/Velocity
• Multiverse multi-mondes
• Ports & firewall

Hébergement Minecraft · Wiki jeux