Crossplay: Bedrock-Spieler (Smartphone, Konsolen, Windows) auf einem Java-Server

Java und Bedrock sind zwei verschiedene Editionen von Minecraft, die von sich aus nicht zusammen spielen können. Das Plugin Geyser übersetzt zwischen ihnen, sodass auch Spieler auf Smartphones, Windows (Bedrock), Xbox, PlayStation oder Switch auf Ihren Java-Server kommen. Mit der Erweiterung Floodgate brauchen sie nicht einmal ein Java-Konto. Diese Anleitung beschreibt die Installation, die Einrichtung des Ports und alle wichtigen Optionen.

So funktionieren Geyser und Floodgate#

Die Java Edition kommuniziert über TCP, die Bedrock Edition über UDP und mit einem völlig anderen Protokoll. Geyser läuft als Plugin auf Ihrem Server, lauscht auf einem UDP-Port auf Bedrock-Spieler und „stellt“ jeden von ihnen dem Server als Java-Spieler vor.

Floodgate setzt vor die Namen von Bedrock-Spielern ein Präfix (standardmäßig einen Punkt, zum Beispiel .Steve123), damit sie nicht mit gleichnamigen Java-Spielern verwechselt werden.

Unterstützte Server und Versionen#

• Servertyp: Paper oder Purpur (Geyser-Spigot), Fabric und NeoForge (Geyser als Mod) oder ein Velocity-Proxy. Unter Vanilla funktioniert Geyser nicht.
• Minecraft-Version: Geyser verbindet sich mit dem Server als Java-Client einer bestimmten Version. Stand 1. Oktober 2026 unterstützt es Java 26.2 und Bedrock 26.30–⁠26.51 (den aktuellen Stand zeigt die Seite Supported versions (öffnet sich in einem neuen Fenster)).
  • Server mit einer älteren Version (Paper oder Purpur 1.20.5 und neuer): Installieren Sie zusätzlich das Plugin ViaVersion. Auf Servern älter als 1.20.5 funktioniert Geyser als Plugin nicht.
  • Server mit einer neueren Version, als Geyser bisher unterstützt (zum Beispiel 26.3): Am zuverlässigsten ist es, auf ein Update von Geyser zu warten (beobachten Sie die Seite Supported versions) oder den neuen Server auf einer unterstützten Version anzulegen. Die Dokumentation von Geyser rechnet mit ViaVersion nur für Server, die älter als die unterstützte Version sind. Das Paar ViaVersion und ViaBackwards kann die Lücke eine Zeit lang überbrücken, das ist aber nicht offiziell dokumentiert – probieren Sie es nur mit einem Backup. Der Katalog in der Registerkarte Plugins bietet Ihnen Geyser für eine solche Version nicht an; Sie würden Geyser-Spigot.jar von Hand von geysermc.org/download (öffnet sich in einem neuen Fenster) hochladen.
  • Geyser als Mod (Fabric, NeoForge) funktioniert nur auf der Version, die Geyser gerade unterstützt.
• UDP-Port: Bedrock verbindet sich über UDP. Die Ports unserer Server funktionieren für TCP und UDP; Sie können also den Spielport oder einen weiteren Port verwenden (siehe unten).

Installation auf Paper und Purpur#

1. Erstellen Sie in der Registerkarte Backups ein Backup des Servers.

2. Öffnen Sie die Registerkarte Plugins › Durchsuchen, wählen Sie als Quelle Modrinth und suchen Sie nach Geyser.

3. Klicken Sie beim Projekt Geyser von GeyserMC auf Installieren und bestätigen Sie.

   Der Katalog zeigt nur Versionen für Ihren Server. Finden Sie Geyser für Ihre Version nicht, unterstützt es sie höchstwahrscheinlich noch nicht (siehe oben).

4. Laden Sie Floodgate für Spigot/Paper von der offiziellen Seite geysermc.org/download (öffnet sich in einem neuen Fenster) auf Ihren Computer herunter (die Datei Floodgate-Spigot.jar). Auf Modrinth gibt es Floodgate nur für Fabric und NeoForge.

