Installer Geyser + Floodgate pour crossplay Java/Bedrock sur serveur Minecraft Paper

Votre serveur Minecraft Paper accueille déjà la communauté Java. Mais vos amis sur Xbox, Nintendo Switch, PlayStation, iOS/Android ou Windows 10/11 Bedrock ne peuvent pas se connecter ? Avec Geyser + Floodgate, vous activez le crossplay complet : tous les joueurs sur le même serveur, peu importe l’édition. Voici la procédure.

Pas de serveur Paper encore ? Voir Installer un serveur Minecraft Paper.

Comprendre Geyser et Floodgate

Geyser

Geyser est un proxy/bridge qui traduit le protocole Bedrock vers Java en temps réel. Côté Bedrock, le joueur croit se connecter à un serveur Bedrock — en réalité Geyser fait le pont vers votre serveur Paper.

Floodgate

Floodgate est le compagnon de Geyser. Il permet aux joueurs Bedrock de rejoindre sans posséder un compte Java payant. Sans Floodgate, vos joueurs Xbox/mobile devraient acheter Minecraft Java en plus de leur version Bedrock.

Résultat

• ✅ Joueurs Java : connexion normale, port 25565
• ✅ Joueurs Bedrock : connexion via port 19132, sans compte Java
• ✅ Mêmes mondes, même chat, même économie
• ✅ Compatible plugins Java (avec quelques exceptions liées au menu)

Pré-requis

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

Geyser

Depuis geysermc.org/download :

• Projet : Geyser
• Plateforme : Spigot (compatible Paper)
• Téléchargez Geyser-Spigot.jar

Floodgate

Toujours sur geysermc.org/download :

• Projet : Floodgate
• Plateforme : Spigot
• Téléchargez floodgate-spigot.jar

Téléchargez les deux ensemble — ils doivent être à jour mutuellement.

Étape 2 : Uploader les plugins

1. Arrêtez le serveur (stop dans la console)
2. SFTP ou File Manager du panel → naviguer vers plugins/ à la racine du serveur
3. Upload des deux .jar :
   • Geyser-Spigot.jar
   • floodgate-spigot.jar
4. Démarrez le serveur

Au premier lancement, Geyser et Floodgate génèrent leurs dossiers de config :

plugins/
├── Geyser-Spigot/
│   ├── config.yml          ← config Geyser
│   ├── locales/
│   └── packs/
└── floodgate/
    ├── config.yml          ← config Floodgate
    └── key.pem             ← clé d'authentification (À NE PAS PARTAGER)

🔐 Sécurité critique : key.pem est la clé d’authentification Floodgate. Ne la partagez jamais — quelqu’un avec votre clé peut spoofer des joueurs Bedrock sur votre serveur.

Étape 3 : Configurer Geyser (auth-type)

Arrêtez le serveur, éditez plugins/Geyser-Spigot/config.yml :

bedrock:
  # Adresse d'écoute Bedrock (0.0.0.0 = toutes les interfaces)
  address: 0.0.0.0
  # Port d'écoute Bedrock (par défaut 19132)
  port: 19132
  clone-remote-port: false
  # Nom du serveur affiché côté Bedrock (LAN browser)
  motd1: "Mon serveur Paper"
  motd2: "Crossplay actif"

remote:
  # Adresse Java côté serveur (auto = utilise server.properties)
  address: auto
  port: 25565
  # ⭐ Crucial pour Floodgate
  auth-type: floodgate

# Préfixe ajouté devant les pseudos Bedrock (pour les distinguer en chat)
# . par défaut → ".PseudoBedrock"
floodgate-key-file: key.pem

Le auth-type: floodgate est la valeur clé. Sans ça, Floodgate ne sert à rien.

Étape 4 : Configurer Floodgate

plugins/floodgate/config.yml :

# Préfixe devant les pseudos Bedrock (défaut: .)
# Affichera ".PseudoBedrock" en chat
username-prefix: "."

# Remplace les espaces des pseudos Bedrock par _
replace-spaces: true

# Si key.pem doit être régénérée (laisser false en prod)
# key-file-name: key.pem

# Clés UUID pour les joueurs Bedrock (laisser par défaut)
player-link:
  enabled: false

Si vous activez player-link.enabled: true, vos joueurs peuvent lier leur compte Bedrock à leur compte Java (utile pour la transition graduelle).

Étape 5 : Ouvrir le port 19132 UDP

Auto-hébergement (chez vous)

Routeur → Redirection de ports :

• Port externe : 19132
• Protocole : UDP
• IP locale du serveur
• Port interne : 19132

Pare-feu Windows : autoriser Java entrant sur 19132 UDP.

Sur Linux (UFW) :

sudo ufw allow 19132/udp

Hébergeur dédié

Sur HebergTonServ ou la plupart des panels, le port 19132 est ouvert automatiquement quand vous installez Geyser. Vérifiez dans votre panel section “Ports alloués”.

Étape 6 : Démarrer et tester

1. Lancez le serveur, surveillez la console
2. Au démarrage Geyser affiche :

   [Geyser] Geyser is running on 0.0.0.0:19132
   [Geyser] Done (X.Xs)! Run /geyser help for help!

