Geyser + Floodgate : crossplay Bedrock <-> Java sur ton serveur Minecraft

Introduction

Geyser est un proxy traduisant le protocole Bedrock vers Java en temps réel. Floodgate, du même éditeur (GeyserMC), permet aux joueurs Bedrock de se connecter sans avoir besoin d'un compte Java — c'est ce qui transforme un "petit hack technique" en vraie fonctionnalité communautaire utilisable.

Sur ton serveur Minecraft VeryCloud avec panel Wisp, l'installation prend 10 minutes.

Prérequis

• Un serveur Minecraft Paper, Spigot ou Velocity actif chez VeryCloud
• Accès au gestionnaire Files du panel Wisp
• Une allocation UDP libre (port Bedrock par défaut : 19132)

Étape 1 : Allouer le port Bedrock

Dans Wisp :

1. Ouvre Network sur ton serveur Minecraft
2. Create Allocation → port 19132/udp
3. Si tu veux personnaliser, n'importe quel port UDP fonctionne mais 19132 est le port que les clients Bedrock testent en premier

💡 Le trafic Bedrock est UDP, pas TCP comme Java. Bien vérifier le protocole.

Étape 2 : Télécharger Geyser et Floodgate

Selon ton serveur :

Type serveur	Geyser variant	Floodgate variant
Paper / Spigot	Geyser-Spigot.jar	floodgate-spigot.jar
Velocity	Geyser-Velocity.jar	floodgate-velocity.jar
BungeeCord	Geyser-BungeeCord.jar	floodgate-bungee.jar

Téléchargement officiel : https://geysermc.org/download

Étape 3 : Uploader les plugins

Dans Wisp → Files :

1. Va dans /plugins/
2. Drag & drop ou Upload : Geyser-Spigot.jar (ou variant) et floodgate-spigot.jar
3. Sauvegarde

Étape 4 : Premier démarrage

Restart le serveur depuis la console. Au boot, Geyser et Floodgate génèrent leurs fichiers de config dans :

/plugins/Geyser-Spigot/config.yml
/plugins/floodgate/config.yml
/plugins/floodgate/key.pem  <-- IMPORTANT : clé partagée

Étape 5 : Configurer Geyser

Édite /plugins/Geyser-Spigot/config.yml :

bedrock:
  address: 0.0.0.0
  port: 19132
  clone-remote-port: false
  motd1: "VeryCloud MC"
  motd2: "Java + Bedrock crossplay"
  server-name: "VeryCloud"

remote:
  # Auto = pointe vers le serveur Java local
  address: auto
  port: 0
  auth-type: floodgate

passthrough-motd: false
passthrough-player-counts: true

Les points clés :

• bedrock.port doit matcher l'allocation UDP créée à l'étape 1
• remote.auth-type: floodgate active l'auth sans compte Java
• passthrough-player-counts: true : la liste serveur Bedrock affiche le vrai nombre de joueurs

Étape 6 : Configurer Floodgate

Édite /plugins/floodgate/config.yml :

key-file-name: key.pem
username-prefix: "."
replace-spaces: true
disconnect:
  invalid-key: "Floodgate key invalid"
  invalid-arguments-length: "Internal Floodgate error"

Le username-prefix: "." ajoute un . devant le pseudo des joueurs Bedrock. Ils apparaîtront comme .PseudoBedrock côté Java. Permet d'éviter les conflits de pseudos.

⚠️ Si tu utilises un proxy (Velocity, BungeeCord), key.pem doit être partagé entre tous les serveurs backend. Copie-le sur chaque serveur dans /plugins/floodgate/key.pem.

Étape 7 : Test de connexion

Depuis Minecraft Bedrock (mobile, console, Win10/11) :

1. Multijoueur → Servers → Add server
2. Server Address : IP_VERYCLOUD
3. Port : 19132
4. Save puis Join

Tu devrais te connecter et apparaître dans la liste serveur Java avec le prefix ..

Étape 8 : Ressources packs Bedrock (optionnel)

Si tu utilises un resource pack Java, configure la conversion dans Geyser :

emote-offhand-workaround: "disabled"
cache-images: 2
allow-custom-skulls: true

Pour des packs custom Bedrock natifs, place-les dans /plugins/Geyser-Spigot/packs/.

Dépannage

Les joueurs Bedrock ne voient pas le serveur

• Port 19132 UDP bien forwardé et alloué
• Geyser bien démarré (regarde la console : Started Geyser on...)
• Test depuis un autre réseau (la 4G mobile par exemple)

"Could not connect to server" côté Bedrock

• Géo-restriction Microsoft sur les serveurs externes : le joueur doit être connecté à un compte Microsoft dans son client Bedrock
• Le port n'est peut-être pas réellement ouvert. Test avec un outil comme MCStatus

Les pseudos Bedrock entrent en conflit avec des joueurs Java existants

• Configure un username-prefix plus distinctif dans Floodgate
• Ou active replace-spaces pour éviter les espaces dans les pseudos

Performances qui chutent à la connexion Bedrock

• Geyser convertit chaque paquet : c'est consommateur. Si tu as beaucoup de joueurs Bedrock, alloue plus de RAM/CPU au serveur

Commandes utiles

# Recharger Geyser sans restart serveur
/geyser reload

# Voir les joueurs Bedrock connectes
/geyser dump

# Stats Floodgate
/floodgate

Conclusion

Avec Geyser + Floodgate, ton serveur Minecraft VeryCloud accepte les joueurs Bedrock sans qu'ils aient besoin d'acheter Minecraft Java. C'est la meilleure manière d'élargir ta communauté en 2026, surtout sur des serveurs casual ou orientés famille.

Pour aller plus loin : Geyser sur Velocity (config multi-serveur), packs custom Bedrock, monitoring du conversion overhead.

Ressources

• GeyserMC — Official Website
• Geyser GitHub
• Floodgate GitHub
• Geyser Wiki — Setup