Comment installer GeyserMC et Floodgate pour le crossplay Java & Bedrock

Votre serveur Minecraft tourne en Java, mais vos joueurs jouent sur mobile, sur console ou sur Windows avec l'édition Bedrock ? GeyserMC règle ce problème : ce plugin les laisse rejoindre votre serveur Java, avec Floodgate en option pour qu'ils n'aient pas besoin d'un compte Java payant. L'installation tient en quelques étapes sur Paper, mais il faut savoir où placer les fichiers, quels ports ouvrir et quoi régler depuis la sortie de Bedrock 26.60. Voici le guide complet, pas à pas.

Ce qu'il faut retenir

• Geyser fait entrer les joueurs Bedrock (mobile, Windows, console) sur un serveur Java, et Floodgate leur évite d'avoir besoin d'un compte Java payant.
• Sur Paper, tout se joue dans le dossier plugins : deux fichiers .jar, puis la configuration dans plugins/Geyser-Spigot/config.yml, puis un redémarrage complet.
• Le port Geyser (19132 par défaut) doit être libre, différent du port Java et ouvert en TCP et en UDP : sans le TCP, le serveur n'apparaît même pas côté Bedrock.
• Avec Bedrock 26.60, NetherNet devient obligatoire pour que les joueurs Bedrock puissent entrer : réglez-le vous-même plutôt que de compter sur la valeur par défaut, qui dépend du build.

Qu'est-ce que GeyserMC, et à quoi sert Floodgate ?

Geyser est un traducteur de protocole : il émule un client Java, donc votre serveur traite les joueurs Bedrock comme des joueurs Java, avec la même redstone, les mêmes commandes et les mêmes fermes. Il ne fonctionne que dans un sens, de Bedrock vers Java. Floodgate est un second plugin, facultatif : il permet aux joueurs Bedrock de se connecter avec leur seul compte Microsoft, sans acheter Minecraft Java.

Geyser suit la dernière version de Minecraft Java, et les versions plus anciennes passent par ViaVersion. Un serveur modé (Forge, Fabric, NeoForge) n'est pris en charge que si les mods n'ajoutent ni blocs ni objets : la règle de la documentation est simple, si un client Java vanilla peut se connecter, Geyser le peut aussi.

Si vous gérez un serveur survie ou un mini-jeux ouvert aux deux éditions, c'est la solution la plus simple pour rassembler tout le monde sur un seul monde. Les deux outils sont maintenus par la même équipe, avec une documentation officielle qui sert de référence ici.

Que faut-il préparer avant d'installer ?

Pour Java, la documentation de Paper reste la référence : elle précise la version requise pour chaque version de Minecraft. Si vous êtes chez un hébergeur, vérifiez d'abord qu'il ne configure pas Geyser à votre place. Certains le font déjà, et l'équipe de Geyser a retiré sa liste d'hébergeurs compatibles pour la remplacer par une liste de ceux qui le configurent automatiquement.

Comment installer Geyser et Floodgate sur Paper ?

1. Téléchargez Geyser (plateforme Spigot, fichier Geyser-Spigot.jar) et Floodgate (plateforme Spigot) depuis la page de téléchargement officielle. Les mêmes fichiers servent pour Paper, Purpur et Spigot, et il faut toujours prendre le dernier build.
2. Copiez les deux fichiers .jar dans le dossier plugins du serveur, à côté de votre paper.jar.
3. Démarrez le serveur et laissez-le charger, puis arrêtez-le. Geyser crée le dossier plugins/Geyser-Spigot/, et Floodgate crée plugins/floodgate/ avec son fichier key.pem.
4. Ouvrez plugins/Geyser-Spigot/config.yml et réglez les deux sections ci-dessous.
5. Ouvrez le port Bedrock en TCP et en UDP (voir la section sur les ports).
6. Redémarrez le serveur, puis tapez plugins dans la console : Geyser-Spigot et floodgate doivent apparaître comme actifs. La commande geyser version affiche la version installée et vérifie les mises à jour.

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

