Installer Geyser et Floodgate pour vos joueurs Bedrock

Geyser permet aux joueurs Bedrock sur téléphone, tablette, console et Windows de rejoindre votre serveur Java en traduisant entre les deux éditions, et Floodgate les laisse entrer sans compte Java. Installez les deux sur votre serveur Paper ou sur votre proxy Velocity, réglez transport de Geyser sur both, ouvrez le port Bedrock en TCP et en UDP, puis vérifiez depuis l'extérieur de votre réseau qu'un joueur Bedrock peut vraiment entrer.

Cette dernière étape est celle que la plupart des propriétaires sautent. Notre pinger envoie chaque minute un ping Bedrock à chaque fiche crossplay qui publie une adresse Bedrock. Au cours des 30 derniers jours, 21 des 93 fiches jouables sur Java n'ont jamais répondu à un seul de ces pings, et seules 52 ont répondu au moins 90 % du temps. Quand nous avons écrit ce guide, le 18 octobre 2026, cela faisait 94 fiches, dont 20 n'ont jamais répondu sur Bedrock et 53 répondaient de façon fiable. Le propriétaire d'un crossplay en panne n'en sait généralement rien, parce que personne sur Java ne s'en aperçoit.

Une date compte en ce moment. Bedrock 26.60 est prévu pour le 27 octobre 2026, et à partir de cette version, les clients Bedrock ne se connectent plus en RakNet, le transport que Geyser utilise encore par défaut. L'annonce NetherNet de GeyserMC est sans détour : après cette date, les joueurs Bedrock ne pourront plus rejoindre les serveurs qui n'ont pas fait le changement. Chaque étape ci-dessous inclut déjà ce changement.

Comment fonctionnent Geyser et Floodgate

Geyser se place entre le client Bedrock et votre serveur Java. Il accepte la connexion Bedrock, ouvre une connexion Java au nom du joueur et traduit tout ce qui passe entre les deux : chunks, entités, inventaires, tchat, sons. Votre serveur voit un client Java de plus. Comme Geyser imite le client Java actuel, votre serveur doit accepter cette version, soit Java 26.3 au moment de l'écriture. Un serveur plus ancien a besoin de ViaVersion pour accepter le client plus récent.

Floodgate règle le problème des comptes. Un joueur Bedrock a un compte Microsoft et un gamertag Xbox, pas de profil Java, et un serveur normal en mode en ligne le refuserait. Avec Floodgate, Geyser se porte garant du joueur grâce à un fichier de clé partagé nommé key.pem, et Floodgate l'admet sous une identité Java générée : le gamertag précédé d'un préfixe (un point par défaut, donc .Steve) et un UUID construit à partir de son identifiant d'utilisateur Xbox, de la forme 00000000-0000-0000-xxxx-xxxxxxxxxxxx.

Petite parenthèse : comme cet UUID vient de l'identifiant d'utilisateur Xbox, un joueur Bedrock qui change de gamertag garde son inventaire et ses permissions. Les plugins qui enregistrent les joueurs par pseudo seront moins indulgents.

Ce que change NetherNet

NetherNet est le nouveau transport de Bedrock, construit sur WebRTC. Un client envoie d'abord une petite requête web en TCP pour demander comment se connecter, une étape appelée signaling, et ne joue qu'ensuite en UDP. Le signaling transporte aussi le MOTD et le nombre de joueurs qu'affiche la liste de serveurs de Bedrock. C'est pourquoi un port Bedrock qui n'avait jamais besoin que d'UDP a maintenant aussi besoin de TCP, et pourquoi votre serveur peut disparaître de la liste de serveurs Bedrock des joueurs alors que le port de jeu est grand ouvert. Les clients à partir de la 26.40 peuvent utiliser NetherNet, pleinement à partir de la 26.50, et à partir de la 26.60 ils y sont obligés. Geyser le gère depuis le build 1237, mais RakNet reste son réglage par défaut.

Plugin, proxy ou autonome : quelle installation

Sur un réseau, Geyser va sur le proxy et nulle part ailleurs. Les joueurs Bedrock se connectent au proxy comme tout le monde, et le proxy les déplace d'un backend à l'autre.