3. Floodgate :

   [floodgate] Loaded Floodgate config

Tester depuis Bedrock

Sur PC Windows 10/11 Bedrock

1. Lancer Minecraft Bedrock
2. Jouer → onglet Serveurs → Ajouter un serveur
3. Nom : Mon serveur
4. Adresse : IP_DU_SERVEUR
5. Port : 19132
6. Sauvegarder → Rejoindre

Sur Xbox / Switch / PlayStation

Plus restrictif. Microsoft/Sony/Nintendo bloquent les serveurs custom par défaut côté console. Solutions :

• BedrockConnect : DNS gratuit qui redirige vos consoles vers une liste de serveurs custom. Configurez le DNS de votre console sur 104.238.130.180, puis dans Minecraft choisissez un serveur de la liste Featured Servers modifiée
• App ServerPing (Android/iOS) : permet la connexion directe

Sur mobile (Android / iOS)

1. Minecraft Bedrock → Jouer → onglet Serveurs
2. Ajouter un serveur
3. Adresse, port 19132 → Rejoindre

Tester depuis Java (vérifier que ça marche toujours)

Connexion normale sur port 25565. Geyser ne change rien côté Java.

Étape 7 (optionnel) : ViaVersion pour les anciennes versions Java

Geyser supporte la dernière version Java. Si votre Paper est sur une version Java plus ancienne (ex: 1.20.1), installez ViaVersion pour permettre aux Bedrock récents de rejoindre :

1. Téléchargez ViaVersion.jar depuis hangar.papermc.io/ViaVersion/ViaVersion
2. Placez dans plugins/
3. Redémarrez

En 2026, Paper 1.21+ avec Geyser à jour ne nécessite généralement plus ViaVersion. Vérifiez les notes de version Geyser au cas par cas.

FAQ

Mes joueurs Bedrock voient “Impossible de se connecter au monde”

Causes fréquentes :

• Port 19132 UDP non ouvert (vérifier routeur + pare-feu)
• Geyser pas démarré (vérifier console)
• Mauvaise IP/port côté client Bedrock
• Conflit de port avec un autre service (VoiceChat, Query)

auth-type: floodgate ignoré, on me demande un compte Java

Solutions :

• Vérifier que Floodgate est bien dans plugins/ (commande /plugins doit l’afficher en vert)
• Vérifier config.yml Geyser : la ligne doit être auth-type: floodgate (pas online ni offline)
• Redémarrer le serveur après modification

Les pseudos Bedrock apparaissent avec un point devant (.PseudoBedrock)

Comportement attendu : username-prefix: "." dans floodgate/config.yml. Mettez "" (vide) pour retirer le préfixe, mais attention aux collisions avec des pseudos Java existants.

Peut-on partager un compte Java côté Bedrock ?

Non. Avec player-link.enabled: true un joueur peut lier son compte Bedrock à un compte Java existant — mais il ne peut pas connecter deux clients en simultané sur la même identité.

Les plugins Java fonctionnent-ils pour les Bedrock ?

La plupart oui (LuckPerms, EssentialsX, WorldGuard, économie). Quelques exceptions :

• Plugins avec GUI custom complexes (anvils, beacons custom) : rendu limité côté Bedrock
• Plugins réseau comme BungeeCord/Velocity : compatible mais nécessite config supplémentaire

Skins Bedrock visibles côté Java ?

Oui, Floodgate transmet le skin Bedrock vers Java automatiquement.

Peut-on activer Geyser sur un serveur Vanilla (sans Paper) ?

Oui, Geyser propose une version Standalone (proxy externe). Mais Paper reste recommandé pour la simplicité et les performances.

Erreur Bedrock port already in use

Un autre service utilise 19132 (souvent Query Minecraft ou un autre proxy). Changez :

bedrock:
  port: 19133

Vos joueurs Bedrock se connecteront alors sur 19133.

Comment limiter l’accès Bedrock à certains joueurs ?

Whitelist Paper standard fonctionne :

whitelist on
whitelist add .PseudoBedrock
whitelist add PseudoJava

Les Bedrock doivent être ajoutés avec leur préfixe (. par défaut).

Performances : Geyser fait-il chuter le TPS ?

Très peu sur un serveur normal (~50-100 Mo RAM, <1% CPU). Sur des serveurs énormes (200+ joueurs Bedrock simultanés), envisagez Geyser Standalone sur un proxy séparé pour découpler la charge.

Conclusion

Vous avez maintenant un serveur Paper avec crossplay Java/Bedrock complet. Étapes suivantes :

1. Plugins essentiels : voir Top plugins Minecraft 2026
2. Anti-cheat côté Java (Matrix, Vulcan) — peu de cheats côté Bedrock
3. Tester avec un ami sur chaque plateforme avant ouverture publique
4. Promouvoir votre serveur sur les listes Java ET Bedrock (DoubleDouble effet d’audience)

Pour aller plus loin

• Hébergeur Minecraft pas cher dès 6,00€/mois
• Installer un serveur Minecraft Paper + transfert monde solo
• Documentation officielle GeyserMC
• Documentation Floodgate
• Download GeyserMC