Comment configurer Floodgate pour que les joueurs Bedrock rejoignent sans compte Java ?

Une fois GeyserMC installé, les joueurs Bedrock peuvent déjà trouver votre serveur — mais sur un serveur en online-mode=true, ils sont encore refusés au moment de rejoindre. Geyser ne traduit en effet que le protocole ; le contrôle de connexion attend toujours un compte Java payant, que les joueurs sur téléphone, tablette ou console n'ont généralement pas. Floodgate résout ce problème : les joueurs Bedrock sont vérifiés via leur propre compte Microsoft/Xbox et peuvent ainsi rejoindre en toute sécurité sans compte Java, pendant que votre serveur reste simplement en online-mode. Dans cet article, vous installez Floodgate à côté de Geyser, vous liez la clé, vous réglez correctement le type d'authentification et vous découvrez comment fonctionne le préfixe de gamertag.

Étape 1 : installez Floodgate à côté de Geyser

1. Téléchargez Floodgate depuis la page de téléchargement officielle de GeyserMC. Choisissez la même variante de plateforme que votre plugin Geyser, par exemple floodgate-spigot.jar pour un serveur Paper ou Spigot.
2. Connectez-vous au panel de jeu, ouvrez votre serveur et allez dans l'onglet Files.
3. Ouvrez le dossier plugins et téléversez le fichier .jar de Floodgate à côté de votre plugin Geyser.
4. Redémarrez votre serveur depuis l'onglet Console. Vous verrez Floodgate se charger dans la console ; au premier démarrage, le plugin crée automatiquement le fichier de clé plugins/floodgate/key.pem.

Étape 2 : vérifiez la liaison de clé entre Floodgate et Geyser

Le fichier key.pem est la clé secrète grâce à laquelle Geyser et Floodgate se font confiance. Si les deux tournent comme plugins sur le même serveur, Geyser récupère la clé automatiquement. Voici comment le vérifier :

1. Dans l'onglet Files, ouvrez le fichier plugins/Geyser-Spigot/config.yml.
2. Vérifiez que la ligne floodgate-key-file: key.pem est présente. C'est la valeur par défaut ; normalement, vous n'avez rien à modifier ici.
3. Vous gérez un réseau derrière un proxy (BungeeCord ou Velocity) ? Copiez alors plugins/floodgate/key.pem du proxy vers le dossier plugins/floodgate/ de chaque serveur backend. Tous les serveurs doivent utiliser exactement la même clé, sinon Floodgate refuse les connexions.

Étape 3 : réglez le type d'authentification sur floodgate

1. Ouvrez à nouveau plugins/Geyser-Spigot/config.yml.
2. Dans la section remote:, repérez la ligne auth-type: online et remplacez-la par auth-type: floodgate.
3. Enregistrez le fichier et redémarrez votre serveur depuis l'onglet Console.

Désormais, Floodgate gère la vérification des joueurs Bedrock via leur gamertag Xbox. Les joueurs Java se connectent comme d'habitude ; rien ne change pour eux.

Étape 4 : vérifiez le port UDP 19132

Bedrock se connecte en UDP, par défaut sur le port 19132. Dans config.yml, regardez sous bedrock: quel port: est configuré et assurez-vous que ce numéro de port est bien attribué à votre serveur et ouvert. Si le 19132 n'est pas disponible chez vous, ajoutez un port supplémentaire — consultez l'article sur les ports supplémentaires — et indiquez ce numéro dans port:. Au moment d'ajouter le serveur, les joueurs Bedrock utilisent l'IP de votre serveur suivie de ce numéro de port.

Le préfixe de gamertag : pourquoi les noms Bedrock commencent par un point

Par défaut, Floodgate place un point (.) devant chaque gamertag Bedrock, afin qu'un joueur Bedrock n'ait jamais exactement le même nom qu'un compte Java existant. Steve123 sur Bedrock apparaît donc sur votre serveur comme .Steve123. Gardez cela à l'esprit :

• Whitelist : /whitelist add .Steve123 échoue souvent, car le serveur essaie de rechercher ce nom chez Mojang. Laissez d'abord le joueur rejoindre une fois, puis ajoutez-le, ou modifiez whitelist.json directement via l'onglet Files.
• Permissions : dans LuckPerms par exemple, utilisez toujours le nom complet, point compris, ou attribuez les droits pendant que le joueur est en ligne.
• Modifier le préfixe : c'est possible via username-prefix dans plugins/floodgate/config.yml, mais laissez-le de préférence tel quel. Sans préfixe, vous risquez des conflits de noms entre joueurs Java et Bedrock, et après une modification, les entrées existantes de whitelist et de permissions ne correspondent plus.

Problèmes fréquents

• « Unable to connect to world » sur console — Presque toujours un problème de port : le port Bedrock est injoignable ou mal configuré. Reprenez l'étape 4 et n'oubliez pas qu'il s'agit d'UDP. Vérifiez aussi que la console utilise la dernière version de Minecraft ; sur console, les serveurs externes s'ajoutent via l'onglet Servers, et sur une version obsolète cela ne fonctionne pas toujours.
• Les joueurs Bedrock sont expulsés ou invités à fournir un compte Java — Le type d'authentification est encore sur online. Passez-le sur floodgate (étape 3) et redémarrez. Si la console indique que Geyser ne trouve pas la clé Floodgate, vérifiez que Floodgate est bien chargé et que key.pem existe.
• Erreurs de clé en rejoignant — Des messages comme « Please connect through the official Geyser » signalent une discordance de clés : Geyser utilise une autre key.pem que Floodgate. Supprimez les clés en double ou obsolètes, copiez la même clé partout sur un réseau et redémarrez le tout.
• Des plugins refusent les joueurs Bedrock — Certains plugins valident les noms de joueurs et n'acceptent pas le point. Vérifiez si une mise à jour ou un hook Floodgate est disponible pour ce plugin. En dernier recours seulement, remplacez le préfixe par un caractère que le plugin accepte, puis mettez à jour votre whitelist et vos permissions.

Le crossplay, un atout pour votre serveur

Avec Geyser et Floodgate réunis, tout le monde joue sur un seul serveur : la famille avec une Switch dans le salon et un PC à l'étage, ou le groupe d'amis dont la moitié joue sur console. Plus besoin d'obliger quiconque à acheter un compte Java pour participer. Curieux de connaître les différences entre les deux éditions ? Lisez aussi notre article Java vs Bedrock. Si vous bloquez, l'équipe support de MC-Node vous aide volontiers via un ticket — joignez-y le message d'erreur de votre console.