5. Öffnen Sie in der Registerkarte Dateien den Ordner plugins und laden Sie die Datei mit der Schaltfläche Hochladen hoch. In der Plugin-Liste wird sie als Manuell hochgeladen markiert (Version und Updates verfolgen Sie dann selbst).

6. Starten Sie den Server neu.

   In der Konsole erscheint die Zeile Started Geyser on 0.0.0.0:19132 (oder Started Geyser on UDP port 19132), und es entstehen die Ordner plugins/Geyser-Spigot und plugins/floodgate (darin die Datei key.pem).

Richten Sie jetzt den Port und Floodgate ein.

Der Port für Bedrock-Spieler#

Standardmäßig lauscht Geyser auf Port 19132. Dieser Port gehört bei StormHost nicht zu Ihrem Server, darüber kann sich also niemand verbinden. Wählen Sie eine von zwei Varianten:

Das Java-Spiel verwendet TCP, Bedrock UDP; deshalb können sie sich dieselbe Portnummer teilen.

Variante A: derselbe Port wie Java#

1. Öffnen Sie in der Registerkarte Dateien die Datei plugins/Geyser-Spigot/config.yml.

2. Setzen Sie im Abschnitt bedrock den Wert clone-remote-port: true:

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

   Ändern Sie den Wert port nicht – mit eingeschaltetem clone-remote-port ersetzt Geyser ihn bei jedem Start durch den Port des Java-Servers.

3. Speichern Sie die Datei (Strg+S).

Variante B: ein eigener Port#

1. Klicken Sie in der Registerkarte Netzwerk unter Weitere Ports auf Port hinzufügen und notieren Sie die neue Nummer.

2. Öffnen Sie in der Registerkarte Dateien die Datei plugins/Geyser-Spigot/config.yml.

3. Tragen Sie im Abschnitt bedrock den neuen Port ein und lassen Sie clone-remote-port ausgeschaltet:

   bedrock:
     address: 0.0.0.0
     port: <PORT>
     clone-remote-port: false

   Ersetzen Sie <PORT> durch die Portnummer aus der Registerkarte Netzwerk, ohne spitze Klammern, zum Beispiel 27015.

4. Speichern Sie die Datei.

Floodgate einrichten#

1. Suchen Sie in plugins/Geyser-Spigot/config.yml den Abschnitt java und setzen Sie auth-type:

   java:
     auth-type: floodgate

   In älteren Versionen von Geyser heißt der Abschnitt remote statt java. Die Einstellung ist dieselbe.

2. Schalten Sie in der Registerkarte Servereigenschaften in der Gruppe Spieler die Option Signierten Chat verlangen aus (enforce-secure-profile=false). Bedrock unterstützt das Signieren des Chats nicht, und Bedrock-Spieler könnten sonst nicht schreiben.

3. Klicken Sie auf Speichern und neu starten.

Die wichtigsten Optionen in der config.yml von Geyser#

Floodgate: config.yml#

Die Datei plugins/floodgate/config.yml:

Verbindung von Bedrock aus#

Bedrock-Spieler geben Adresse und Port getrennt ein (Bedrock verwendet keine SRV-Einträge).

Im Spiel: Spielen › Registerkarte Server › Server hinzufügen, Felder ausfüllen und auf Speichern klicken. Mehr zu Adressen und Domains in der Anleitung Serveradresse und Domain.

Konsolen (Xbox, PlayStation, Switch)#

Konsolen erlauben Verbindungen nur zu ausgewählten Servern. Auf andere Server kommen Spieler über inoffizielle Umwege, typischerweise den Dienst BedrockConnect (Änderung des DNS in den Netzwerkeinstellungen der Konsole) oder Apps, die den Server im lokalen Netzwerk sichtbar machen. Das Vorgehen für die einzelnen Konsolen beschreibt die Dokumentation von Geyser auf der Seite Using Geyser with Consoles (öffnet sich in einem neuen Fenster). Diese Dienste betreiben wir nicht und können ihre Funktion nicht garantieren.

