--- title: "Configurer un proxy Velocity sur un serveur Minecraft - Wiki" description: "Crée un proxy Velocity, active le modern forwarding, saisis l'adresse du backend Paper, copie forwarding.secret, et donne aux joueurs uniquement l'IP du proxy." url: "https://eternyx.fr/wiki/reglages-du-serveur/comment-configurer-un-proxy-velocity-sur-un-serveur-minecraft" lastmod: "2026-09-19T18:21:35.280Z" --- # Configurer un proxy Velocity sur un serveur Minecraft Crée un proxy Velocity, active le modern forwarding, saisis l'adresse du backend Paper, copie forwarding.secret, et donne aux joueurs uniquement l'IP du proxy. [![Skin de l’auteur Tomáš Navrátil](https://visage.surgeplay.com/bust/256/012486e303614e7d8327d890d5cef004) Tomáš Navrátil](https://eternyx.fr/auteur/tomas) 19 septembre 2026 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) 1. Dans Eternyx Dashboard, crée un serveur **Velocity** si tu n’as pas encore de proxy. 2. Dans `velocity.toml`, mets `player-info-forwarding-mode = "modern"`, et sous `[servers]` saisis l’adresse du backend Paper. 3. Copie le secret depuis `forwarding.secret`. Ne colle pas cette valeur dans cet article. 4. Sur Paper, mets `online-mode=false` et active le bloc `proxies.velocity` dans `config/paper-global.yml`. 5. 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](https://eternyx.fr/wiki/eternyx-dashboard/comment-ajouter-un-port-supplementaire-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) : ![Page Software pour choisir Velocity](https://eternyx.fr/_etnx/33a4f52b-55e2-46fd-ad26-7087439adc2e_Z1lrfyJ.webp) ![Carte Velocity sur Software](https://eternyx.fr/_etnx/05bc81a1-eab2-4547-8731-020dac13eedb_ZDhDoh.webp) ## 3. Règle le modern forwarding Ouvre le proxy et l’onglet **Explorateur de fichiers**. À la racine, ouvre `velocity.toml`. ![Racine Explorateur de fichiers avec velocity.toml](https://eternyx.fr/_etnx/c1df3fb0-aecc-4467-88f8-4273e7dffcdb_Z8M27s.webp) 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 : 1. Arrête le serveur (**Arrêter**). 2. Dans `server.properties`, mets `online-mode=false`. 3. Dans `config/paper-global.yml`, active le bloc `proxies.velocity` et colle le même secret. ![Arrêter avant d'éditer online-mode](https://eternyx.fr/_etnx/90bcb022-93ec-40e2-bb83-439d92aee3ee_292FBY.webp) ![online-mode false dans server.properties](https://eternyx.fr/_etnx/0701e5a8-766e-4d16-8d52-2cb596329a88_18lUej.webp) Puis démarre le backend et le proxy. Les joueurs n’obtiennent que l’adresse du proxy (copie depuis la carte **ADRESSE IP**) : ![Carte ADRESSE IP pour le proxy](https://eternyx.fr/_etnx/ce68b055-4e3f-4020-8764-e119e10f9733_Z2ubssw.webp) 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](https://eternyx.fr/wiki/eternyx-dashboard/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. [Retour à Réglages du serveur](https://eternyx.fr/wiki/reglages-du-serveur)