Laisse les joueurs Bedrock rejoindre ton serveur Java : configurer Geyser + Floodgate (Paper, Velocity)

Ce que font Geyser et Floodgate

Geyser traduit entre les deux éditions. Vis-à-vis de ton serveur, il se comporte comme un client Java, donc la redstone, les fermes et les plugins fonctionnent exactement comme pour les joueurs Java. Floodgate permet aux joueurs Bedrock de se connecter avec leur compte Xbox au lieu d’un compte Java.

Avant de commencer : Java et versions

• Geyser a besoin de Java 21 ou plus récent sur la machine qui le fait tourner.
• Ton serveur doit accepter la version Java la plus récente, car Geyser imite un tel client. Les serveurs plus anciens ont besoin de ViaVersion.
• Geyser-Spigot tourne sur Paper et Spigot à partir de la 1.20.5. Les serveurs plus anciens ont besoin d’un proxy, de Geyser Standalone ou de ViaProxy.
• Seules les versions Bedrock actuelles sont prises en charge (octobre 2026 : Bedrock 26.30 à 26.52, Java 26.2). Garde Geyser à jour, car Bedrock se met à jour tout seul.

Télécharge Geyser et Floodgate pour ta plateforme sur la page de téléchargement officielle de GeyserMC.

Installation sur un seul serveur Paper ou Spigot

1. Mets Geyser-Spigot.jar et Floodgate-Spigot.jar dans le dossier plugins.
2. Redémarre le serveur. Geyser crée plugins/Geyser-Spigot/config.yml, Floodgate crée plugins/floodgate/ avec un config.yml et un key.pem.
3. Ouvre la config de Geyser et vérifie la section bedrock. Le port est ce que les joueurs Bedrock vont taper.
4. Règle le type d’authentification sur floodgate et redémarre encore une fois.

bedrock:
  address: 0.0.0.0
  port: 19132
  clone-remote-port: false

java:
  auth-type: floodgate

Les anciennes configs de Geyser appellent la deuxième section remote, le réglage s’écrit donc remote.auth-type. Les builds actuels passent d’eux-mêmes sur Floodgate quand il tourne sur le même serveur ; le définir ne fait pas de mal.

Sur un serveur seul, ne copie key.pem nulle part. Geyser le lit depuis Floodgate, et une copie oubliée dans le dossier de Geyser provoque des erreurs de connexion.

Ouvre le port Bedrock en UDP

Java utilise TCP, Bedrock utilise UDP. La plupart des installations cassées échouent ici.

• Panel d’hébergement : ajoute un port supplémentaire (beaucoup d’hébergeurs appellent ça une allocation) et indique-le comme bedrock.port. Certains hébergeurs exigent que Bedrock utilise le même port que Java ou changent le port Java à chaque démarrage ; dans ce cas, clone-remote-port: true fait utiliser le port Java à Geyser. La page d’installation de Geyser contient des instructions pour de nombreux hébergeurs.
• Pterodactyl : attribue le port au serveur dans l’onglet Network.
• Ta propre machine ou un VPS : ouvre le port en UDP dans le pare-feu et, à la maison, dans ta box. OVH et Oracle Cloud bloquent aussi l’UDP dans leur propre pare-feu.

sudo ufw allow 19132/udp
sudo ufw reload

Les plugins de chat vocal ou le query ne peuvent pas partager le port avec Geyser. Une fois le port ouvert, lance geyser connectiontest <ip> <port> dans la console ; la commande vérifie le port et propose des solutions.

Installation sur un réseau Velocity ou BungeeCord

Sur un réseau, les joueurs Bedrock se connectent au proxy comme les joueurs Java. Geyser tourne donc uniquement sur le proxy.

1. Installe Geyser et Floodgate pour ton proxy (Velocity ou BungeeCord) et redémarre le proxy.
2. Règle bedrock.port et le type d’authentification floodgate dans la config de Geyser sur le proxy, et ouvre le port en UDP comme décrit plus haut.
3. Installe Floodgate-Spigot sur chaque backend. Il est nécessaire pour les plugins qui utilisent l’API Floodgate et améliore les skins.
4. Configure le forwarding : sur BungeeCord, mets ip_forward: true dans son config.yml et bungeecord: true dans le spigot.yml de chaque backend ; sur Velocity, configure le forwarding des infos joueur comme indiqué dans la doc de Velocity.
5. Dans la config de Floodgate sur le proxy, mets send-floodgate-data: true.
6. Copie key.pem du dossier Floodgate du proxy vers le dossier Floodgate de chaque serveur backend, puis redémarre les backends et le proxy.

send-floodgate-data: true

Garde key.pem secret : il permet à des comptes de passer outre l’authentification Java. Envoie-le par FTP en mode binaire, sinon tu obtiens des erreurs Tag mismatch.

Noms Bedrock : le préfixe point

Floodgate ajoute un préfixe devant chaque nom Bedrock pour qu’il ne puisse jamais entrer en conflit avec un nom Java. Par défaut, c’est un point : le gamertag Xbox Steve devient .Steve sur ton serveur. Les espaces dans les gamertags sont remplacés par _.

username-prefix: "."
replace-spaces: true

• Dans les commandes, utilise le nom complet avec le préfixe. Si une commande ne l’accepte pas, mets le nom entre guillemets : /tp ".Steve".
• Pour la whitelist, utilise fwhitelist add Steve. Le préfixe n’y est pas nécessaire.
• Si LuckPerms a du mal avec les noms Bedrock, mets allow-invalid-usernames: true dans sa config.

GeyserMC conseille de garder le préfixe. Les joueurs Bedrock votent aussi avec ce nom : sur BestMCServerList, ils entrent .Steve, le nom que voit ton plugin de récompenses de vote.

Comptes liés et skins (facultatif)

Le Global Linking est activé par défaut dans Floodgate. Les joueurs qui possèdent les deux éditions rejoignent link.geysermc.org avec leurs deux comptes et tapent /linkaccount. Ensuite, ils jouent avec leur inventaire et leur position Java depuis n’importe quel appareil, ils doivent donc d’abord déplacer leurs objets Bedrock. Une base de liaison locale nécessite une extension Floodgate supplémentaire.

Floodgate convertit et envoie les skins Bedrock pour que les joueurs Java les voient. Ça passe par une file d’attente et peut prendre un moment.

Erreurs fréquentes et solutions

Certaines choses ne peuvent pas être traduites : les clics gauche et droit dans les inventaires se ressemblent, les commandes sans Brigadier n’ont pas d’autocomplétion, les liens dans le chat ne sont pas cliquables. Teste tes menus avec un vrai appareil Bedrock. Les plugins peuvent afficher des formulaires Bedrock natifs via l’API Floodgate, ce qui nécessite Floodgate sur leur serveur.

Affiche les deux adresses sur BestMCServerList

Les joueurs Bedrock se connectent avec ton adresse plus le port Bedrock, par exemple play.example.net et 19132. BestMCServerList affiche séparément l’adresse Java et l’adresse Bedrock sur chaque page de serveur, chacune avec un bouton de copie.

1. Ouvre Ajouter ton serveur et entre ton adresse Java.
2. Coche Les joueurs Bedrock sont pris en charge.
3. Entre le port Bedrock de bedrock.port. Laisse l’IP Bedrock vide si c’est la même que l’adresse Java.

Le crossplay est un vrai atout pour un nouveau serveur. Lis comment trouver des joueurs pour un nouveau serveur pour la suite du plan.