[Mod] Geyser [1.16.5 – 26.2]

GeyserMC, souvent appelé simplement Geyser, est un proxy qui permet aux joueurs de Minecraft Bedrock Edition de rejoindre un serveur Minecraft Java Edition. Il sert de passerelle entre les deux éditions du jeu en traduisant les échanges réseau entre le client Bedrock et le serveur Java.

Son intérêt est simple : permettre à des joueurs sur PC Java, mobile, console ou Windows Bedrock de jouer ensemble sur un même serveur Java, lorsque la configuration le permet. Geyser ne transforme pas le serveur Java en serveur Bedrock complet, mais il rend possible une connexion entre deux éditions qui ne sont normalement pas compatibles entre elles.

Ce guide explique à quoi sert GeyserMC, comment il fonctionne, quelles versions installer selon votre serveur, et quelles limites connaître avant de l’utiliser. Il s’adresse surtout aux administrateurs de serveurs Java qui veulent ouvrir leur serveur aux joueurs Bedrock.

Qu’est-ce que GeyserMC ?

GeyserMC est un projet open source conçu pour réduire la séparation entre Minecraft Java Edition et Minecraft Bedrock Edition. En temps normal, un joueur Bedrock ne peut pas rejoindre directement un serveur Java, car les deux éditions n’utilisent pas les mêmes protocoles réseau ni les mêmes systèmes de fonctionnement.

Geyser agit comme une couche de traduction. Le joueur Bedrock se connecte à Geyser, puis Geyser communique avec le serveur Java. Le joueur voit donc le serveur depuis Bedrock, tandis que le serveur Java reçoit une connexion traduite par Geyser.

Cette solution est surtout utile pour les serveurs communautaires, les petits serveurs privés ou les réseaux qui veulent accueillir davantage de joueurs sans créer un serveur Bedrock séparé.

Comment fonctionne Geyser ?

Le principe de Geyser repose sur la traduction des paquets réseau entre les deux éditions de Minecraft. Lorsqu’un joueur Bedrock se connecte, Geyser reçoit ses actions, les convertit dans un format compréhensible par le serveur Java, puis renvoie les réponses du serveur Java vers le client Bedrock.

Cette traduction permet de rejoindre un serveur Java depuis Bedrock, mais elle ne rend pas les deux éditions parfaitement identiques. Certaines différences de gameplay, d’interface, d’entités ou de mécaniques peuvent subsister.

Geyser fonctionne uniquement côté serveur ou proxy. Les joueurs Bedrock n’ont pas besoin d’installer un mod sur leur appareil. Ils se connectent depuis le menu multijoueur de Minecraft Bedrock, comme avec un serveur classique.

Quelle version de Geyser choisir ?

Geyser existe sous plusieurs formes. Le bon choix dépend du type de serveur que vous utilisez.

• Geyser-Spigot : pour les serveurs Spigot, Paper et forks compatibles.
• Geyser-Velocity : pour les réseaux utilisant Velocity.
• Geyser-BungeeCord : pour les réseaux BungeeCord ou Waterfall.
• Geyser-Fabric : pour les serveurs moddés Fabric compatibles.
• Geyser-NeoForge : pour les serveurs moddés NeoForge compatibles.
• Geyser Standalone : version autonome lancée séparément du serveur.

Sur un serveur Paper ou Spigot classique, la version plugin est généralement la plus simple à installer. Sur un réseau avec proxy, Geyser doit être installé au bon endroit, généralement sur le proxy, afin de centraliser les connexions Bedrock. Sur un serveur moddé Fabric ou NeoForge, Geyser s’installe comme un mod dans le dossier mods.

Avant de télécharger Geyser, vérifiez toujours la plateforme utilisée par votre serveur. Installer la mauvaise version peut empêcher le plugin ou le mod de se charger correctement.

Geyser et Floodgate : quelle différence ?

Geyser permet à un client Bedrock de rejoindre un serveur Java. Floodgate, lui, gère un autre besoin : permettre aux joueurs Bedrock de rejoindre un serveur Java avec leur compte Bedrock, sans devoir posséder un compte Minecraft Java Edition.

Sans Floodgate, un serveur configuré en mode authentifié peut demander une authentification Java. Avec Floodgate, les joueurs Bedrock peuvent être identifiés correctement côté serveur, avec un préfixe ou une gestion dédiée selon la configuration choisie.

En pratique, si vous êtes administrateur d’un serveur Java et que vous voulez accueillir facilement des joueurs Bedrock, il est souvent recommandé d’utiliser Geyser + Floodgate. Geyser gère la passerelle Java/Bedrock, tandis que Floodgate améliore l’authentification et l’intégration des joueurs Bedrock.

Attention : Floodgate s’installe en complément de Geyser. Il ne remplace pas Geyser et ne sert pas, seul, à connecter Minecraft Bedrock à un serveur Java.

Prérequis avant l’installation

Avant d’installer Geyser, vérifiez plusieurs points importants.

