Crossplay: Bedrock-spelers (mobiel, consoles, Windows) op een Java-server

Java en Bedrock zijn twee verschillende edities van Minecraft die van zichzelf niet met elkaar kunnen spelen. De plugin Geyser vertaalt tussen de twee, zodat ook spelers op mobiel, Windows (Bedrock), Xbox, PlayStation of Switch verbinding kunnen maken met jouw Java-server. Met de aanvulling Floodgate hebben ze daarvoor geen Java-account nodig. We laten de installatie zien, het instellen van de poort en elke belangrijke optie.

Hoe Geyser en Floodgate werken#

Java Edition communiceert via het TCP-protocol, Bedrock Edition via UDP en in een heel andere taal. Geyser draait als plugin op je server, luistert op een UDP-poort naar Bedrock-spelers en “presenteert” elk van hen aan de server als Java-speler.

Floodgate zet een prefix voor de namen van Bedrock-spelers (standaard een punt, bijvoorbeeld .Steve123), zodat ze niet worden verward met Java-spelers met dezelfde naam.

Ondersteunde servers en versies#

• Servertype: Paper of Purpur (Geyser-Spigot), Fabric en NeoForge (Geyser als mod) of een Velocity-proxy. Op Vanilla werkt Geyser niet.
• Minecraft-versie: Geyser maakt verbinding met de server als Java-client van één specifieke versie. Per 1 oktober 2026 ondersteunt Geyser Java 26.2 en Bedrock 26.30–⁠26.51 (de actuele stand staat op de pagina Supported versions (opent in een nieuw venster)).
  • Server op een oudere versie (Paper of Purpur 1.20.5 en nieuwer): installeer daarnaast de plugin ViaVersion. Op een server ouder dan 1.20.5 werkt Geyser niet als plugin.
  • Server op een nieuwere versie dan Geyser nu aankan (bijvoorbeeld 26.3): het betrouwbaarst is wachten op een update van Geyser (houd de pagina Supported versions in de gaten), of de nieuwe server op een ondersteunde versie aanmaken. De documentatie van Geyser gaat alleen uit van ViaVersion voor servers die ouder zijn dan de ondersteunde versie. De combinatie van de plugins ViaVersion en ViaBackwards kan het gat tijdelijk overbruggen, maar is niet officieel beschreven. Probeer die alleen met een back-up. De catalogus op het tabblad Plugins biedt Geyser voor zo'n versie niet aan, het bestand Geyser-Spigot.jar zou je handmatig uploaden vanaf geysermc.org/download (opent in een nieuw venster).
  • Geyser als mod (Fabric, NeoForge) werkt alleen op de versie die Geyser op dat moment ondersteunt.
• UDP-poort: Bedrock maakt verbinding via UDP. De poorten van je server werken bij ons voor zowel TCP als UDP, dus je kunt de gamepoort gebruiken of een extra poort (zie hieronder).

Installeren op Paper en Purpur#

1. Maak een back-up van de server op het tabblad Back-ups.

2. Open het tabblad Plugins › Bladeren, kies de bron Modrinth en zoek naar Geyser.

3. Klik bij het project Geyser van GeyserMC op Installeren en bevestig.

   De catalogus toont alleen versies voor jouw server. Vind je Geyser niet voor jouw versie, dan ondersteunt Geyser die waarschijnlijk nog niet (zie hierboven).

4. Download Floodgate voor Spigot/Paper naar je computer vanaf de officiële pagina geysermc.org/download (opent in een nieuw venster) (het bestand Floodgate-Spigot.jar). Op Modrinth staat Floodgate alleen voor Fabric en NeoForge.

5. Open op het tabblad Bestanden de map plugins en upload het bestand met de knop Uploaden. In de lijst met plugins krijgt het bestand het label Handmatig geüpload (de versie en updates houd je dan zelf bij).

6. Herstart de server.

   In de console zie je de regel Started Geyser on 0.0.0.0:19132 (of Started Geyser on UDP port 19132) en de mappen plugins/Geyser-Spigot en plugins/floodgate (met daarin het bestand key.pem) worden aangemaakt.

Stel nu de poort en Floodgate in.

De poort voor Bedrock-spelers#

Standaard luistert Geyser op poort 19132. Die poort hoort bij ons niet bij jouw server, dus niemand kan er verbinding mee maken. Kies een van de twee varianten:

