Vos amis jouent sur mobile, sur console ou sur Windows avec l'édition Bedrock, et vous sur Java ? Bonne nouvelle : avec GeyserMC, tout le monde peut se retrouver sur le même serveur Minecraft. Ce guide vous explique comment l'installer, le configurer et résoudre les problèmes les plus courants.

Qu'est-ce que GeyserMC ?

Minecraft Java Edition et Minecraft Bedrock Edition n'utilisent pas le même protocole réseau : par défaut, un joueur Bedrock ne peut pas rejoindre un serveur Java. Geyser joue le rôle de traducteur : il reçoit les connexions Bedrock et les convertit en connexions Java que votre serveur comprend.

Geyser s'accompagne généralement de Floodgate, un second plugin qui permet aux joueurs Bedrock de se connecter avec leur seul compte Microsoft/Xbox, sans posséder de compte Minecraft Java.

Composant	Rôle	Indispensable ?
Geyser-Spigot	Traduit le protocole Bedrock vers Java	✅ Oui
Floodgate	Connexion des joueurs Bedrock sans compte Java	✅ Fortement recommandé
ViaVersion	Accepte des versions de client différentes de celle du serveur	Optionnel

Prérequis

Un serveur Paper, Spigot ou Purpur (Geyser existe aussi pour les proxys Velocity et BungeeCord, mais ce guide traite du plugin Spigot).
La version de Java requise par votre version de Minecraft (Java 25 depuis Minecraft 26.1, Java 21 pour les versions 1.20.5 à 1.21.11).
Un serveur à jour : Geyser suit la dernière version de Minecraft Java. Si votre serveur tourne sur une version plus ancienne, installez ViaVersion.
La possibilité d'ouvrir un port UDP supplémentaire, ou d'utiliser le même port que Java (voir plus bas).

Installation de Geyser et Floodgate

Étape 1 : télécharger les plugins

Téléchargez uniquement depuis le site officiel du projet GeyserMC, rubrique Download. Choisissez la version Spigot (compatible Paper et Purpur) de Geyser, puis celle de Floodgate.

⚠️ Attention : évitez les sites de téléchargement non officiels, qui peuvent proposer des versions modifiées ou obsolètes.

Étape 2 : installer les fichiers

1. Arrêtez votre serveur
2. Placez Geyser-Spigot.jar et floodgate-spigot.jar dans le dossier /plugins/
3. Démarrez le serveur
4. Les fichiers de configuration sont générés automatiquement

Étape 3 : vérifier le chargement

/plugins
/geyser version

Geyser et floodgate doivent apparaître en vert dans la liste des plugins.

Configuration de Geyser

Le fichier principal se trouve dans plugins/Geyser-Spigot/config.yml. Voici les paramètres essentiels (les noms peuvent légèrement varier selon la version de Geyser, référez-vous aux commentaires du fichier) :

bedrock: # Adresse d'écoute des joueurs Bedrock address: 0.0.0.0 # Port Bedrock (UDP), 19132 par défaut port: 19132 # true = utiliser le même port que le serveur Java clone-remote-port: false remote: Avec le plugin Spigot, laissez "auto" address: auto port: 25565 "floodgate" = connexion sans compte Java

auth-type: floodgate

Le paramètre auth-type

Valeur	Effet
`floodgate`	Les joueurs Bedrock entrent avec leur compte Xbox, sans compte Java (recommandé avec Floodgate)
`online`	Les joueurs Bedrock doivent lier un compte Java valide
`offline`	Aucune vérification : à éviter sur un serveur public

Lorsque Geyser et Floodgate sont installés sur le même serveur, Floodgate partage automatiquement sa clé de chiffrement avec Geyser : vous n'avez rien à copier.

Le préfixe des joueurs Bedrock

Pour éviter qu'un joueur Bedrock ait le même pseudo qu'un joueur Java, Floodgate ajoute un préfixe : par défaut un point. Le joueur Bedrock Steve apparaîtra donc sous le nom .Steve. Vous pouvez le modifier dans plugins/floodgate/config.yml :

username-prefix: "."

Pensez-y lorsque vous donnez des permissions ou ajoutez un joueur Bedrock à la whitelist : utilisez bien son nom avec le préfixe.

