FR

Serveurs de jeux

Comment accueillir les joueurs Bedrock avec Geyser et Floodgate

Ouvrez votre serveur Minecraft Java aux joueurs Bedrock avec Geyser et Floodgate sur Paper : installation, ports TCP et UDP, pare-feu, connexion et dépannage.

7 min de lecture, mis à jour le 18 novembre 2026

Sur cette page

Vos valeurs

Renseignez-les une fois, les commandes du guide se mettent à jour.

Minecraft Java et Minecraft Bedrock (mobile, Windows, consoles) ne parlent pas le même langage réseau. Ce guide vous explique comment installer deux plugins sur votre serveur Paper pour que les joueurs Bedrock puissent le rejoindre :

  • Geyser traduit les échanges entre Bedrock et Java
  • Floodgate permet aux joueurs Bedrock d'entrer avec leur compte Microsoft, sans posséder Minecraft Java

Prérequis

  • Un serveur sous Paper, avec la commande mc-console mise en place dans le guide Installer et mettre à jour des plugins sur Paper
  • Le mode en ligne conservé dans server.properties : online-mode=true
  • Un accès au pare-feu du serveur
  • Un client Minecraft Bedrock à jour pour tester

Comprendre les ports

Bedrock utilise désormais le protocole de connexion NetherNet, activé par défaut dans Geyser. Il a besoin du même numéro de port dans les deux protocoles :

Port Protocole Utilisation
19132 TCP Signalisation : le client trouve le serveur et prépare la connexion
19132 UDP Échanges de jeu
25565 TCP Joueurs Java, déjà ouvert

Ouvrir le pare-feu

Utilisez un seul outil de pare-feu, celui qui est déjà actif sur votre serveur.

Avec UFW

Terminal
sudo ufw allow 19132/tcp
sudo ufw allow 19132/udp
sudo ufw reload

Avec iptables

Terminal
sudo iptables -A INPUT -p tcp --dport 19132 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 19132 -j ACCEPT
sudo iptables-save | sudo tee /etc/iptables/rules.v4

La conservation des règles au redémarrage nécessite le paquet iptables-persistent.

Avec nftables

Ces commandes utilisent la table inet filter et la chaîne input, présentes par défaut dans /etc/nftables.conf sous Debian.

Terminal
sudo nft add rule inet filter input tcp dport 19132 accept
sudo nft add rule inet filter input udp dport 19132 accept
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.conf

Installer Geyser et Floodgate

Téléchargez les versions pour Paper et Spigot depuis le service officiel :

Terminal
sudo -u minecraft bash
cd /opt/minecraft/server/plugins
curl -fL -o Geyser-Spigot.jar https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/spigot
curl -fL -o floodgate-spigot.jar https://download.geysermc.org/v2/projects/floodgate/versions/latest/builds/latest/downloads/spigot
ls -l Geyser-Spigot.jar floodgate-spigot.jar
exit

Redémarrez le serveur pour générer les fichiers de configuration, puis attendez la ligne Done :

Terminal
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -f

Quittez le suivi avec Ctrl+C.

Configurer Geyser

Ouvrez le fichier de configuration :

Terminal
sudo -u minecraft nano /opt/minecraft/server/plugins/Geyser-Spigot/config.yml

Vérifiez la section bedrock, puis passez auth-type à floodgate dans la section java. Modifiez les lignes existantes, sans les dupliquer :

YAML
bedrock:
  address: 0.0.0.0
  port: 19132
  transport: nethernet

java:
  auth-type: floodgate

Vous pouvez aussi personnaliser le nom affiché aux joueurs Bedrock avec server-name, dans la section gameplay.

Redémarrez le serveur pour appliquer ces changements :

Terminal
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -f

Vérifier le résultat

Contrôlez que les plugins sont chargés et que le serveur écoute sur les deux protocoles :

Terminal
sudo mc-console plugins
sudo mc-console 'geyser version'
sudo MC_CONSOLE_WAIT=5 mc-console 'geyser nethernet'
sudo ss -tulpn | grep 19132

Vous devez voir :

  • Geyser-Spigot et floodgate dans la liste des plugins
  • une ligne Built-in signaling started on dans le journal de démarrage
  • le port 19132 en tcp et en udp dans la sortie de ss

Testez ensuite l'accès depuis l'extérieur. La commande suivante demande à Geyser de contrôler que votre serveur est joignable :

Terminal
sudo MC_CONSOLE_WAIT=15 mc-console 'geyser connectiontest IP_SERVEUR 19132'

Depuis un autre ordinateur, vous pouvez aussi vérifier le port TCP :

Terminal
nc -vz IP_SERVEUR 19132

Se connecter depuis Bedrock

Dans Minecraft Bedrock :

  1. Ouvrez Jouer, puis l'onglet Serveurs
  2. Choisissez Ajouter un serveur
  3. Saisissez un nom, l'adresse IP_SERVEUR et le port 19132
  4. Enregistrez, puis rejoignez le serveur

À la première connexion, le jeu demande s'il doit faire confiance au serveur. C'est normal lorsqu'on se connecte par une adresse IP ou sans HTTPS. Pour supprimer ce message, vous pouvez servir la signalisation en HTTPS avec un nom de domaine et un certificat.

Une fois en jeu, vérifiez la présence du joueur :

Terminal
sudo mc-console 'geyser list'