Installer sur Paper

Vérifié avec la documentation de GeyserMC pour un serveur Paper 26.3. Purpur et les autres forks de Paper suivent les mêmes étapes.

1. Vérifiez que le serveur accepte les clients Java 26.3. S'il tourne sur une version plus ancienne, installez d'abord ViaVersion.

2. Téléchargez Geyser-Spigot et Floodgate-Spigot sur geysermc.org/download, placez les deux JAR dans plugins, démarrez le serveur une fois pour qu'ils créent leurs dossiers, puis arrêtez-le.

3. Ouvrez plugins/Geyser-Spigot/config.yml et réglez la section Bedrock :

   bedrock:
     address: 0.0.0.0
     port: 19132
     transport: both
     webrtc-port: 19134

4. Dans le même fichier, réglez auth-type: floodgate. Il se trouve dans la section consacrée au serveur Java, que les builds actuels appellent java: et les anciens remote:.

5. Ouvrez les ports comme décrit plus bas, démarrez le serveur et lisez la console. Geyser affiche les ports qu'il a ouverts et nomme la plupart des problèmes de NetherNet en termes clairs.

Pourquoi both et pas nethernet ? NetherNet seul suffit pour les clients actuels. both laisse aussi entrer les joueurs encore en 26.30 à 26.34, qui ne parlent que RakNet, sert les clients 26.40 qui lisent encore le MOTD en RakNet, et garde actif l'écouteur RakNet de Geyser, celui auquel parle notre vérification Bedrock (plus de détails dans « Vérifier depuis l'extérieur »). Le coût est un port UDP supplémentaire : webrtc-port doit être libre et différent de port, et 19134 n'est qu'un exemple. GeyserMC conseille lui-même de passer à nethernet et de fermer le port RakNet une fois la 26.60 sortie et vos joueurs à jour.

Installer sur Velocity

1. Assurez-vous que Velocity et chaque backend acceptent les clients Java 26.3. Geyser rejoint le proxy comme un client Java de cette version, et Velocity transmet la version, donc un backend obsolète sans ViaVersion est un backend que les joueurs Bedrock ne peuvent pas atteindre.
2. Placez Geyser-Velocity et Floodgate-Velocity dans le dossier plugins du proxy, démarrez Velocity une fois, puis arrêtez-le.
3. Configurez plugins/Geyser-Velocity/config.yml exactement comme dans l'exemple Paper, y compris auth-type: floodgate.
4. Ouvrez les ports Bedrock sur la machine du proxy, pas sur les backends.
5. Gardez le modern forwarding tel que vous l'utilisez déjà : player-info-forwarding-mode = "modern" dans velocity.toml, et sur chaque backend proxies.velocity.enabled: true dans config/paper-global.yml avec le secret du fichier forwarding.secret de Velocity.

Les commandes propres à Geyser, comme /geyser version et /geyser dump, s'exécutent sur le proxy : accordez donc leurs permissions à cet endroit, par exemple avec LuckPerms pour Velocity.

Floodgate sur les backends

Floodgate n'a besoin d'être que sur le proxy. Ajoutez-le aux backends quand un plugin de backend a besoin de l'API Floodgate, par exemple pour ouvrir des formulaires Bedrock natifs ou pour vérifier si un joueur est sur Bedrock.

1. Installez Floodgate-Spigot sur chaque backend.
2. Dans la config Floodgate du proxy, réglez send-floodgate-data: true.
3. Copiez key.pem du dossier Floodgate du proxy dans le dossier Floodgate de chaque backend.
4. Redémarrez les backends, puis le proxy.

Traitez key.pem comme un mot de passe. Quiconque le détient peut contourner l'authentification Java pour n'importe quel compte Bedrock sur votre serveur, donc il ne doit jamais se retrouver dans un dépôt public, une capture d'écran envoyée au support ou un pack de plugins partagé.

Ports : 19132 en TCP et UDP, et votre hébergeur

Le port par défaut de Bedrock est le 19132. Avec NetherNet et le signaling intégré de Geyser, le port de Geyser doit être ouvert en TCP et en UDP, il ne peut donc plus partager son numéro avec votre port Java, qui occupe déjà le TCP. Avec transport: both, le webrtc-port a aussi besoin d'UDP.