Whitelist und Berechtigungen für Bedrock-Spieler#

• Whitelist: Verwenden Sie den Floodgate-Befehl fwhitelist ohne Präfix:

  fwhitelist add Steve123
  fwhitelist remove Steve123

  • fwhitelist add – fügt einen Bedrock-Spieler der Whitelist hinzu (in whitelist.json).
  • Steve123 – der Xbox-Name des Spielers ohne den führenden Punkt.

  Das normale whitelist add funktioniert für Bedrock-Spieler nicht, weil ihre Namen nicht in der Datenbank der Java-Konten stehen.

• Befehle, die sich auf einen Spieler beziehen (Teleport, Ban), verwenden den Namen einschließlich Präfix, zum Beispiel tp .Steve123.

• LuckPerms: Standardmäßig lehnt LuckPerms Namen mit Punkt ab. Setzen Sie in plugins/LuckPerms/config.yml den Wert allow-invalid-usernames: true und starten Sie den Server neu (LuckPerms).

Geyser auf einem Velocity-Proxy#

In einem Netzwerk von Servern hinter einem Proxy installieren Sie Geyser und Floodgate nur auf dem Proxy. Bedrock-Spieler verbinden sich mit dem Port des Proxys, und der Proxy leitet sie an die Server weiter.

1. Installieren Sie auf Velocity Geyser und Floodgate für Velocity (beides von geysermc.org/download (öffnet sich in einem neuen Fenster)).
2. Stellen Sie in der Konfiguration von Geyser auf dem Proxy den Port ein (Variante A oder B wie oben) und auth-type: floodgate.
3. Setzen Sie in velocity.toml den Wert force-key-authentication = false, sonst können Bedrock-Spieler nicht schreiben.
4. Alle Server hinter dem Proxy müssen einen Java-Client der Version akzeptieren, die Geyser unterstützt – installieren Sie darauf bei Bedarf ViaVersion.

Floodgate brauchen Sie auf den Servern hinter dem Proxy nur, wenn Plugins auf diesen Servern seine Daten nutzen. Schalten Sie dann auf dem Proxy in plugins/floodgate/config.yml (der Unterordner hängt von der Plattform ab) send-floodgate-data: true ein, installieren Sie Floodgate auf den Backends und kopieren Sie key.pem vom Proxy dorthin. Details stehen in der Anleitung Ein Servernetzwerk mit Velocity.

Geyser auf Fabric und NeoForge#

1. Installieren Sie in der Registerkarte Mods › Durchsuchen den Mod Geyser (auf Fabric wird die erforderliche Fabric API automatisch ergänzt).
2. Installieren Sie Floodgate (auf Modrinth gibt es Floodgate für Fabric und NeoForge).
3. Starten Sie den Server neu und stellen Sie Port und auth-type wie oben ein. Die Konfiguration von Geyser liegt in config/Geyser-Fabric/config.yml (auf NeoForge in config/Geyser-NeoForge/config.yml).

Geyser als Mod unterstützt nur eine Minecraft-Version, die neueste unterstützte. Auf einem älteren Server mit Mods können Sie es nicht verwenden.

Überprüfung#

1. Suchen Sie nach dem Neustart in der Konsole die Zeile Started Geyser on … mit Ihrem Port.

2. Führen Sie in der Konsole einen Erreichbarkeitstest aus:

   geyser connectiontest <IP_ADDRESS> <PORT>

   • geyser connectiontest – prüft, ob Geyser von außen erreichbar ist, und schlägt andernfalls vor, was nicht stimmt.
   • <IP_ADDRESS> – die IP-Adresse des Servers aus der Registerkarte Netzwerk.
   • <PORT> – der Bedrock-Port (Variante A: der Spielport, Variante B: Ihr weiterer Port).