Gérer les joueurs Bedrock

Pseudos

Floodgate ajoute un point devant les pseudos Bedrock pour éviter les conflits avec les comptes Java : Steve devient .Steve. Les espaces sont remplacés par _. Ces réglages correspondent à username-prefix et replace-spaces dans plugins/floodgate/config.yml.

Whitelist

Si white-list=true est actif, ajoutez les joueurs Bedrock avec la commande de Floodgate, sans le point :

Terminal
sudo mc-console 'fwhitelist add Steve'

Permissions avec LuckPerms

LuckPerms refuse par défaut les pseudos contenant un point. Autorisez-les dans son fichier de configuration :

Terminal
sudo -u minecraft nano /opt/minecraft/server/plugins/LuckPerms/config.yml
YAML
allow-invalid-usernames: true

Redémarrez le serveur. Une fois que le joueur s'est connecté, vous pouvez le placer dans un grade avec son pseudo complet :

Terminal
sudo mc-console 'lp user .Steve parent add vip'

Lier un compte Java et un compte Bedrock

Un joueur qui possède les deux éditions peut les lier en rejoignant le serveur link.geysermc.org avec chaque compte et en utilisant /linkaccount. Cette liaison globale est active par défaut.

Mettre à jour Geyser et Floodgate

Bedrock évolue souvent, et une nouvelle version du jeu peut empêcher les joueurs de se connecter tant que Geyser n'est pas à jour. Mettez-le à jour régulièrement :

Terminal
sudo -u minecraft bash
mkdir -p /opt/minecraft/server/plugins/update
cd /opt/minecraft/server/plugins/update
curl -fL -o Geyser-Spigot.jar https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/spigot
curl -fL -o floodgate-spigot.jar https://download.geysermc.org/v2/projects/floodgate/versions/latest/builds/latest/downloads/spigot
exit
sudo systemctl restart minecraft.service

En cas de problème

« Unable to connect to world » ou serveur introuvable

  1. Vérifiez que les ports TCP et UDP sont ouverts avec sudo ufw status, sudo iptables -L INPUT -n ou sudo nft list ruleset
  2. Vérifiez l'écoute avec sudo ss -tulpn | grep 19132
  3. Lancez geyser connectiontest IP_SERVEUR 19132 depuis la console
  4. Regardez dans le journal si une tentative de connexion arrive. Si rien n'apparaît, le blocage se situe sur le réseau

Si le pare-feu du serveur est correct et que le port reste injoignable depuis l'extérieur, contactez le support depuis votre espace client pour vérifier qu'aucun filtrage réseau ne s'applique.

« NetherNet will not start! Could not load its WebRTC native library »

Geyser n'a pas pu charger sa bibliothèque réseau, qu'il extrait dans le dossier temporaire. Vérifiez que /tmp n'est pas monté avec l'option noexec et qu'il reste de la place :

Terminal
findmnt -no OPTIONS /tmp
df -h /tmp

Le client reste bloqué sur la recherche du serveur (« Locating Server »)

Baissez la taille des paquets par paliers de 100 dans plugins/Geyser-Spigot/config.yml, en redémarrant et en testant après chaque changement :

YAML
advanced:
  bedrock:
    mtu: 1300

Le serveur annonce une mauvaise adresse

Geyser détecte normalement l'adresse publique tout seul. Si le serveur possède plusieurs adresses, ou si la détection échoue, indiquez celle que les joueurs doivent utiliser :

YAML
bedrock:
  signaling:
    advertise-addresses:
      - IP_SERVEUR

« Address already in use »

Un autre programme utilise déjà le port 19132, souvent une seconde instance de Geyser. Identifiez-le avec sudo ss -tulpn | grep 19132.

« Auth-type set to Floodgate but Floodgate is not installed! »

Floodgate est absent ou n'a pas démarré. Vérifiez la présence de floodgate-spigot.jar dans plugins, puis cherchez ses erreurs dans le journal.

« Cannot reply to EncryptionRequestPacket without profile and access token »

Floodgate n'est pas actif, ou auth-type n'est pas à floodgate. Contrôlez ces deux points. Si une copie de key.pem se trouve dans le dossier de Geyser, supprimez-la.

« javax.crypto.AEADBadTagException: Tag mismatch! »

La clé de Floodgate est incohérente. Arrêtez le serveur, supprimez le dossier plugins/floodgate et toute clé présente dans plugins/Geyser-Spigot, puis redémarrez :

Terminal
sudo systemctl stop minecraft.service
sudo rm -rf /opt/minecraft/server/plugins/floodgate
sudo rm -f /opt/minecraft/server/plugins/Geyser-Spigot/key.pem
sudo systemctl start minecraft.service

Si vous aviez modifié la configuration de Floodgate, vous devrez refaire ces réglages.

« Please connect through the official Geyser »

Geyser et Floodgate ne sont pas compatibles entre eux. Mettez-les à jour tous les deux.

« Failed to verify username! »

Dans config/paper-global.yml, passez perform-username-validation à false, dans la section unsupported-settings, puis redémarrez le serveur.

« Outdated client » ou « Outdated server »

Le client Bedrock et Geyser ne correspondent plus. Mettez à jour Geyser, puis le jeu. Si votre serveur Java n'est pas en version 26.3, installez ViaVersion.

Pour aller plus loin, consultez la documentation officielle de Geyser et celle de Floodgate.