• Box internet, routeur ou VPS. Redirigez le port de Geyser en TCP et en UDP (beaucoup de routeurs appellent cela « Both ») et le webrtc-port en UDP. Ouvrez ensuite les mêmes ports dans le pare-feu du système. Avec ufw, cela donne sudo ufw allow 19132 (les deux protocoles) et sudo ufw allow 19134/udp.
• Docker. Publiez chaque protocole explicitement : 19132:19132/tcp, 19132:19132/udp et 19134:19134/udp. Un simple 19132:19132 ne publie que le TCP.
• Oracle Cloud. Ouvrez les ports dans la liste de sécurité du cloud et dans le pare-feu de l'instance elle-même. L'un des deux seul ne suffit pas.
• OVH et SoYouStart. La page de GeyserMC sur la redirection de ports signale que les règles Bedrock du pare-feu GAME ne gèrent pas encore NetherNet. Utilisez la règle Other pour les ports de Geyser.
• Hébergeurs de jeux avec un seul port. L'ancienne astuce, clone-remote-port, réutilisait le numéro de votre port Java pour Bedrock en UDP. Elle ne fonctionne pas avec le signaling intégré, parce que le signaling a besoin du TCP sur ce port et que votre serveur Java l'occupe déjà. Geyser se rabat alors tout seul sur Warden, un service de signaling externe gratuit exploité par Ziax, l'entreprise derrière CubeCraft. Avec Warden, seul l'UDP est nécessaire de votre côté, mais les joueurs rejoignent avec l'adresse et le port que Geyser affiche dans la console, sauf si vous enregistrez un domaine personnalisé sur Warden. Demandez un second port à votre hébergeur, ou vérifiez s'il configure déjà Geyser avec des options de démarrage.
• Tunnels. ngrok ne tunnelise que le TCP, il ne peut donc pas transporter le jeu Bedrock. Le guide playit.gg de GeyserMC a été écrit pour RakNet et renvoie vers la page d'état NetherNet de playit : vérifiez-la avant de vous appuyer sur un tunnel.

Les ports personnalisés posent plus de problèmes dans nos données. Parmi les fiches avec un port Bedrock autre que celui par défaut, 6 sur 18 n'ont jamais répondu à un ping Bedrock au cours des 30 derniers jours, contre 15 sur 75 pour celles sur le 19132 (au 18 octobre 2026 : 6 sur 18, contre 14 sur 76). L'échantillon est petit, mais un port personnalisé est un numéro de plus à régler correctement à deux endroits.

Le signaling intégré de Geyser utilise du HTTP simple par défaut, donc à la première connexion, Bedrock demande à chaque joueur s'il fait confiance au serveur. Pointer le réglage certificate de la partie HTTPS de la config de signaling de Geyser vers un certificat TLS supprime cette demande, et Warden gère le HTTPS pour vous.

Les pseudos Floodgate et vos plugins

Un joueur Bedrock nommé Steve arrive sous le nom .Steve, et ce point atteint tous les plugins que vous faites tourner.