Ouvrir le port Bedrock

Les joueurs Bedrock se connectent en UDP, sur le port 19132 par défaut. C'est l'étape qui pose le plus de problèmes.

Option 1 : un port dédié

Si votre hébergeur vous permet d'ajouter un port, ouvrez-le en UDP et indiquez-le dans bedrock.port. Sur une machine que vous gérez vous-même, autorisez-le dans le pare-feu :

# Exemple avec UFW sur Linux
sudo ufw allow 19132/udp

Option 2 : partager le port Java

Beaucoup d'hébergeurs ne fournissent qu'un seul port. Dans ce cas, passez clone-remote-port à true : Geyser écoutera sur le même numéro de port que le serveur Java. Java utilise TCP et Bedrock UDP, les deux peuvent donc cohabiter, à condition que le port soit aussi ouvert en UDP chez votre hébergeur.

bedrock:
  clone-remote-port: true

Redémarrez ensuite le serveur pour appliquer les changements.

Se connecter depuis Bedrock

Mobile et Windows

Ouvrez Minecraft Bedrock et allez dans l'onglet Serveurs.
Cliquez sur Ajouter un serveur.
Saisissez l'adresse IP (ou le nom de domaine) de votre serveur et le port Bedrock.
Enregistrez et rejoignez le serveur.

Consoles (Xbox, PlayStation, Switch)

Sur console, Minecraft ne permet pas d'ajouter librement un serveur externe. Des solutions communautaires comme BedrockConnect contournent cette limite, généralement en modifiant les DNS de la console. Elles ne sont pas officielles et leur fonctionnement peut changer : renseignez-vous sur leur documentation avant de les utiliser.

Les limites à connaître

Geyser fait un travail remarquable, mais Java et Bedrock restent deux jeux différents :

Mécaniques de jeu : certaines subtilités (redstone avancée, combat, déplacements) ne se comportent pas exactement de la même façon.
Packs de ressources : un pack Java n'est pas converti automatiquement. Les packs au format Bedrock peuvent être ajoutés dans le dossier packs de Geyser.
Commandes et interfaces : l'autocomplétion et certains menus de plugins s'affichent différemment pour les joueurs Bedrock.
Plugins anti-triche : certains peuvent détecter à tort les joueurs Bedrock ; vérifiez qu'ils sont compatibles avec Geyser.

Dépannage

« Impossible de se connecter au monde »

Vérifiez que le port Bedrock est bien ouvert en UDP (une ouverture TCP ne suffit pas).
Contrôlez que le port saisi dans le jeu correspond à bedrock.port.
Consultez la console du serveur au démarrage : Geyser y indique le port sur lequel il écoute.

« Outdated server » ou version incompatible

Mettez à jour Geyser et Floodgate : chaque nouvelle version de Bedrock demande souvent une mise à jour de Geyser.
Si votre serveur Java est ancien, installez ViaVersion.

Les joueurs Bedrock doivent se connecter avec un compte Java

Vérifiez que Floodgate est installé et chargé.
Vérifiez que auth-type vaut bien floodgate, puis redémarrez.

Commandes de diagnostic

/geyser version   # Version installée
/geyser list      # Joueurs Bedrock connectés
/geyser reload    # Recharger la configuration
/geyser dump      # Rapport complet pour le support

Whitelist et joueurs Bedrock

Si votre serveur est en whitelist, ajoutez les joueurs Bedrock avec la commande de Floodgate, qui gère le préfixe pour vous :

/fwhitelist add <pseudo_bedrock>

Conclusion

Avec GeyserMC et Floodgate, votre serveur Minecraft devient accessible à tous vos amis, quelle que soit leur plateforme. En résumé :

Installez Geyser-Spigot et Floodgate depuis le site officiel de GeyserMC.
Réglez auth-type: floodgate dans la configuration de Geyser.
Ouvrez le port 19132 en UDP, ou partagez le port Java avec clone-remote-port.
Gardez Geyser et Floodgate à jour à chaque nouvelle version de Minecraft.

Votre communauté n'a plus aucune excuse pour ne pas jouer ensemble !