Bedrock-Spieler auf deinen Java-Server lassen: Geyser + Floodgate einrichten (Paper, Velocity)

Was Geyser und Floodgate machen

Geyser übersetzt zwischen den beiden Editionen. Gegenüber deinem Server verhält es sich wie ein Java-Client, deshalb funktionieren Redstone, Farmen und Plugins genau wie für Java-Spieler. Floodgate lässt Bedrock-Spieler mit ihrem Xbox-Konto rein, statt mit einem Java-Konto.

Bevor du anfängst: Java und Versionen

• Geyser braucht Java 21 oder neuer auf der Maschine, auf der es läuft.
• Dein Server muss die neueste Java-Version annehmen, weil Geyser einen solchen Client nachahmt. Ältere Server brauchen ViaVersion.
• Geyser-Spigot läuft auf Paper und Spigot ab 1.20.5. Ältere Server brauchen einen Proxy, Geyser Standalone oder ViaProxy.
• Unterstützt werden nur aktuelle Bedrock-Versionen (Oktober 2026: Bedrock 26.30 bis 26.52, Java 26.2). Halte Geyser aktuell, denn Bedrock aktualisiert sich selbst.

Geyser und Floodgate für deine Plattform lädst du von der offiziellen GeyserMC-Downloadseite.

Einrichtung auf einem einzelnen Paper- oder Spigot-Server

1. Leg Geyser-Spigot.jar und Floodgate-Spigot.jar in den Ordner plugins.
2. Starte den Server neu. Geyser legt plugins/Geyser-Spigot/config.yml an, Floodgate den Ordner plugins/floodgate/ mit config.yml und einer key.pem.
3. Öffne die Geyser-Config und prüf den Abschnitt bedrock. Der port ist das, was Bedrock-Spieler eintippen.
4. Stell die Authentifizierung auf floodgate und starte noch einmal neu.

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

java:
  auth-type: floodgate

In älteren Geyser-Configs heißt der zweite Abschnitt remote, die Einstellung also remote.auth-type. Aktuelle Versionen schalten von selbst auf Floodgate um, wenn es auf demselben Server läuft; setzen schadet trotzdem nicht.

Auf einem einzelnen Server kopierst du die key.pem nirgendwohin. Geyser liest sie direkt bei Floodgate, und eine übrig gebliebene Kopie im Geyser-Ordner führt zu Login-Fehlern.

Den Bedrock-Port für UDP öffnen

Java nutzt TCP, Bedrock nutzt UDP. An dieser Stelle scheitern die meisten Einrichtungen.

• Hosting-Panel: Leg einen zusätzlichen Port an (viele Hoster nennen das Allocation) und trag ihn als bedrock.port ein. Manche Hoster verlangen für Bedrock denselben Port wie für Java oder ändern den Java-Port bei jedem Start; dort sorgt clone-remote-port: true dafür, dass Geyser den Java-Port nimmt. Die Geyser-Setup-Seite hat Anleitungen für viele Hoster.
• Pterodactyl: Weise den Port dem Server im Tab „Network“ zu.
• Eigener Rechner oder VPS: Öffne den Port für UDP in der Firewall und zu Hause zusätzlich im Router. OVH und Oracle Cloud blocken UDP außerdem in ihrer eigenen Firewall.

sudo ufw allow 19132/udp
sudo ufw reload

Voice-Chat-Plugins oder Query können sich den Port nicht mit Geyser teilen. Wenn der Port offen ist, führ geyser connectiontest <ip> <port> in der Konsole aus; der Befehl prüft den Port und schlägt Lösungen vor.

Einrichtung im Netzwerk mit Velocity oder BungeeCord

Im Netzwerk verbinden sich Bedrock-Spieler genau wie Java-Spieler mit dem Proxy. Geyser läuft deshalb nur auf dem Proxy.