3. Prüfen Sie den Server mit dem Werkzeug Minecraft Status im Bedrock-Modus.

4. Verbinden Sie sich von Bedrock aus. Sobald Sie drin sind, zeigt die Konsole eine Zeile, dass der Spieler mit Präfix beigetreten ist, und geyser list zeigt seinen Namen.

Fehlerbehebung#

Bedrock: Unable to connect to world#

Der häufigste Fehler. Gehen Sie die Punkte nacheinander durch:

• Der Spieler hat den falschen Port eingegeben. Variante A: der Spielport, Variante B: der Port aus bedrock.port. Port 19132 funktioniert bei StormHost nicht.
• Geyser läuft nicht auf dem erwarteten Port. Prüfen Sie die Zeile Started Geyser on … in der Konsole.
• Auf demselben UDP-Port läuft etwas anderes (Query, Voice-Chat). Wechseln Sie zu Variante B.
• Führen Sie geyser connectiontest aus (siehe Überprüfung) und folgen Sie seinen Hinweisen.
• Auf dem Smartphone hilft es, das Spiel vollständig zu schließen und erneut zu öffnen.
• Laut Dokumentation von Geyser machen Ports unter 10.000 manchmal Probleme. Wählen Sie nach Möglichkeit einen höheren Port.

Outdated Bedrock client! This server supports the following Bedrock versions: …#

Der Spieler hat eine andere Bedrock-Version, als Geyser unterstützt. Der Spieler aktualisiert das Spiel, oder Sie aktualisieren Geyser (in der Registerkarte Plugins › Nach Updates suchen; ein von Hand hochgeladenes Floodgate müssen Sie von Hand aktualisieren).

This server does not support Java Edition …, which is required for Geyser to connect.#

Die Version des Servers unterscheidet sich von der Version, die Geyser emuliert. Installieren Sie ViaVersion (für einen neueren Server auch ViaBackwards) oder aktualisieren Sie Geyser.

This server requires a paid Java account.#

Geyser hat auth-type: online, oder Floodgate läuft nicht. Installieren Sie Floodgate, setzen Sie auth-type: floodgate und starten Sie neu.

Please log into Xbox to join this server.#

Der Spieler ist im Spiel nicht mit einem Microsoft-Konto angemeldet. Floodgate verlangt ein Xbox-Konto – der Spieler meldet sich in den Einstellungen des Spiels an.

Tried to log in as a Java Edition player! Is Floodgate set up correctly?#

Floodgate läuft auf dem Server nicht oder wurde nicht geladen. Suchen Sie in der Konsole beim Start nach Fehlern von Floodgate und prüfen Sie, ob im Ordner plugins die Datei für Spigot/Paper liegt.

javax.crypto.AEADBadTagException: Tag mismatch!#

Geyser und Floodgate verwenden unterschiedliche Schlüssel. Stoppen Sie den Server, löschen Sie den Ordner plugins/floodgate und eine eventuelle Schlüsseldatei im Ordner von Geyser und starten Sie den Server – es entsteht ein neuer Schlüssel.

Bedrock-Spieler können nicht in den Chat schreiben#

enforce-secure-profile ist eingeschaltet (auf einem Velocity-Proxy force-key-authentication). Schalten Sie es aus und starten Sie neu.

Ein Bedrock-Spieler steht nicht auf der Whitelist#

Fügen Sie ihn mit fwhitelist add <NICK> ohne Punkt hinzu, nicht mit whitelist add.

Weiterführende Links#

• Geyser: Einrichtung auf Paper/Spigot bei einem Hoster (öffnet sich in einem neuen Fenster)
• Unterstützte Versionen von Geyser (öffnet sich in einem neuen Fenster)
• Lösung für „Unable to Connect to World“ (öffnet sich in einem neuen Fenster)
• Floodgate: Einrichtung (öffnet sich in einem neuen Fenster)
• Geyser und das Signieren des Chats (öffnet sich in einem neuen Fenster)