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.
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-consolemise 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
sudo ufw allow 19132/tcp
sudo ufw allow 19132/udp
sudo ufw reloadAvec iptables
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.v4La 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.
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.confInstaller Geyser et Floodgate
Téléchargez les versions pour Paper et Spigot depuis le service officiel :
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
exitRedémarrez le serveur pour générer les fichiers de configuration, puis attendez la ligne Done :
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -fQuittez le suivi avec Ctrl+C.
Configurer Geyser
Ouvrez le fichier de configuration :
sudo -u minecraft nano /opt/minecraft/server/plugins/Geyser-Spigot/config.ymlVérifiez la section bedrock, puis passez auth-type à floodgate dans la section java. Modifiez les lignes existantes, sans les dupliquer :
bedrock:
address: 0.0.0.0
port: 19132
transport: nethernet
java:
auth-type: floodgateVous pouvez aussi personnaliser le nom affiché aux joueurs Bedrock avec server-name, dans la section gameplay.
Redémarrez le serveur pour appliquer ces changements :
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -fVérifier le résultat
Contrôlez que les plugins sont chargés et que le serveur écoute sur les deux protocoles :
sudo mc-console plugins
sudo mc-console 'geyser version'
sudo MC_CONSOLE_WAIT=5 mc-console 'geyser nethernet'
sudo ss -tulpn | grep 19132Vous devez voir :
Geyser-Spigotetfloodgatedans la liste des plugins- une ligne
Built-in signaling started ondans le journal de démarrage - le port
19132entcpet enudpdans la sortie dess
Testez ensuite l'accès depuis l'extérieur. La commande suivante demande à Geyser de contrôler que votre serveur est joignable :
sudo MC_CONSOLE_WAIT=15 mc-console 'geyser connectiontest IP_SERVEUR 19132'Depuis un autre ordinateur, vous pouvez aussi vérifier le port TCP :
nc -vz IP_SERVEUR 19132Se connecter depuis Bedrock
Dans Minecraft Bedrock :
- Ouvrez Jouer, puis l'onglet Serveurs
- Choisissez Ajouter un serveur
- Saisissez un nom, l'adresse
IP_SERVEURet le port19132 - 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 :
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 :
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 :
sudo -u minecraft nano /opt/minecraft/server/plugins/LuckPerms/config.ymlallow-invalid-usernames: trueRedémarrez le serveur. Une fois que le joueur s'est connecté, vous pouvez le placer dans un grade avec son pseudo complet :
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 :
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.serviceEn cas de problème
« Unable to connect to world » ou serveur introuvable
- Vérifiez que les ports TCP et UDP sont ouverts avec
sudo ufw status,sudo iptables -L INPUT -nousudo nft list ruleset - Vérifiez l'écoute avec
sudo ss -tulpn | grep 19132 - Lancez
geyser connectiontest IP_SERVEUR 19132depuis la console - 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 :
findmnt -no OPTIONS /tmp
df -h /tmpLe 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 :
advanced:
bedrock:
mtu: 1300Le 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 :
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 :
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.serviceSi 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.