java:
  auth-type: floodgate

• address: 0.0.0.0 : Geyser écoute sur toutes les interfaces. Une adresse de bouclage comme 127.0.0.1 est refusée.
• port: 19132 : le port Bedrock. N'importe quel port libre convient, sauf celui du serveur Java.
• clone-remote-port: false : Geyser ne copie pas le port Java. Cette option ne fonctionne plus avec la signalisation intégrée (voir plus bas).
• transport: nethernet : active le nouveau protocole.
• auth-type: floodgate : les joueurs Bedrock passent par Floodgate. Sur d'anciennes versions de Geyser, ce réglage se trouve sous la section remote au lieu de java.

Ne touchez pas à l'adresse et au port Java : sur un plugin, la valeur auto laisse Geyser les détecter, et il retrouve aussi tout seul la clé de Floodgate quand les deux plugins sont sur le même serveur. Si la console se plaint de la clé, vérifiez que floodgate-key-file pointe vers key.pem. Et gardez ce fichier pour vous : il permet à un compte Bedrock de contourner l'authentification Java, donc ne le partagez avec personne.

Et si vous n'êtes pas sous Paper ?

Sur Fabric et NeoForge, le serveur doit être en 26.3, et seuls les mods côté serveur fonctionnent : un mod que les joueurs doivent installer chez eux ne passera pas. Sur Velocity et BungeeCord, Geyser ne s'installe que sur le proxy, et tous les serveurs du réseau doivent accepter les clients Java 26.3. Floodgate n'a besoin d'être que sur le proxy, sauf si vous voulez son API sur les serveurs de jeu, et l'installer là permet aussi d'afficher correctement les skins Bedrock. La page Floodgate détaille le partage de key.pem vers les serveurs de jeu.

La version autonome demande Java 21 ou plus récent et tourne à côté de votre serveur Java, ce qui la rend utile quand on ne peut pas installer de plugin. Dans la section java de sa configuration, indiquez l'adresse du serveur (127.0.0.1 par défaut), son port (25565 par défaut) et auth-type. Pour qu'elle accepte Floodgate, installez Floodgate sur le serveur Java, mettez auth-type: floodgate et copiez key.pem dans le dossier de Geyser Standalone.

Pourquoi NetherNet change-t-il tout cet automne ?

NetherNet est le nouveau transport que Mojang déploie depuis Bedrock 26.40 : avant de jouer, le client envoie une requête web en TCP (la signalisation) pour savoir comment se connecter, puis la partie passe en UDP via WebRTC. D'après l'article de l'équipe Geyser du 8 octobre, Bedrock 26.60 cesse de se connecter en RakNet, et un serveur qui n'a pas fait le changement refuse les joueurs Bedrock. La 26.60 est sortie le 27 octobre : le journal des modifications de Mojang précise que les serveurs dédiés Bedrock qui n'utilisent pas NetherNet affichent désormais une erreur au lieu d'un simple avertissement, RakNet étant déprécié.

Côté Geyser, la page de téléchargement du 27 octobre liste Bedrock 26.40 à 26.60 pour le dernier build : les joueurs sur des versions plus anciennes ne peuvent plus entrer avec ce build, ce qui ajoute une raison de mettre le plugin à jour. NetherNet n'est pas toujours activé par défaut selon les builds, d'où le réglage explicite transport: nethernet plus haut.

Le mode both accepte NetherNet et RakNet en même temps. La documentation officielle indique que NetherNet est pleinement pris en charge à partir de la 26.50, et que certaines versions plus anciennes, comme la 26.40, récupèrent le message du serveur et le nombre de joueurs en RakNet. Il sert donc surtout à ces joueurs-là, et Bedrock se met en général à jour de lui-même :

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

Le port webrtc-port doit être un port UDP libre et différent de port, car RakNet et NetherNet ne peuvent pas partager le même port UDP. Une fois que tout le monde a mis à jour, repassez sur nethernet et fermez le port RakNet.

