Un guide sur comment installer et configurer Geyser et Floodgate afin que les joueurs de Minecraft: Bedrock Edition puissent rejoindre votre serveur Java Edition. Ce guide couvre Spigot/Paper, Fabric, NeoForge, BungeeCord, Velocity, ViaProxy, et la version standalone.
Geyser est un pont qui traduit entre les deux éditions de Minecraft. Il fait apparaître votre serveur Java Edition, aux yeux d'un client Bedrock, comme s'il s'agissait d'un serveur Bedrock, ce qui signifie que les joueurs sur téléphone, tablette, console, et l'édition Windows 10/11 peuvent rejoindre un serveur qu'ils ne pourraient sinon même pas voir. Floodgate en est le complément, et c'est ce qui permet à ces joueurs Bedrock d'entrer sans posséder de compte Java Edition.
Requirements
- Un serveur Minecraft: Java Edition dont vous contrôlez les fichiers. Un hébergeur qui ne vous permet pas d'uploader des jars ne peut pas faire tourner Geyser.
- Java 21 ou une version ultérieure, ce qui est de toute façon requis par les logiciels de serveur Minecraft actuels.
- Un port UDP que vous pouvez ouvrir et rediriger. Bedrock Edition utilise UDP, pas TCP, et c'est l'erreur la plus fréquente que les gens commettent.
- Si vous êtes sur un hébergement mutualisé, vérifiez qu'il autorise un second port. Certains n'en donnent qu'un seul.
How Geyser and Floodgate Work Together
J'aimerais expliquer brièvement comment ces deux plugins fonctionnent ensemble, car installer l'un sans l'autre peut entraîner l'incapacité des joueurs Bedrock à se connecter correctement (par exemple, ils pourraient toujours devoir connecter leur compte Java).
Geyser effectue la traduction Java <-> Bedrock. Il écoute sur un port UDP, accepte les connexions Bedrock, et parle le protocole de la Java Edition à votre serveur de l'autre côté. Seul, Geyser permettra à un joueur Bedrock de se connecter, mais ce joueur devra tout de même s'authentifier en tant que compte Java Edition, ce que la plupart des joueurs Bedrock ne possèdent pas.
Floodgate supprime cette exigence. Il indique au serveur Java d'accepter un joueur qui a été approuvé par Geyser, sans avoir besoin d'un compte Java. C'est pourquoi les deux sont presque toujours installés ensemble, et c'est pourquoi Floodgate fournit un fichier key.pem que l'on vous dit, en termes assez fermes, de ne pas partager. Cette clé est ce qui permet à un compte de contourner l'authentification Java.
Geyser s'installe une seule fois, à l'endroit vers lequel vos joueurs Bedrock pointeront. Floodgate s'installe sur le serveur qui possède la liste des joueurs. Sur un serveur unique, c'est la même machine. Sur un réseau avec proxy, Geyser et Floodgate vont tous les deux sur le proxy.
Downloading
Tout provient de la page de téléchargement officielle. Nous ne recommandons pas de télécharger ces fichiers ailleurs.
Au moment de la rédaction, les builds actuelles sont Geyser build #1234 (2 septembre 2026) et Floodgate build #140 (9 août 2026). Les deux projets publient en continu, donc les numéros de build que vous verrez seront plus élevés. C'est normal et attendu.
Which File Do I Need?
Geyser publie une build pour chaque plateforme. Floodgate non, et c'est ce qui piège les gens :
| Platform | Geyser | Floodgate |
|---|---|---|
| Spigot / Paper | Geyser-Spigot.jar |
floodgate-spigot.jar |
| Fabric | Geyser-Fabric.jar |
floodgate-fabric.jar |
| NeoForge | Geyser-NeoForge.jar |
floodgate-neoforge.jar |
| BungeeCord | Geyser-BungeeCord.jar |
floodgate-bungee.jar |
| Velocity | Geyser-Velocity.jar |
floodgate-velocity.jar |
| ViaProxy | Geyser-ViaProxy.jar |
Not available |
| Standalone | Geyser-Standalone.jar |
Not available |
Il n'existe aucune build de Floodgate pour ViaProxy ou pour Geyser en standalone. Floodgate doit tourner à l'intérieur du serveur Java qui possède la liste des joueurs, et dans ces deux configurations, Geyser fonctionne en externe. Vous installez le jar Floodgate spécifique à la plateforme sur le serveur Java vers lequel pointe Geyser, puis vous copiez le key.pem de ce serveur vers Geyser. Une section plus bas traite de ce sujet.
Direct Download Links
Ces URLs pointent toujours vers la dernière build, elles sont donc sûres à mettre en favori ou à utiliser dans un script !
- Spigot
- Fabric
- NeoForge
- BungeeCord
- Velocity
- ViaProxy
- Standalone
- Floodgate Spigot
- Floodgate Bungee
- Floodgate Velocity
Sur un serveur Linux, vous pouvez en télécharger un directement :
wget -O plugins/Geyser-Spigot.jar \
https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/spigot
Installing Geyser
Choisissez la seule section qui correspond à votre configuration de serveur. Vous n'avez besoin de suivre que les instructions pour cette configuration.
Spigot & Paper
- Téléchargez
Geyser-Spigot.jar. - Placez-le dans le dossier
plugins/de votre serveur. - Redémarrez le serveur. N'utilisez pas
/reload, car les rechargements de plugins causent plus de problèmes qu'ils n'en résolvent. - Geyser génère sa configuration dans
plugins/Geyser-Spigot/config.yml.
Fabric
- Téléchargez
Geyser-Fabric.jar. - Placez-le dans le dossier
mods/de votre serveur. - Les serveurs Fabric ont aussi besoin du mod Fabric API dans le même dossier.
- Redémarrez le serveur. La configuration apparaît dans
config/Geyser-Fabric/config.yml.
NeoForge
- Téléchargez
Geyser-NeoForge.jar. - Placez-le dans le dossier
mods/de votre serveur. - Redémarrez le serveur. La configuration apparaît dans
config/Geyser-NeoForge/config.yml.
BungeeCord
Installez Geyser sur le proxy, pas sur les serveurs backend. C'est au proxy que les joueurs Bedrock se connecteront.
- Téléchargez
Geyser-BungeeCord.jar. - Placez-le dans le dossier
plugins/du proxy. - Redémarrez le proxy. La configuration apparaît dans
plugins/Geyser-BungeeCord/config.yml.
Velocity
Même principe que BungeeCord. Geyser va sur le proxy.
- Téléchargez
Geyser-Velocity.jar. - Placez-le dans le dossier
plugins/du proxy. - Redémarrez le proxy. La configuration apparaît dans
plugins/Geyser-Velocity/config.yml.
ViaProxy
ViaProxy est un proxy autonome qui permet à des clients d'une version de Minecraft de rejoindre un serveur d'une autre version. Geyser s'y branche comme addon.
- Téléchargez
Geyser-ViaProxy.jar. - Placez-le dans le dossier
plugins/de ViaProxy. - Lancez ViaProxy une fois pour que Geyser génère sa configuration, puis arrêtez-le.
- Comme Geyser tourne ici en dehors de votre serveur Java, vous devez lui indiquer où se trouve ce serveur. Voir La section Remote.
Standalone
Standalone, c'est Geyser qui tourne comme son propre programme, seul, pointé vers un serveur Java via le réseau. C'est le bon choix quand vous ne pouvez pas installer de plugins ou de mods sur le serveur lui-même, et c'est le mauvais choix dans presque tous les autres cas, car cela ajoute un saut réseau et ne peut pas utiliser Floodgate sans configuration supplémentaire.
- Téléchargez
Geyser-Standalone.jar. - Placez-le dans son propre dossier.
- Lancez-le :
java -Xmx1G -jar Geyser-Standalone.jar
- Il génère
config.ymlà côté de lui-même puis se ferme ou attend. Arrêtez-le, modifiez la configuration, puis relancez-le.
Configurer Geyser
Ouvrez le config.yml correspondant à votre plateforme. Les deux sections qui comptent sont bedrock et, sur standalone et ViaProxy, remote.
La section Bedrock
C'est ce à quoi les joueurs Bedrock se connectent :
bedrock:
# The IP address that will listen for connections.
# Generally, you should only change this if you want to limit what IPs can connect to your server.
address: 0.0.0.0
# The port that will Geyser will listen on for incoming Bedrock connections.
# Since Minecraft: Bedrock Edition uses UDP, this port must allow UDP traffic.
port: 19132
# Some hosting services change your Java port everytime you start the server and require the same port to be used for Bedrock.
# This option makes the Bedrock port the same as the Java port every time you start the server.
clone-remote-port: false
Le port est ce qui compte vraiment. 19132 est le port par défaut de Bedrock Edition, et le laisser tel quel signifie que les joueurs peuvent ajouter votre serveur juste avec l'adresse, sans taper de port. Ne le changez que si le 19132 est déjà pris ou que votre hébergeur vous en assigne un autre.
clone-remote-port est destiné aux hébergeurs qui vous donnent un nouveau port à chaque redémarrage et attendent que le trafic Bedrock utilise le même port. Si vous l'activez, cela écrase la valeur de port ci-dessus, donc définir les deux et se demander pourquoi votre port est ignoré est un piège à connaître.
address: 0.0.0.0 signifie « écouter sur toutes les interfaces réseau », ce qui est ce que vous voulez sauf si vous restreignez délibérément l'accès.
La section Remote (Standalone et ViaProxy uniquement)
Quand Geyser tourne comme plugin ou mod, il sait déjà où se trouve le serveur, puisqu'il est à l'intérieur. Quand il tourne en standalone ou sous ViaProxy, vous devez configurer la section remote pour pointer vers votre serveur Java.
remote:
address: 127.0.0.1
port: 25565
auth-type: floodgate
Utilisez 127.0.0.1 (localhost) si le serveur Java est sur la même machine. Utilisez sa véritable adresse si ce n'est pas le cas, et sachez que vous venez de mettre une connexion Minecraft non chiffrée sur le réseau entre les deux.
Installer Floodgate
Floodgate doit être placé sur le serveur Minecraft Java qui possède la liste des joueurs.
Spigot & Paper
- Téléchargez
floodgate-spigot.jardepuis la page de téléchargement. - Placez-le dans le dossier
plugins/. - Redémarrez le serveur.
Fabric & NeoForge
- Téléchargez le mod depuis la page Modrinth ou la page de téléchargement.
- Placez le fichier dans le dossier
mods/. Les serveurs Fabric nécessitent aussi Fabric API installé sur le serveur. - Redémarrez le serveur.
Si le serveur Fabric se trouve derrière un proxy Velocity, vous devrez aussi configurer FabricProxyLite pour que le serveur Fabric accepte les données de joueur transmises par Velocity.
BungeeCord & Velocity
Installez Floodgate uniquement sur le proxy. Vous n'en avez pas besoin sur les serveurs backend, sauf si vous voulez spécifiquement utiliser l'API Floodgate là-bas, ou que vous voulez que les skins Bedrock s'affichent correctement sur le backend.
- Téléchargez
floodgate-bungee.jaroufloodgate-velocity.jar. - Placez le fichier dans le dossier
plugins/du proxy. - Redémarrez le proxy.
Définir auth-type sur floodgate
C'est l'étape qui permet réellement de laisser entrer les joueurs Bedrock, et beaucoup de gens l'oublient accidentellement (moi y compris, quand j'ai installé Geyser et Floodgate pour la première fois il y a des années, lol).
Ouvrez le fichier de configuration de Geyser (pas celui de Floodgate), trouvez la clé auth-type, et mettez-la sur floodgate :
auth-type: floodgate
Les trois valeurs acceptées sont :
floodgate- Les joueurs Bedrock rejoignent sans compte Java Edition. C'est ce que vous voulez, et cela nécessite que Floodgate soit installé.online- chaque joueur doit posséder et authentifier un compte Java Edition. C'est la valeur par défaut.offline- aucune authentification du tout. Non recommandé sur les serveurs publics.
Redémarrez le serveur après avoir appliqué des modifications. Geyser lit ce paramètre au démarrage du serveur.
Faire tourner Floodgate derrière un proxy
Si vous avez un proxy avec des serveurs backend derrière lui, et que vous voulez que l'API Floodgate soit disponible sur ces backends, il y a un peu plus à faire. Ignorez complètement cette section si vous n'avez qu'un seul serveur.
- Installez d'abord Floodgate sur le proxy, comme indiqué ci-dessus.
- Installez également Floodgate sur chaque serveur backend, en utilisant
floodgate-spigot.jaroufloodgate-fabric.jar. - Activez le transfert des informations de joueur :
- BungeeCord : mettez
ip_forwardàtruedans leconfig.ymldu proxy, et mettezbungeecordàtruedans lespigot.ymlde chaque backend. - Velocity : configurez le transfert des informations de joueur. Velocity dispose de plusieurs modes et chacun nécessite une configuration différente sur le backend, donc suivez leur guide plutôt que de deviner.
- BungeeCord : mettez
- Démarrez le proxy pour que Floodgate génère ses fichiers.
- Dans la config Floodgate du proxy, mettez
send-floodgate-dataàtrue. - Copiez le fichier
key.pemdu dossier de config Floodgate du proxy vers le dossier de config Floodgate de chaque serveur backend. - Redémarrez les backends et le proxy.
ATTENTION : Comme indiqué précédemment, ne partagez pas key.pem avec qui que ce soit, et ne le collez pas dans un salon d'assistance en demandant de l'aide. Ce fichier est ce qui permet aux comptes Bedrock de contourner l'authentification Java Edition. Toute personne en possession d'une copie peut se connecter à votre serveur en se faisant passer pour à peu près n'importe qui, si elle en a les capacités.
C'est la même copie de key.pem que vous utilisez pour faire fonctionner Floodgate avec Geyser en standalone ou avec ViaProxy. Installez le jar Floodgate adapté à la plateforme sur le serveur Java, puis copiez le fichier key.pem de ce serveur dans le propre dossier de config de Geyser.
Ouvrir le port
Bedrock Edition utilise l'UDP. Si vous ouvrez uniquement le TCP, le serveur n'apparaîtra pas dans la liste des serveurs pour les clients Bedrock.
Sur un serveur Linux, vous pouvez généralement y parvenir en utilisant le pare-feu installé.
# IPTables (underlying firewall used by ufw on many Linux distributions)
iptables -A INPUT -p udp --dport 19132 -j ACCEPT
# UFW (Uncomplicated Firewall)
sudo ufw allow 19132/udp
# Firewalld (used by many Linux distributions)
sudo firewall-cmd --permanent --add-port=19132/udp
sudo firewall-cmd --reload
Si vous hébergez depuis chez vous, vous devrez très probablement rediriger (port forward) le port UDP 19132 sur votre routeur vers la machine qui exécute Geyser. Si vous êtes chez un hébergeur, il s'agit généralement d'une allocation de port dans leur panneau plutôt que d'une règle de pare-feu, et il se peut que vous deviez ouvrir un ticket pour obtenir un second port.
Se connecter depuis Bedrock
Sur le client Bedrock, allez dans Jouer, puis dans l'onglet Serveurs, puis faites défiler jusqu'en bas et choisissez Ajouter un serveur.
- Nom du serveur : ce que vous voulez.
- Adresse du serveur : l'adresse IP ou le nom d'hôte de votre serveur.
- Port :
19132, ou ce que vous avez défini dans la config.
NOTE : Cela fonctionne bizarrement pour les joueurs console. Les éditions PlayStation, Xbox et Nintendo Switch ne permettent pas d'ajouter directement une adresse de serveur, et la solution de contournement habituelle est une astuce DNS qui redirige l'un des serveurs mis en avant vers le vôtre. Cela dépasse le cadre de ce guide, mais cela vaut la peine de s'y intéresser si besoin.
Notes
Voici quelques notes utiles.
Les anciennes versions de Minecraft ont besoin de ViaVersion
Geyser cible la version actuelle de Minecraft. Si votre serveur Java tourne sur une version antérieure à 26.2 (ou à la dernière version de Minecraft), vous aurez également besoin de ViaVersion pour que les anciens protocoles réseau puissent être compris. Nous vous recommandons de consulter la page des versions supportées de Geyser pour plus d'informations.
Lier les comptes Java et Bedrock
Par défaut, un joueur Bedrock qui rejoint via Floodgate obtient son propre compte séparé sur votre serveur, avec un préfixe sur son nom (un point, par défaut). Si vous voulez qu'un joueur puisse utiliser le même inventaire, les mêmes permissions et le même temps de jeu qu'il rejoigne depuis Java ou depuis Bedrock, c'est ce qu'on appelle la liaison de compte (account linking).
Il y a deux façons de le faire. La liaison globale, qui utilise link.geysermc.org et ne nécessite aucune configuration de votre part. La liaison locale conserve les liaisons dans votre propre base de données et nécessite une des extensions de base de données Floodgate, publiées sur la même page de téléchargement :
floodgate-sqlite-database.jar: La plus simple (locale), et suffisante pour un serveur unique.floodgate-mysql-database.jar: Pour les bases de données MySQL.floodgate-mongo-database.jar: Pour les bases de données MongoDB.
La plupart des propriétaires de serveurs opteront pour la liaison globale car elle ne nécessite aucune configuration supplémentaire. Assurez-vous que vos joueurs savent qu'ils doivent lier leurs comptes sur link.geysermc.org !
Joueurs Bedrock et mods Java
Geyser traduit le protocole réseau vanilla utilisé par Minecraft. Il ne traduit pas les blocs et objets personnalisés ajoutés par des mods, qui peuvent apparaître incorrects ou invisibles pour un joueur Bedrock. Hydraulic est le projet de GeyserMC dédié à cela, et il convertit les assets de mods en pack de ressources Bedrock. Nous vous recommandons vivement d'y jeter un œil si vous prévoyez de faire tourner des mods sur votre serveur.
Choses qui ne peuvent pas partager le port
Tout autre élément de votre serveur qui souhaite utiliser l'UDP sur le même port entrera en conflit avec Geyser. Les cas les plus courants sont les plugins de chat vocal (Simple Voice Chat en particulier) et le protocole Query de Minecraft. Ils doivent fonctionner sur leur propre port.
Voir aussi
- How To Install A Minecraft Server (Java Edition)
- How Much RAM For A Minecraft Server
- Geyser Wiki
- Floodgate Wiki
Conclusion
Le crossplay est un travail en deux parties. Geyser ouvre une porte UDP par laquelle les clients Bedrock peuvent passer, et Floodgate est ce qui les empêche de se voir demander un compte Java Edition au passage. Installez les deux, mettez auth-type à floodgate, ouvrez le port en UDP, et le reste consiste à vérifier que vous avez placé chaque jar dans le dossier que sa plateforme lit réellement.
Si ça ne fonctionne pas, l'ordre de vérification est presque toujours le même : le port est-il ouvert en UDP, auth-type est-il défini sur floodgate dans la config de Geyser (et non celle de Floodgate), et Floodgate est-il installé sur le serveur qui possède la liste des joueurs plutôt que sur un backend derrière un proxy.
Si vous avez des questions ou si vous cherchez une communauté de modding à rejoindre, envisagez de rejoindre notre serveur Discord !
Les guides que nous créons sont toujours ouverts aux modifications et améliorations, donc si vous avez des suggestions ou remarquez des problèmes, n'hésitez pas à contribuer en créant une pull request sur notre dépôt GitHub !
Bon modding !