• Le préfixe. C'est le réglage username-prefix de la config de Floodgate, "." par défaut. Floodgate recommande un préfixe sans lettres ni chiffres, pour qu'aucun pseudo Bedrock ne puisse entrer en collision avec un pseudo Java. Évitez * : les commandes pourraient alors exiger le pseudo entre guillemets.
• Les espaces. Les gamertags peuvent contenir des espaces, les pseudos Java non. Avec replace-spaces: true (le réglage par défaut), Cool Steve devient .Cool_Steve.
• LuckPerms. Réglez allow-invalid-usernames: true dans la config de LuckPerms pour que les pseudos avec un point soient acceptés, ou ciblez les joueurs par UUID.
• Whitelist. /whitelist add demande un profil Java à Mojang et échoue pour les joueurs Bedrock. Utilisez plutôt /fwhitelist add Steve (le préfixe est facultatif) ou l'UUID Floodgate du joueur. La permission est floodgate.command.fwhitelist.
• Failed to verify username sur Paper. Paper rejette les pseudos qu'il juge invalides. Installer Floodgate sur le backend atténue le problème, et la page des problèmes connus de Floodgate donne la solution complète : réglez perform-username-validation sur false sous unsupported-settings dans config/paper-global.yml.
• Joueurs avec les deux éditions. La liaison globale (global linking), activée par défaut, permet à un joueur de lier une seule fois ses comptes Java et Bedrock, puis d'arriver avec son identité Java sur chaque serveur où il est activé.
• Votes. Votifier transmet un pseudo, et les plugins de récompenses paient le joueur, en ligne ou hors ligne, dont le pseudo correspond. Un joueur Bedrock doit voter en tant que .Steve, pas Steve, sinon la récompense ne va nulle part. Notre formulaire de vote reconnaît les préfixes Floodgate courants, vérifie le pseudo auprès des comptes Bedrock et le transmet tel qu'il a été saisi. Au cours des 30 derniers jours, 6 % de tous les votes sur serverlist.net ont été émis pour des pseudos Bedrock, et 97 % d'entre eux portaient le point par défaut (6 % et 97 % au 18 octobre 2026). Si vous avez changé le préfixe, dites-le dans votre message /vote. Le guide NuVotifier couvre le reste du parcours d'un vote.

Les joueurs Bedrock ne peuvent pas cliquer sur les liens dans le tchat, une limite que Geyser ne peut pas corriger. Un message de vote qui dit seulement « cliquez ici » ne sert à rien pour eux. Affichez l'adresse de vote en texte brut, assez courte pour être tapée sur un téléphone.

Vérifier depuis l'extérieur

Rejoindre depuis votre propre téléphone sur votre propre Wi-Fi ne prouve presque rien, car le téléphone peut atteindre le serveur par votre réseau local sans jamais toucher aux règles de routeur que vous venez d'écrire. Vérifiez comme le ferait un inconnu.

1. Coupez le Wi-Fi sur un téléphone, ajoutez le serveur dans Bedrock avec l'adresse et le port publics, puis rejoignez-le en données mobiles. Le guide pour rejoindre un serveur sur Bedrock montre le côté joueur de cette étape.

2. Passez l'adresse et le port Bedrock dans l'outil de statut d'un serveur, qui les vérifie une fois depuis chez nous :

   Vérifier un serveur maintenant

   JavaBedrockJava et Bedrock

   Adresse du serveur

   L’adresse que les joueurs tapent dans Multijoueur. Les mentions comme IP: et les espaces sont retirées.

   Port facultatif

   VérifierPing en coursVérifiéNon vérifié

   La réponse s’affiche ici sous la forme de la ligne que vous verriez dans Multijoueur, avec les joueurs, la version et le ping.

3. Ajoutez votre serveur ou modifiez votre fiche, activez « Les joueurs Bedrock peuvent aussi rejoindre » et saisissez l'adresse et le port Bedrock. À partir de là, notre pinger vérifie le port Bedrock chaque minute, et la mention Bedrock sur votre fiche ainsi que votre place dans la liste de serveurs Bedrock viennent de ces réponses, pas de l'interrupteur.

4. Recommencez après chaque mise à jour de Geyser et chaque version de Bedrock. Un build de Geyser trop ancien pour une nouvelle version de Bedrock explique souvent que des joueurs Bedrock se retrouvent soudain bloqués un jour de mise à jour.

Une précision sur notre façon de vérifier, parce qu'elle influe sur ce que vous voyez. Notre ping Bedrock est le ping RakNet que les clients Bedrock utilisaient avant NetherNet. Geyser en mode both y répond, Geyser en mode nethernet non. Tant que notre vérification ne parle pas aussi NetherNet, un serveur en nethernet seul apparaît ici comme ne répondant pas sur Bedrock, même quand des joueurs Bedrock peuvent le rejoindre, donc both est pour l'instant le réglage qui garde exacte la mention Bedrock de votre fiche. Notre méthode de mesure est détaillée sur la page de méthodologie.

Voici comment les fiches se répartissent par plateforme en ce moment :