• Vous devez posséder un serveur Minecraft Java Edition fonctionnel.
• Votre serveur doit utiliser une version compatible avec Geyser.
• Si votre serveur utilise une version Java plus ancienne, un plugin comme ViaVersion peut être nécessaire.
• Vous devez pouvoir accéder aux fichiers du serveur.
• Vous devez pouvoir ouvrir un port UDP pour les connexions Bedrock.
• Si vous utilisez un hébergeur, vérifiez qu’il autorise Geyser et les ports Bedrock.

Le port Bedrock par défaut est :

19132

Contrairement au port Java classique 25565, Geyser utilise un port UDP pour recevoir les connexions Bedrock. Il ne suffit donc pas toujours d’ouvrir le port Java existant : il faut vérifier la configuration réseau de votre serveur ou de votre hébergeur.

Installer Geyser sur un serveur Paper, Spigot ou Velocity

Pour un serveur Paper, Spigot ou Velocity, l’installation de Geyser se fait comme celle d’un plugin classique.

1. Téléchargez la version de Geyser adaptée à votre plateforme : Spigot/Paper, Velocity ou BungeeCord.
2. Placez le fichier .jar dans le dossier plugins de votre serveur ou de votre proxy.
3. Redémarrez le serveur.
4. Ouvrez le fichier de configuration généré par Geyser.
5. Vérifiez l’adresse, le port Bedrock et les paramètres de connexion au serveur Java.

Sur un serveur Paper ou Spigot, le fichier de configuration se trouve généralement dans :

/plugins/Geyser-Spigot/config.yml

Sur Velocity ou BungeeCord, le nom du dossier dépend de la version de Geyser utilisée.

Dans la configuration, la partie la plus importante concerne la section bedrock :

bedrock:
  address: 0.0.0.0
  port: 19132
  clone-remote-port: false

address indique l’adresse sur laquelle Geyser écoute les connexions Bedrock. Dans la majorité des cas, 0.0.0.0 convient.

port indique le port utilisé par les joueurs Bedrock pour rejoindre le serveur. Par défaut, il s’agit de 19132.

clone-remote-port peut être utilisé dans certains cas d’hébergement où le port Bedrock doit suivre le port Java. Ne l’activez pas sans comprendre la configuration de votre hébergeur.

Installer Geyser sur un serveur Fabric ou NeoForge

Geyser peut aussi être installé sur certains serveurs moddés, notamment avec Fabric ou NeoForge. Dans ce cas, il ne s’installe pas dans le dossier plugins, mais dans le dossier mods du serveur.

1. Téléchargez la version de Geyser compatible avec votre loader.
2. Placez le fichier .jar dans le dossier mods du serveur.
3. Si vous utilisez Fabric, installez aussi Fabric API si la version utilisée le demande.
4. Redémarrez le serveur.
5. Ouvrez le fichier de configuration généré par Geyser.

Les fichiers de configuration sont généralement placés dans :

/config/Geyser-Fabric/config.yml

ou :

/config/Geyser-NeoForge/config.yml

La configuration du port Bedrock reste la même que pour la version plugin. Le port par défaut est 19132 et doit accepter le trafic UDP.

Attention : Geyser fonctionne uniquement avec les mods côté serveur. Les mods qui demandent une installation côté client Java ne seront pas utilisables par les joueurs Bedrock de la même manière qu’un joueur Java moddé.

Utiliser Geyser en mode autonome

La version Standalone de Geyser fonctionne séparément du serveur. Elle peut être utile dans certains cas précis, notamment pour faire tourner Geyser à part, sur une autre machine, ou pour tester une configuration sans l’installer directement comme plugin.

Le principe est le suivant :

1. Téléchargez la version Standalone de Geyser.
2. Créez un dossier dédié à Geyser.
3. Lancez le fichier .jar avec Java.
4. Configurez le fichier config.yml.
5. Relancez Geyser.

Le lancement peut se faire avec une commande de ce type :

java -jar Geyser-Standalone.jar

La version autonome demande un peu plus de configuration, car Geyser ne se trouve pas directement dans le serveur Java. Il faut donc indiquer correctement l’adresse et le port du serveur Java à rejoindre.

Cette solution est surtout utile aux utilisateurs avancés. Pour un serveur Paper, Spigot, Velocity, Fabric ou NeoForge, il est généralement plus simple d’utiliser la version directement adaptée à votre plateforme.

Configurer Geyser

Après le premier lancement, Geyser génère un fichier config.yml. Ce fichier contient les paramètres principaux de la passerelle Bedrock/Java.

Les réglages les plus importants concernent généralement :

• le port Bedrock utilisé par les joueurs ;
• l’adresse du serveur Java ;
• le port du serveur Java ;
• l’utilisation ou non de Floodgate ;
• les paramètres liés au proxy, si vous utilisez Velocity ou BungeeCord.

Exemple simplifié :

bedrock:
  address: 0.0.0.0
  port: 19132

remote:
  address: auto
  port: 25565
  auth-type: online

bedrock.port correspond au port que les joueurs Bedrock utiliseront pour se connecter. remote.port correspond au port du serveur Java.