Het Java-spel gebruikt TCP en Bedrock UDP, daarom kunnen ze hetzelfde poortnummer delen.

Variant A: dezelfde poort als Java#

1. Open op het tabblad Bestanden het bestand plugins/Geyser-Spigot/config.yml.

2. Stel in de sectie bedrock de waarde clone-remote-port: true in:

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

   Wijzig de waarde port niet: met clone-remote-port ingeschakeld vervangt Geyser die bij elke start door de poort van de Java-server.

3. Sla het bestand op (Ctrl+S).

Variant B: een aparte poort#

1. Klik op het tabblad Netwerk in het gedeelte Extra poorten op Poort toevoegen en onthoud het nieuwe nummer.

2. Open op het tabblad Bestanden het bestand plugins/Geyser-Spigot/config.yml.

3. Vul in de sectie bedrock de nieuwe poort in en laat clone-remote-port uitgeschakeld:

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

   Vervang <PORT> door het poortnummer van het tabblad Netwerk, zonder de punthaken, bijvoorbeeld 27015.

4. Sla het bestand op.

Floodgate instellen#

1. Zoek in plugins/Geyser-Spigot/config.yml de sectie java en stel auth-type in:

   java:
     auth-type: floodgate

   In oudere versies van Geyser heet de sectie remote in plaats van java. De instelling is hetzelfde.

2. Schakel op het tabblad Serverinstellingen in de groep Spelers de optie Ondertekende chat vereisen uit (enforce-secure-profile=false). Bedrock ondersteunt het ondertekenen van chatberichten niet en Bedrock-spelers zouden anders niet kunnen chatten.

3. Klik op Opslaan en herstarten.

De belangrijkste opties in de config.yml van Geyser#

Floodgate: config.yml#

Het bestand plugins/floodgate/config.yml:

Verbinden vanuit Bedrock#

Bedrock-spelers vullen het adres en de poort apart in (Bedrock gebruikt geen SRV-records).

In het spel: Play › tabblad Servers › Add Server, vul de velden in en kies Save. Meer over adressen en domeinen lees je in de handleiding Serveradres en domein.

Consoles (Xbox, PlayStation, Switch)#

Consoles staan alleen verbindingen met geselecteerde servers toe. Op andere servers komen spelers via een onofficiële omweg, meestal de dienst BedrockConnect (de DNS wijzigen in de netwerkinstellingen van de console) of apps die de server in het lokale netwerk beschikbaar maken. De stappen per console staan in de documentatie van Geyser op de pagina Using Geyser with Consoles (opent in een nieuw venster). Wij beheren deze diensten niet en garanderen niet dat ze werken.

Whitelist en rechten voor Bedrock-spelers#

• Whitelist: gebruik het Floodgate-commando fwhitelist zonder de prefix:

  fwhitelist add Steve123
  fwhitelist remove Steve123

  • fwhitelist add – zet een Bedrock-speler op de whitelist (in whitelist.json).
  • Steve123 – de Xbox-naam van de speler zonder punt aan het begin.

  Het gewone whitelist add werkt niet voor Bedrock-spelers, omdat hun namen niet in de database van Java-accounts staan.

• Commando's gericht op spelers (teleport, ban) typ je met de naam inclusief prefix, bijvoorbeeld tp .Steve123.

• LuckPerms: namen met een punt weigert LuckPerms standaard. Stel in plugins/LuckPerms/config.yml de waarde allow-invalid-usernames: true in en herstart de server (LuckPerms).

Geyser op een Velocity-proxy#

In een netwerk van servers achter een proxy installeer je Geyser en Floodgate alleen op de proxy. Bedrock-spelers maken verbinding met de poort van de proxy en de proxy verdeelt ze over de servers.

1. Installeer op Velocity Geyser en Floodgate voor Velocity (beide van geysermc.org/download (opent in een nieuw venster)).
2. Stel in de configuratie van Geyser op de proxy de poort in (variant A of B zoals hierboven) en auth-type: floodgate.
3. Stel in velocity.toml de waarde force-key-authentication = false in, anders kunnen Bedrock-spelers niet chatten.
4. Alle servers achter de proxy moeten een Java-client accepteren van de versie die Geyser ondersteunt. Installeer er zo nodig ViaVersion op.

Floodgate op de servers achter de proxy heb je alleen nodig als plugins op die servers de gegevens ervan gebruiken. Schakel dan op de proxy in plugins/floodgate/config.yml (de submap hangt af van het platform) send-floodgate-data: true in, installeer Floodgate op de backends en kopieer key.pem van de proxy ernaartoe. Meer lees je in de handleiding Een servernetwerk met Velocity.