Si votre serveur est derrière un NAT ou dans un conteneur, indiquez à Geyser l'adresse publique à donner aux joueurs, dans la section signaling, bloc builtin :

bedrock:
  signaling:
    mode: builtin
    builtin:
      advertise-addresses:
        - "VOTRE_IP_PUBLIQUE:19132"

Sans port, Geyser utilise le port NetherNet. Si le port public diffère du port interne (UDP 20132 redirigé vers 19132, par exemple), annoncez le port public. La redirection elle-même n'est jamais configurée automatiquement. La propriété de démarrage -DgeyserAdvertiseAddresses fait la même chose, mais elle écrase le fichier : si vos modifications semblent ignorées, regardez d'abord la commande de lancement. Selon SetupMC, gardez aussi le dossier nethernet créé à côté de la configuration : le supprimer peut obliger vos joueurs à reconfirmer le serveur.

Un dernier cas concerne ceux qui faisaient partager à Geyser le port du serveur Java avec clone-remote-port: true. Cela ne fonctionne plus avec la signalisation intégrée, puisque le Java occupe déjà ce port en TCP : il faut un port séparé, et vos joueurs doivent corriger le port dans leur entrée de serveur enregistrée. L'autre voie est une signalisation externe, et Geyser bascule alors tout seul sur Warden quand il détecte le conflit. Les joueurs rejoignent alors avec l'adresse et le port affichés dans la console, plus avec l'adresse du serveur Java.

Quels ports faut-il ouvrir ?

Sur un VPS Linux avec UFW, les deux commandes à passer sont ufw allow 19132/tcp et ufw allow 19132/udp. N'oubliez pas le pare-feu du fournisseur et la redirection de ports de votre box si vous hébergez chez vous. Dans un conteneur Docker, publiez 19132:19132/tcp et 19132:19132/udp en plus de votre port Java. Sur un panneau d'hébergeur, demandez ou créez un port supplémentaire ouvert en TCP et en UDP : l'hébergeur doit désormais fournir un port TCP en plus de l'UDP.

Aucun autre programme ne doit utiliser le port Geyser, ni en TCP ni en UDP : le chat vocal, la requête Query et les cartes web sont les conflits les plus courants. Si vous ne pouvez pas ouvrir de port chez vous, la documentation propose un tunnel playit.gg, et précise que Ngrok ne marche pas faute de prise en charge de l'UDP. Son guide principal vise RakNet, donc consultez la page dédiée à NetherNet avant de vous lancer.

Comment tester la connexion ?

1. Testez d'abord depuis l'intérieur. Sur la même machine que le serveur, entrez localhost dans Bedrock. Sur le même réseau local, utilisez l'adresse IPv4 locale du serveur, qui commence par 10. ou 192.168.
2. Depuis une machine extérieure à votre réseau, lancez curl --fail --max-time 10 http://VOTRE_IP_PUBLIQUE:19132/v1/join. Si le serveur répond par un JSON, la signalisation fonctionne. Un délai dépassé ou une erreur 404 pointe vers un souci de port ou de routage.
3. Dans Bedrock, ouvrez Jouer, Serveurs, puis Ajouter un serveur. Saisissez l'adresse, et le port dans le champ Port prévu (jamais collé à l'adresse).
4. Rejoignez depuis un autre réseau, par exemple en partage de connexion d'un téléphone : la signalisation peut réussir alors que le jeu en UDP reste bloqué.
5. Regardez la console du serveur : Geyser y affiche les erreurs et les avertissements liés à NetherNet. En cas de blocage, la commande geyser dump produit un rapport à joindre à votre demande d'aide sur le Discord de GeyserMC.

Les joueurs Bedrock arrivent avec un préfixe de pseudo, un point par défaut, et leurs espaces sont remplacés par des tirets bas : un joueur « Alex Dupont » devient .Alex_Dupont. Ces réglages se trouvent dans plugins/floodgate/config.yml (username-prefix et replace-spaces). Retenez-les, car vos plugins de permissions, d'économie ou de bannissement voient ce pseudo-là. Vider le préfixe expose à des collisions avec des pseudos Java.

