Laat Bedrock-spelers op je Java-server joinen: Geyser + Floodgate instellen (Paper, Velocity)

Wat Geyser en Floodgate doen

Geyser vertaalt tussen de twee edities. Richting je server gedraagt het zich als een Java-client, dus redstone, farms en plugins werken precies zoals voor Java-spelers. Floodgate laat Bedrock-spelers inloggen met hun Xbox-account in plaats van een Java-account.

Voordat je begint: Java en versies

• Geyser heeft Java 21 of nieuwer nodig op de machine waarop het draait.
• Je server moet de nieuwste Java-versie accepteren, omdat Geyser zo’n client nadoet. Oudere servers hebben ViaVersion nodig.
• Geyser-Spigot draait op Paper en Spigot vanaf 1.20.5. Oudere servers hebben een proxy, Geyser Standalone of ViaProxy nodig.
• Alleen actuele Bedrock-versies worden ondersteund (oktober 2026: Bedrock 26.30 tot 26.52, Java 26.2). Houd Geyser up-to-date, want Bedrock werkt zichzelf bij.

Download Geyser en Floodgate voor je platform via de officiële downloadpagina van GeyserMC.

Setup op een losse Paper- of Spigot-server

1. Zet Geyser-Spigot.jar en Floodgate-Spigot.jar in de map plugins.
2. Herstart de server. Geyser maakt plugins/Geyser-Spigot/config.yml aan, Floodgate maakt plugins/floodgate/ aan met config.yml en een key.pem.
3. Open de Geyser-config en controleer het onderdeel bedrock. De port is wat Bedrock-spelers gaan intypen.
4. Zet het authenticatietype op floodgate en herstart opnieuw.

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

java:
  auth-type: floodgate

Oudere Geyser-configs noemen het tweede onderdeel remote, dus daar heet de instelling remote.auth-type. Huidige builds schakelen zelf over naar Floodgate als het op dezelfde server draait; het instellen kan geen kwaad.

Kopieer key.pem op een losse server nergens heen. Geyser leest het uit Floodgate, en een achtergebleven kopie in de Geyser-map veroorzaakt inlogfouten.

Open de Bedrock-poort voor UDP

Java gebruikt TCP, Bedrock gebruikt UDP. De meeste kapotte setups lopen hier vast.

• Hostingpaneel: voeg een extra poort toe (veel hosts noemen dat een allocation) en vul die in als bedrock.port. Sommige hosts eisen dat Bedrock dezelfde poort als Java gebruikt, of veranderen de Java-poort bij elke start; daar laat clone-remote-port: true Geyser de Java-poort gebruiken. De setuppagina van Geyser heeft instructies voor veel hosts.
• Pterodactyl: wijs de poort toe aan de server in het tabblad Network.
• Eigen machine of VPS: open de poort voor UDP in de firewall en thuis ook in de router. OVH en Oracle Cloud blokkeren UDP daarnaast in hun eigen firewall.

sudo ufw allow 19132/udp
sudo ufw reload

Voicechatplugins of query kunnen de poort niet met Geyser delen. Staat de poort open, voer dan geyser connectiontest <ip> <port> uit in de console; dat controleert de poort en stelt oplossingen voor.

Setup op een Velocity- of BungeeCord-netwerk

Op een netwerk verbinden Bedrock-spelers net als Java-spelers met de proxy. Geyser draait daarom alleen op de proxy.

1. Installeer Geyser en Floodgate voor je proxy (Velocity of BungeeCord) en herstart de proxy.
2. Stel in de Geyser-config op de proxy de bedrock.port en het authenticatietype floodgate in, en open de poort voor UDP zoals hierboven beschreven.
3. Installeer Floodgate-Spigot op elke backend. Dat is nodig voor plugins die de Floodgate-API gebruiken en verbetert skins.
4. Stel forwarding in: zet op BungeeCord ip_forward: true in de config.yml en bungeecord: true in de spigot.yml van elke backend; stel op Velocity player information forwarding in zoals beschreven in de Velocity-docs.
5. Zet in de Floodgate-config op de proxy send-floodgate-data: true.
6. Kopieer key.pem uit de Floodgate-map van de proxy naar de Floodgate-map van elke backendserver, en herstart daarna de backends en de proxy.

send-floodgate-data: true

Houd key.pem geheim: daarmee kunnen accounts langs de Java-authenticatie. Upload het via FTP in binaire modus, anders krijg je Tag mismatch-fouten.

Bedrock-namen: het puntprefix

Floodgate zet een prefix vóór elke Bedrock-naam, zodat die nooit met een Java-naam kan botsen. De standaard is een punt, dus de Xbox-gamertag Steve wordt .Steve op je server. Spaties in gamertags worden vervangen door _.

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

• Gebruik in commando’s de volledige naam met prefix. Accepteert een commando die niet, zet de naam dan tussen aanhalingstekens: /tp ".Steve".
• Gebruik voor de whitelist fwhitelist add Steve. Daar is de prefix niet nodig.
• Heeft LuckPerms moeite met Bedrock-namen, zet dan allow-invalid-usernames: true in de config.

GeyserMC raadt aan de prefix te houden. Bedrock-spelers stemmen ook met deze naam: op BestMCServerList vullen ze .Steve in, de naam die je stembeloningsplugin ziet.

Gekoppelde accounts en skins (optioneel)

Global Linking staat standaard aan in Floodgate. Spelers die beide edities hebben, joinen link.geysermc.org met beide accounts en typen /linkaccount. Daarna spelen ze vanaf elk apparaat met hun Java-inventaris en -locatie, dus ze moeten hun Bedrock-items eerst verplaatsen. Een lokale koppeldatabase heeft een extra Floodgate-extensie nodig.

Floodgate zet Bedrock-skins om en uploadt ze, zodat Java-spelers ze zien. Dat gaat via een wachtrij en kan even duren.

Veelvoorkomende fouten en oplossingen

Sommige dingen zijn niet te vertalen: links- en rechtsklikken in inventories zien er hetzelfde uit, commando’s zonder Brigadier krijgen geen tabaanvulling en links in de chat zijn niet klikbaar. Test menu’s met een echt Bedrock-apparaat. Plugins kunnen via de Floodgate-API native Bedrock-formulieren tonen; daarvoor moet Floodgate op hun server staan.

Toon beide adressen op BestMCServerList

Bedrock-spelers verbinden met je adres plus de Bedrock-poort, bijvoorbeeld play.example.net en 19132. BestMCServerList toont het Java- en Bedrock-adres apart op elke serverpagina, elk met een kopieerknop.

1. Open Voeg je server toe en vul je Java-adres in.
2. Vink Bedrock-spelers worden ondersteund aan.
3. Vul de Bedrock-poort in uit bedrock.port. Laat het Bedrock-IP leeg als het hetzelfde is als het Java-adres.

Crossplay is een echt voordeel voor een nieuwe server. Kijk bij hoe je spelers krijgt voor een nieuwe server voor de rest van het plan.