• Java uniquementAucune adresse Bedrock sur la fiche367 % des joueurs
• Bedrock répondPublie une adresse Bedrock qui a répondu à notre ping Bedrock7290 % des joueurs
• Bedrock muetPublie une adresse Bedrock qui n’a jamais répondu213 % des joueurs

Sur 129 serveurs jouables, 72 ont aussi répondu sur Bedrock et 21 publient une adresse Bedrock qui n’a jamais répondu.

Mesuré le 19 oct. 2026, 23:05 UTCComment nous mesurons

Ce qui manquera aux joueurs Bedrock

Geyser ne peut pas modifier le client Bedrock. GeyserMC tient à jour une page des limitations actuelles, et voici les éléments de cette page qui comptent le plus souvent sur un serveur typique :

• Les liens cliquables dans le tchat. Ils ne fonctionnent pas sur Bedrock, ce qui touche les liens de vote, les liens de boutique et les invitations Discord.
• Les clics gauche et droit dans les menus d'inventaire. Bedrock ne sait pas les distinguer, donc les interfaces de coffre qui font des choses différentes selon le clic cessent de fonctionner. Les formulaires Floodgate sont l'alternative native de Bedrock.
• Les enchantements personnalisés ne s'affichent pas, et les niveaux hors vanilla comme « Toucher de soie 2 » ne peuvent pas être montrés.
• Les arguments de commande et l'autocomplétion ne fonctionnent que pour les commandes enregistrées à la manière moderne (Brigadier).
• L'effet Surbrillance, et les bannières de plus de six couches.

Deux limites liées ne figurent pas sur cette page. Les packs de ressources Java ne se chargent pas sur Bedrock, donc Geyser doit envoyer un pack Bedrock à la place, et les objets personnalisés ont besoin d'un mapping Geyser avant que les joueurs Bedrock ne les voient correctement. Le GeyserIntegratedPack fourni avec Geyser corrige quelques manques à lui, comme les animations de la main secondaire et les poses des porte-armures.

Le combat est aussi différent. Bedrock n'a pas de délai de recharge d'attaque à lui, donc Geyser dessine un indicateur de remplacement, sur le viseur par défaut (l'option cooldown-type de la section gameplay, appelée show-cooldown dans les anciennes configs), et les joueurs sur écran tactile visent autrement que ceux à la souris. Si votre serveur est construit autour du timing du PvP Java, dites-le sur votre fiche.

Mettez-le en avant sur votre fiche

Une configuration Bedrock qui marche est gâchée si les joueurs ne peuvent ni la voir ni la saisir.

• L'adresse et le port dans des champs séparés. Bedrock ne lit pas les enregistrements SRV, donc les joueurs saisissent le port à la main. Mettez le port dans le champ du port, pas après deux-points dans l'adresse. Si Geyser s'est rabattu sur Warden, utilisez l'adresse que Geyser affiche. Si Geyser partageait auparavant votre port Java, votre port Bedrock a changé : mettez la fiche à jour et dites aux joueurs de modifier leur serveur enregistré.
• Dites ce que les joueurs Bedrock obtiennent. Une ou deux lignes dans votre description : le préfixe qu'ils verront, les menus ou mini-jeux qui ne marchent pas sur Bedrock, et comment voter avec leur pseudo. Le guide de la description de serveur montre où cela s'insère.
• Indiquez la plage de versions. « Bedrock 26.50 et versions suivantes » en dit plus à un joueur que « crossplay ».
• Les joueurs sur console ont besoin de plus d'aide. Les téléphones et Windows peuvent ajouter n'importe quel serveur, mais les joueurs Xbox, PlayStation et Switch ont besoin de solutions de contournement tierces, donc une adresse Bedrock seule ne les atteint pas.

Le point de vue du joueur sur tout cela se trouve dans Peut-on jouer ensemble sur Minecraft Java et Bedrock ?

Tableau de dépannage

Quand le tableau ne suffit plus, /geyser dump produit un rapport de débogage que demande le support de GeyserMC. Une fois Bedrock fonctionnel, la tâche suivante est de s'assurer que les votes des deux éditions arrivent, ce que le guide d'installation de NuVotifier détaille pas à pas.