Si vous utilisez Floodgate, le type d’authentification doit être configuré selon les indications du wiki Geyser/Floodgate. Ne modifiez pas ces options au hasard, car une mauvaise configuration peut empêcher les joueurs Bedrock de rejoindre le serveur.

Se connecter depuis Minecraft Bedrock

Une fois Geyser installé et configuré, les joueurs Bedrock peuvent rejoindre le serveur depuis le menu multijoueur de Minecraft Bedrock Edition.

Depuis Minecraft Bedrock :

1. Ouvrez l’onglet Serveurs.
2. Choisissez Ajouter un serveur.
3. Indiquez l’adresse IP ou le nom de domaine du serveur.
4. Indiquez le port Bedrock configuré dans Geyser, généralement 19132.
5. Validez, puis connectez-vous.

Si vous jouez sur le même réseau local que le serveur, Geyser peut parfois apparaître dans l’onglet Amis comme serveur local. Si ce n’est pas le cas, ajoutez-le manuellement depuis l’onglet Serveurs.

Pour une connexion locale, l’adresse peut être l’adresse IPv4 locale du serveur. Pour une connexion depuis l’extérieur, les joueurs devront utiliser l’adresse IP publique ou le nom de domaine du serveur, avec le port Bedrock ouvert en UDP.

Ouvrir le port Bedrock

Pour que des joueurs Bedrock extérieurs à votre réseau puissent rejoindre le serveur, le port utilisé par Geyser doit être accessible depuis internet.

Par défaut, il s’agit du port :

19132 UDP

Dans l’interface de votre box ou de votre hébergeur, vérifiez que ce port est ouvert en UDP. Ce point est important : ouvrir uniquement le port TCP ne suffit pas pour Minecraft Bedrock.

Sur un serveur auto-hébergé, il faut généralement créer une redirection de port vers l’adresse IP locale de la machine qui héberge Geyser. Sur un hébergeur, le port doit être autorisé depuis le panel ou demandé au support si l’option n’est pas disponible.

Limites à connaître

Geyser améliore fortement la compatibilité entre Java et Bedrock, mais il ne peut pas supprimer toutes les différences entre les deux éditions.

Plusieurs limites peuvent apparaître :

• certaines mécaniques Java peuvent se comporter différemment côté Bedrock ;
• les interfaces de certains plugins peuvent ne pas être parfaitement adaptées ;
• les serveurs très moddés ne sont pas toujours compatibles avec les joueurs Bedrock ;
• les mods qui exigent une installation côté client Java ne fonctionneront pas comme prévu pour un joueur Bedrock ;
• les textures, entités ou comportements très spécifiques peuvent nécessiter une configuration supplémentaire.

Geyser est donc surtout adapté aux serveurs Java classiques, aux serveurs Paper/Spigot, aux réseaux proxy et à certains serveurs moddés côté serveur. Pour un modpack Java complet avec des dizaines de mods côté client, il ne faut pas s’attendre à une compatibilité parfaite avec Bedrock.

Problèmes fréquents

Les joueurs Bedrock ne voient pas le serveur

Vérifiez que Geyser est bien lancé, que le port Bedrock est correctement configuré et que le port UDP est ouvert. Si le serveur n’apparaît pas dans l’onglet Amis, ajoutez-le manuellement dans l’onglet Serveurs.

La connexion échoue depuis l’extérieur

Le problème vient souvent du port. Vérifiez que le port 19132 est bien ouvert en UDP, que l’adresse IP est correcte et que le pare-feu ne bloque pas Java ou Geyser.

Le joueur Bedrock doit posséder un compte Java

Si vous voulez permettre aux joueurs Bedrock de rejoindre le serveur avec leur compte Bedrock, installez et configurez Floodgate en complément de Geyser.

Le serveur utilise une ancienne version de Minecraft Java

Selon la version du serveur et la version actuelle de Geyser, il peut être nécessaire d’utiliser ViaVersion pour permettre la compatibilité avec les clients récents.

Les joueurs Bedrock ont des bugs d’affichage ou de gameplay

Certaines différences entre Bedrock et Java ne peuvent pas être traduites parfaitement. Vérifiez les limitations connues de Geyser et évitez les mécaniques ou plugins trop dépendants de comportements propres à Java.

Geyser ne fonctionne pas avec mon serveur moddé

Geyser fonctionne principalement avec des éléments côté serveur. Si votre serveur nécessite des mods installés côté client Java, les joueurs Bedrock ne pourront pas reproduire cette configuration de la même manière. Dans ce cas, la compatibilité dépend fortement du modpack utilisé.

Faut-il installer Geyser sur tous les serveurs d’un réseau ?

Sur un réseau utilisant un proxy comme Velocity ou BungeeCord, Geyser doit généralement être installé sur le proxy plutôt que sur chaque serveur backend. Cela permet aux joueurs Bedrock d’entrer par le même point d’accès que les joueurs Java.

Floodgate peut, selon la configuration, être installé sur plusieurs serveurs pour améliorer la gestion des skins, des API ou des permissions. Pour un réseau complexe, il est préférable de suivre précisément la documentation officielle de Geyser et Floodgate afin d’éviter les erreurs d’authentification.

Téléchargement de Geyser