Quelles erreurs bloquent le plus souvent les joueurs ?

Ce que Bedrock ne fera pas comme Java

• Les mods installés côté client ne fonctionnent pas pour les joueurs Bedrock.
• Bedrock ne distingue pas le clic gauche du clic droit dans les inventaires, ce qui casse certains menus de plugins.
• Les packs de ressources Java ne sont pas convertis automatiquement en packs Bedrock, et les liens cliquables du chat ne sont pas traduits.
• Le changement d'objet en main secondaire passe par une commande ou par un réglage optionnel de Geyser.
• Les consoles (Xbox, PlayStation, Switch) ne permettent souvent pas de saisir une adresse de serveur : il faut passer par une solution comme BedrockConnect, un sujet à part qui n'est pas lié à votre installation de Geyser.

Notre avis : si votre serveur tourne déjà avec Geyser, ne repoussez pas le passage à NetherNet : mettez à jour le plugin, réglez transport et testez avec un vrai client Bedrock dès aujourd'hui : vos joueurs mobiles qui mettent à jour vont le découvrir vite. Si vous êtes chez un hébergeur qui configure Geyser pour vous, posez-lui la question avant de toucher quoi que ce soit : il a peut-être déjà fait le travail, et vos réglages risquent d'être écrasés. Et si vous hébergez chez vous, vérifiez que votre fournisseur ne partage pas une même adresse IP entre plusieurs clients (CGNAT) : dans ce cas, la redirection de ports de votre box ne suffit pas, et c'est un piège fréquent.

Questions fréquentes

Faut-il absolument installer Floodgate ?

Non, il est facultatif. Sans lui, Geyser authentifie vos joueurs Bedrock auprès de Mojang, ce qui impose un compte Java (auth-type: online). Floodgate leur évite ça en acceptant le seul compte Microsoft.

Quelle version de Minecraft faut-il pour utiliser Geyser ?

Un serveur Java en 26.3 fonctionne directement avec les builds récents. Pour toute autre version, ajoutez ViaVersion. Les mods Fabric et NeoForge de Geyser, eux, ne tournent que sur un serveur 26.3.

Peut-on utiliser le même port que le serveur Java ?

Non, le port de Geyser doit être différent de celui du serveur Java. Si votre hébergeur ne fournit qu'un seul port, l'option clone-remote-port avec une signalisation externe est la voie prévue par l'équipe, sinon il faut demander un port supplémentaire.

Geyser fonctionne-t-il avec un réseau Velocity ou BungeeCord ?

Oui. Installez Geyser sur le proxy uniquement, et vérifiez que tous les serveurs du réseau acceptent les clients Java 26.3. Floodgate se place sur le proxy, avec un partage de la clé uniquement si vous voulez son API sur les serveurs de jeu.

Et sur un serveur Forge ou avec beaucoup de mods ?

Cela dépend de ce que font les mods. Si ceux-ci ajoutent des blocs ou des objets, Geyser ne peut pas les traduire pour Bedrock et n'est pas pris en charge dans ce cas. La règle pratique de la documentation : si un client Java vanilla peut rejoindre votre serveur, Geyser le peut aussi.

Les joueurs sur console peuvent-ils rejoindre ?

Oui, mais pas directement dans la plupart des cas, car les consoles n'offrent pas toujours de champ pour saisir une adresse. Passez par un outil de redirection comme BedrockConnect, et testez d'abord avec un client mobile ou Windows pour isoler le problème.

Comment mettre les joueurs Bedrock en liste blanche ?

Avec Floodgate, utilisez fwhitelist add <pseudo> depuis la console ou en jeu : la commande écrit dans whitelist.json et n'a pas besoin du préfixe. La permission associée s'appelle floodgate.command.fwhitelist. Vous pouvez aussi ajouter un joueur par son UUID.