Geyser op Fabric en NeoForge#

1. Installeer op het tabblad Mods › Bladeren de mod Geyser (bij Fabric wordt de verplichte Fabric API automatisch toegevoegd).
2. Installeer Floodgate (op Modrinth beschikbaar voor zowel Fabric als NeoForge).
3. Herstart de server en stel de poort en auth-type in zoals hierboven. De configuratie van Geyser staat in het bestand config/Geyser-Fabric/config.yml (bij NeoForge config/Geyser-NeoForge/config.yml).

Geyser als mod ondersteunt maar één Minecraft-versie: de nieuwste ondersteunde. Op een oudere gemodde server kun je Geyser niet gebruiken.

Controle#

1. Zoek na de herstart in de console de regel Started Geyser on … met jouw poort.

2. Voer in de console de bereikbaarheidstest uit:

   geyser connectiontest <IP_ADDRESS> <PORT>

   • geyser connectiontest – controleert of Geyser van buitenaf bereikbaar is en geeft zo nodig aan wat er mis is.
   • <IP_ADDRESS> – het IP-adres van de server van het tabblad Netwerk.
   • <PORT> – de Bedrock-poort (variant A: de gamepoort, variant B: je extra poort).

3. Controleer de server met de tool Minecraft Status in de Bedrock-modus.

4. Maak verbinding vanuit Bedrock. Daarna zie je in de console een regel dat de speler met de prefix verbinding heeft gemaakt, en met het commando geyser list zie je zijn naam.

Als iets niet werkt#

Bedrock: Unable to connect to world#

De meest voorkomende fout. Loop deze punten een voor een na:

• De speler heeft de verkeerde poort ingevuld. Variant A: de gamepoort, variant B: de poort uit bedrock.port. Poort 19132 werkt bij ons niet.
• Geyser draait niet op de poort die je verwacht. Controleer in de console de regel Started Geyser on ….
• Op dezelfde UDP-poort draait iets anders (Query, voicechat). Stap over op variant B.
• Voer geyser connectiontest uit (zie Controle) en volg het advies op.
• Sluit op mobiel het spel helemaal af en open het opnieuw.
• Volgens de documentatie van Geyser geven poorten onder 10.000 soms problemen. Kies als het kan een hogere poort.

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

De speler heeft een andere Bedrock-versie dan Geyser ondersteunt. De speler werkt het spel bij, of jij werkt Geyser bij (op het tabblad Plugins › Controleren op updates; een handmatig geüploade Floodgate werk je handmatig bij).

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

De versie van de server wijkt af van de versie die Geyser emuleert. Installeer ViaVersion (bij een nieuwere server ook ViaBackwards) of werk Geyser bij.

This server requires a paid Java account.#

Geyser heeft auth-type: online of Floodgate draait niet. Installeer Floodgate, stel auth-type: floodgate in en herstart.

Please log into Xbox to join this server.#

De speler is in het spel niet ingelogd met een Microsoft-account. Floodgate vereist een Xbox-account. De speler logt in via de instellingen van het spel.

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

Floodgate draait niet op de server of is niet geladen. Zoek in de console bij het opstarten naar fouten van Floodgate en controleer of in de map plugins het bestand voor Spigot/Paper staat.

javax.crypto.AEADBadTagException: Tag mismatch!#

Geyser en Floodgate gebruiken een verschillende sleutel. Stop de server, verwijder de map plugins/floodgate en een eventueel sleutelbestand in de map van Geyser en start de server. De sleutel wordt opnieuw aangemaakt.

Bedrock-spelers kunnen niet chatten#

enforce-secure-profile staat aan (op een Velocity-proxy force-key-authentication). Schakel het uit en herstart.

Een Bedrock-speler staat niet op de whitelist#

Voeg de speler toe met het commando fwhitelist add <NICK> zonder punt, niet met het commando whitelist add.

Meer bronnen#

• Geyser: instellen op Paper/Spigot bij een hostingprovider (opent in een nieuw venster)
• Ondersteunde versies van Geyser (opent in een nieuw venster)
• “Unable to Connect to World” oplossen (opent in een nieuw venster)
• Floodgate: instellen (opent in een nieuw venster)
• Geyser en het ondertekenen van chat (opent in een nieuw venster)