1. Installiere Geyser und Floodgate für deinen Proxy (Velocity oder BungeeCord) und starte den Proxy neu.
2. Setz in Geysers Config auf dem Proxy den bedrock.port und die Authentifizierung floodgate, und öffne den Port wie oben für UDP.
3. Installiere Floodgate-Spigot auf jedem Backend. Das ist für Plugins mit der Floodgate-API nötig und verbessert die Skins.
4. Richte die Weiterleitung ein: Bei BungeeCord ip_forward: true in dessen config.yml und bungeecord: true in der spigot.yml jedes Backends; bei Velocity die Weiterleitung der Spielerinfos so, wie es die Velocity-Doku beschreibt.
5. Setz in Floodgates Config auf dem Proxy send-floodgate-data: true.
6. Kopier die key.pem aus dem Floodgate-Ordner des Proxys in den Floodgate-Ordner jedes Backend-Servers und starte danach Backends und Proxy neu.

send-floodgate-data: true

Halte die key.pem geheim: Mit ihr kommen Konten an der Java-Anmeldung vorbei. Lade sie per FTP im Binärmodus hoch, sonst gibt es Tag mismatch-Fehler.

Bedrock-Namen: das Punkt-Präfix

Floodgate setzt vor jeden Bedrock-Namen ein Präfix, damit er nie mit einem Java-Namen kollidiert. Standard ist ein Punkt, aus dem Xbox-Gamertag Steve wird auf deinem Server also .Steve. Leerzeichen im Gamertag werden durch _ ersetzt.

username-prefix: "."
replace-spaces: true

• In Befehlen nutzt du den vollen Namen mit Präfix. Nimmt ein Befehl ihn nicht an, setz den Namen in Anführungszeichen: /tp ".Steve".
• Für die Whitelist gibt es fwhitelist add Steve. Das Präfix brauchst du dort nicht.
• Hat LuckPerms Probleme mit Bedrock-Namen, setz allow-invalid-usernames: true in dessen Config.

GeyserMC rät, das Präfix zu behalten. Bedrock-Spieler voten auch mit diesem Namen: Auf BestMCServerList tragen sie .Steve ein, also den Namen, den dein Vote-Belohnungs-Plugin sieht.

Verknüpfte Konten und Skins (optional)

Global Linking ist in Floodgate standardmäßig an. Wer beide Editionen besitzt, joint link.geysermc.org mit beiden Konten und tippt /linkaccount. Danach spielt er auf beiden Geräten mit Inventar und Position des Java-Kontos, sollte seine Bedrock-Items also vorher umräumen. Eine eigene Verknüpfungsdatenbank braucht eine zusätzliche Floodgate-Erweiterung.

Floodgate wandelt Bedrock-Skins um und lädt sie hoch, damit Java-Spieler sie sehen. Das läuft über eine Warteschlange und kann eine Weile dauern.

Typische Fehler und Lösungen

Manches lässt sich gar nicht übersetzen: Links- und Rechtsklick sehen in Inventaren gleich aus, Befehle ohne Brigadier haben keine Tab-Vervollständigung, Links im Chat sind nicht klickbar. Teste Menüs mit einem echten Bedrock-Gerät. Plugins können über die Floodgate-API echte Bedrock-Formulare zeigen; dafür muss Floodgate auf ihrem Server laufen.

Beide Adressen auf BestMCServerList zeigen

Bedrock-Spieler verbinden sich mit deiner Adresse plus Bedrock-Port, zum Beispiel play.example.net und 19132. BestMCServerList zeigt auf jeder Serverseite Java- und Bedrock-Adresse getrennt an, jeweils mit Kopierknopf.

1. Öffne Server eintragen und gib deine Java-Adresse ein.
2. Setz den Haken bei Bedrock-Spieler werden unterstützt.
3. Trag den Bedrock-Port aus bedrock.port ein. Die Bedrock-IP lässt du leer, wenn sie der Java-Adresse entspricht.

Crossplay ist für einen neuen Server ein echter Vorteil. Den Rest des Plans findest du unter Spieler für einen neuen Server finden.