Velocity est un proxy moderne. Les joueurs se connectent à une seule adresse. Le proxy les envoie vers un lobby ou un backend. Il remplace souvent BungeeCord.

Le backend reste un serveur Minecraft complet (Paper, Purpur, Fabric) avec son propre monde et ses plugins. Velocity ne fait pas tourner de monde. Il ne fait que forwarder les joueurs. Le monde tourne sur le backend. Sans au moins une instance derrière le proxy, les joueurs n’ont nulle part où aller.

Configuration Velocity (aperçu rapide)

Dans Eternyx Dashboard, crée un serveur Velocity si tu n’as pas encore de proxy.
Dans velocity.toml, mets player-info-forwarding-mode = "modern", et sous [servers] saisis l’adresse du backend Paper.
Copie le secret depuis forwarding.secret. Ne colle pas cette valeur dans cet article.
Sur Paper, mets online-mode=false et active le bloc proxies.velocity dans config/paper-global.yml.
Les joueurs tapent uniquement l’IP du proxy. Ne leur envoie pas l’adresse du backend.

1. As-tu vraiment besoin d’un proxy

Velocity a du sens quand une de ces conditions est vraie :

plusieurs mondes de jeu comme serveurs séparés (lobby + survie + minijeux)
les joueurs doivent avoir une seule IP et changer de mode à l’intérieur
les backends tournent sur des versions Minecraft différentes

Un seul Paper avec un monde n’a pas besoin de proxy. Connecte les joueurs directement à ce serveur.

Démarre d’abord le backend. Chacun a ses propres plugins, monde et port. Velocity n’est que l’entrée.

Si plusieurs services partagent la même machine, règle un second port ici : Ajouter un port supplémentaire sur un serveur Minecraft dans Eternyx Dashboard.

2. Crée un serveur Velocity

Si tu as déjà un proxy, saute l’assistant de création et va à velocity.toml.

Pour un nouveau proxy, dans l’assistant Créer un serveur choisis Minecraft, le package PROXY, et sous Software choisis Velocity. Laisse une version stable, nomme-le (par exemple proxy), et confirme. Puis clique sur Démarrer. Au premier démarrage Velocity crée velocity.toml et forwarding.secret.

Sur un serveur existant tu peux aussi passer le type à Velocity sur la page Software (ça écrase le fork actuel, donc fais une sauvegarde d’abord) :

3. Règle le modern forwarding

Ouvre le proxy et l’onglet Explorateur de fichiers. À la racine, ouvre velocity.toml.

Trouve player-info-forwarding-mode et mets :

player-info-forwarding-mode = "modern"

modern est le forwarding officiel Velocity pour les clients Minecraft 1.13+. Enregistre le fichier.

Dans le même fichier se trouve la section [servers]. Chaque clé est un nom de backend, la valeur est host:port :

[servers]
lobby = "game01.eternyx.cz:8040"
try = ["lobby"]

La liste try est l’ordre de première tentative. Enregistre le fichier.

4. Secret de forwarding et Paper

Ouvre forwarding.secret à la racine du proxy et copie la valeur. Ne la colle pas dans cet article.

Sur le backend Paper :

Arrête le serveur (Arrêter).
Dans server.properties, mets online-mode=false.
Dans config/paper-global.yml, active le bloc proxies.velocity et colle le même secret.

Puis démarre le backend et le proxy. Les joueurs n’obtiennent que l’adresse du proxy (copie depuis la carte ADRESSE IP) :

Vérifie aussi Java sur le proxy sous Paramètres → Docker images. Velocity demande souvent Java 21 : Comment changer la version Java sur un serveur Minecraft dans Eternyx Dashboard.

Problèmes fréquents

Les joueurs vont sur l’IP du backend

Donne seulement l’IP du proxy. N’expose pas le port du backend publiquement.

Unable to verify player details / invalid forwarding

Le secret ne correspond pas, ou Paper n’a pas proxies.velocity activé. Recopie la valeur depuis forwarding.secret, enregistre, et redémarre les deux serveurs.

Le proxy tourne, mais il n’y a nulle part où aller

Le backend est arrêté ou l’adresse dans [servers] est fausse. Démarre Paper d’abord et vérifie la paire host:port.

Configurer un proxy Velocity sur un serveur Minecraft