Hoe stel ik Floodgate in zodat Bedrock-spelers zonder Java-account kunnen joinen?

Heb je GeyserMC geïnstalleerd, dan kunnen Bedrock-spelers je server al vinden — maar op een server met online-mode=true worden ze bij het joinen alsnog geweigerd. Geyser vertaalt namelijk alleen het protocol; de inlogcontrole verwacht nog steeds een betaald Java-account, en dat hebben spelers op telefoon, tablet of console meestal niet. Floodgate lost dat op: Bedrock-spelers worden geverifieerd via hun eigen Microsoft/Xbox-account, zodat ze zonder Java-account veilig kunnen joinen terwijl je server gewoon in online-mode blijft. In dit artikel installeer je Floodgate naast Geyser, koppel je de key, zet je het auth-type goed en leer je hoe de gamertag-prefix werkt.

Stap 1: Installeer Floodgate naast Geyser

1. Download Floodgate van de officiële GeyserMC-downloadpagina. Kies dezelfde platformvariant als je Geyser-plugin, bijvoorbeeld floodgate-spigot.jar voor een Paper- of Spigot-server.
2. Log in op het gamepaneel, open je server en ga naar het tabblad Files.
3. Open de map plugins en upload het Floodgate-.jar-bestand naast je Geyser-plugin.
4. Herstart je server via het tabblad Console. Je ziet in de console dat Floodgate wordt geladen; bij de eerste start maakt de plugin automatisch het sleutelbestand plugins/floodgate/key.pem aan.

Stap 2: Controleer de key-koppeling tussen Floodgate en Geyser

Het bestand key.pem is de geheime sleutel waarmee Geyser en Floodgate elkaar vertrouwen. Draaien beide als plugin op dezelfde server, dan pakt Geyser de key automatisch op. Zo controleer je het:

1. Open in het tabblad Files het bestand plugins/Geyser-Spigot/config.yml.
2. Controleer dat de regel floodgate-key-file: key.pem aanwezig is. Dit is de standaardwaarde; normaal hoef je hier niets te wijzigen.
3. Draai je een netwerk met een proxy (BungeeCord of Velocity)? Kopieer dan plugins/floodgate/key.pem van de proxy naar de map plugins/floodgate/ van elke backend-server. Alle servers moeten exact dezelfde key gebruiken, anders weigert Floodgate de logins.

Stap 3: Zet het auth-type op floodgate

1. Open opnieuw plugins/Geyser-Spigot/config.yml.
2. Zoek in de sectie remote: de regel auth-type: online en verander die in auth-type: floodgate.
3. Sla het bestand op en herstart je server via het tabblad Console.

Vanaf nu handelt Floodgate de verificatie van Bedrock-spelers af via hun Xbox-gamertag. Java-spelers loggen in zoals altijd; voor hen verandert er niets.

Stap 4: Controleer UDP-poort 19132

Bedrock verbindt via UDP, standaard op poort 19132. Kijk in config.yml onder bedrock: welke port: is ingesteld en zorg dat dat poortnummer echt aan je server is toegewezen en openstaat. Is 19132 bij jou niet beschikbaar, voeg dan een extra poort toe — dat lees je in het artikel over extra poorten — en vul dat nummer in bij port:. Bedrock-spelers gebruiken bij het toevoegen van de server je server-IP plus dit poortnummer.

De gamertag-prefix: waarom Bedrock-namen met een punt beginnen

Floodgate zet standaard een punt (.) voor elke Bedrock-gamertag, zodat een Bedrock-speler nooit exact dezelfde naam heeft als een bestaand Java-account. Steve123 op Bedrock heet op je server dus .Steve123. Houd daar rekening mee:

• Whitelist: /whitelist add .Steve123 mislukt vaak, omdat de server die naam bij Mojang probeert op te zoeken. Laat de speler eerst één keer joinen en voeg hem daarna toe, of bewerk whitelist.json rechtstreeks via het tabblad Files.
• Permissies: gebruik in bijvoorbeeld LuckPerms altijd de volledige naam inclusief de punt, of ken rechten toe terwijl de speler online is.
• Prefix aanpassen: dat kan via username-prefix in plugins/floodgate/config.yml, maar laat hem bij voorkeur staan. Zonder prefix riskeer je naamconflicten tussen Java- en Bedrock-spelers, en na een wijziging kloppen bestaande whitelist- en permissie-vermeldingen niet meer.

Veelvoorkomende problemen

• “Unable to connect to world” op consoles — Bijna altijd een poortprobleem: de Bedrock-poort is niet bereikbaar of staat verkeerd in de config. Controleer stap 4 en let op dat het om UDP gaat. Controleer ook of de console de nieuwste versie van Minecraft draait; externe servers voeg je op consoles toe via de Servers-tab, en op een verouderde versie lukt dat niet altijd.
• Bedrock-spelers worden gekickt of om een Java-account gevraagd — Het auth-type staat nog op online. Zet het op floodgate (stap 3) en herstart. Zie je in de console dat Geyser de Floodgate-key niet vindt, controleer dan of Floodgate wel geladen is en of key.pem bestaat.
• Key-fouten bij het joinen — Meldingen als “Please connect through the official Geyser” wijzen op een key-mismatch: Geyser gebruikt een andere key.pem dan Floodgate. Verwijder dubbele of oude keys, kopieer op een netwerk overal dezelfde key en herstart alles.
• Plugins weigeren Bedrock-spelers — Sommige plugins valideren spelersnamen en accepteren de punt niet. Controleer of er een update of Floodgate-hook beschikbaar is voor die plugin. Pas als laatste redmiddel de prefix aan naar een teken dat de plugin wél accepteert, en werk daarna je whitelist en permissies bij.

Crossplay als troef voor je server

Met Geyser en Floodgate samen speelt iedereen op één server: het gezin met een Switch in de woonkamer en een pc op zolder, of de vriendengroep waarvan de helft op console speelt. Je hoeft niemand meer een Java-account aan te laten schaffen om mee te doen. Benieuwd naar de verschillen tussen beide edities? Lees dan ook ons artikel over Java vs. Bedrock. Kom je er niet uit, dan helpt het MC-Node supportteam je graag verder via een ticket — vermeld daarbij de foutmelding uit je console.