Wie richte ich Floodgate ein, damit Bedrock-Spieler ohne Java-Account joinen können?

Hast du GeyserMC installiert, können Bedrock-Spieler deinen Server bereits finden — aber auf einem Server mit online-mode=true werden sie beim Joinen trotzdem abgewiesen. Geyser übersetzt nämlich nur das Protokoll; die Login-Prüfung erwartet weiterhin einen kostenpflichtigen Java-Account, und den haben Spieler auf Handy, Tablet oder Konsole meist nicht. Floodgate löst das Problem: Bedrock-Spieler werden über ihren eigenen Microsoft/Xbox-Account verifiziert und können so ohne Java-Account sicher joinen, während dein Server ganz normal im Online-Modus bleibt. In diesem Artikel installierst du Floodgate neben Geyser, verknüpfst den Key, stellst den Auth-Typ richtig ein und lernst, wie das Gamertag-Präfix funktioniert.

Schritt 1: Installiere Floodgate neben Geyser

1. Lade Floodgate von der offiziellen GeyserMC-Downloadseite herunter. Wähle dieselbe Plattformvariante wie bei deinem Geyser-Plugin, zum Beispiel floodgate-spigot.jar für einen Paper- oder Spigot-Server.
2. Logge dich im Gamepanel ein, öffne deinen Server und gehe zum Tab Files.
3. Öffne den Ordner plugins und lade die Floodgate-.jar-Datei neben dein Geyser-Plugin hoch.
4. Starte deinen Server über den Tab Console neu. In der Konsole siehst du, dass Floodgate geladen wird; beim ersten Start erstellt das Plugin automatisch die Schlüsseldatei plugins/floodgate/key.pem.

Schritt 2: Prüfe die Key-Verknüpfung zwischen Floodgate und Geyser

Die Datei key.pem ist der geheime Schlüssel, über den Geyser und Floodgate einander vertrauen. Laufen beide als Plugin auf demselben Server, übernimmt Geyser den Key automatisch. So prüfst du das:

1. Öffne im Tab Files die Datei plugins/Geyser-Spigot/config.yml.
2. Prüfe, ob die Zeile floodgate-key-file: key.pem vorhanden ist. Das ist der Standardwert; normalerweise musst du hier nichts ändern.
3. Betreibst du ein Netzwerk mit einem Proxy (BungeeCord oder Velocity)? Kopiere dann plugins/floodgate/key.pem vom Proxy in den Ordner plugins/floodgate/ jedes Backend-Servers. Alle Server müssen exakt denselben Key verwenden, sonst lehnt Floodgate die Logins ab.

Schritt 3: Stelle den Auth-Typ auf floodgate

1. Öffne erneut plugins/Geyser-Spigot/config.yml.
2. Suche im Abschnitt remote: die Zeile auth-type: online und ändere sie in auth-type: floodgate.
3. Speichere die Datei und starte deinen Server über den Tab Console neu.

Ab jetzt übernimmt Floodgate die Verifizierung der Bedrock-Spieler über ihren Xbox-Gamertag. Java-Spieler loggen sich ein wie immer; für sie ändert sich nichts.

Schritt 4: Prüfe UDP-Port 19132

Bedrock verbindet sich über UDP, standardmäßig auf Port 19132. Schau in der config.yml unter bedrock: nach, welcher port: eingestellt ist, und stelle sicher, dass diese Portnummer deinem Server wirklich zugewiesen und offen ist. Ist 19132 bei dir nicht verfügbar, füge einen zusätzlichen Port hinzu — wie das geht, liest du im Artikel über zusätzliche Ports — und trage die Nummer bei port: ein. Bedrock-Spieler verwenden beim Hinzufügen des Servers deine Server-IP plus diese Portnummer.

Das Gamertag-Präfix: Warum Bedrock-Namen mit einem Punkt beginnen

Floodgate setzt standardmäßig einen Punkt (.) vor jeden Bedrock-Gamertag, damit ein Bedrock-Spieler nie exakt denselben Namen hat wie ein bestehender Java-Account. Steve123 auf Bedrock heißt auf deinem Server also .Steve123. Beachte dabei:

• Whitelist: /whitelist add .Steve123 schlägt oft fehl, weil der Server den Namen bei Mojang nachschlagen will. Lass den Spieler erst einmal joinen und füge ihn danach hinzu, oder bearbeite die whitelist.json direkt über den Tab Files.
• Berechtigungen: Verwende zum Beispiel in LuckPerms immer den vollständigen Namen inklusive Punkt, oder vergib Rechte, während der Spieler online ist.
• Präfix anpassen: Das geht über username-prefix in plugins/floodgate/config.yml, aber lass ihn am besten unverändert. Ohne Präfix riskierst du Namenskonflikte zwischen Java- und Bedrock-Spielern, und nach einer Änderung stimmen bestehende Whitelist- und Berechtigungseinträge nicht mehr.

Häufige Probleme

• „Unable to connect to world“ auf Konsolen — Fast immer ein Portproblem: Der Bedrock-Port ist nicht erreichbar oder falsch in der Config eingetragen. Geh Schritt 4 noch einmal durch und denk daran, dass es um UDP geht. Prüfe außerdem, ob die Konsole die neueste Minecraft-Version nutzt; externe Server fügst du auf Konsolen über den Servers-Tab hinzu, und auf einer veralteten Version klappt das nicht immer.
• Bedrock-Spieler werden gekickt oder nach einem Java-Account gefragt — Der Auth-Typ steht noch auf online. Stelle ihn auf floodgate (Schritt 3) und starte neu. Meldet die Konsole, dass Geyser den Floodgate-Key nicht findet, prüfe, ob Floodgate überhaupt geladen wurde und ob key.pem existiert.
• Key-Fehler beim Joinen — Meldungen wie „Please connect through the official Geyser“ deuten auf einen Key-Mismatch hin: Geyser verwendet eine andere key.pem als Floodgate. Entferne doppelte oder alte Keys, kopiere in einem Netzwerk überall denselben Key und starte alles neu.
• Plugins lehnen Bedrock-Spieler ab — Manche Plugins validieren Spielernamen und akzeptieren den Punkt nicht. Prüfe, ob es für das Plugin ein Update oder einen Floodgate-Hook gibt. Ändere das Präfix nur als letzten Ausweg auf ein Zeichen, das das Plugin akzeptiert, und aktualisiere danach deine Whitelist und Berechtigungen.

Crossplay als Trumpf für deinen Server

Mit Geyser und Floodgate zusammen spielen alle auf einem Server: die Familie mit einer Switch im Wohnzimmer und einem PC oben im Arbeitszimmer oder die Freundesgruppe, in der die Hälfte auf Konsole spielt. Niemand muss sich mehr einen Java-Account kaufen, um mitzuspielen. Neugierig auf die Unterschiede zwischen beiden Editionen? Dann lies auch unseren Artikel zu Java vs. Bedrock. Kommst du nicht weiter, hilft dir das MC-Node-Supportteam gern per Ticket — nenne dabei die Fehlermeldung aus deiner Konsole.