Een handleiding over het installeren en configureren van Geyser en Floodgate, zodat Minecraft: Bedrock Edition-spelers kunnen joinen op jouw Java Edition-server. Deze handleiding behandelt Spigot/Paper, Fabric, NeoForge, BungeeCord, Velocity, ViaProxy, en de standalone build.
Geyser is een brug die vertaalt tussen de twee edities van Minecraft. Het zorgt ervoor dat jouw Java Edition-server voor een Bedrock-client eruitziet als een Bedrock-server, wat betekent dat spelers op telefoons, tablets, consoles en de Windows 10/11-editie kunnen joinen op een server die ze anders niet zouden kunnen zien. Floodgate is de begeleider hiervan, en zorgt ervoor dat deze Bedrock-spelers binnenkomen zonder een Java Edition-account te bezitten.
Requirements
- Een Minecraft: Java Edition-server waarvan je de bestanden zelf beheert. Een host die je geen jars laat uploaden kan Geyser niet draaien.
- Java 21 of nieuwer, wat huidige Minecraft-serversoftware sowieso vereist.
- Een UDP-poort die je kunt openen en forwarden. Bedrock Edition gebruikt UDP, niet TCP, en dit is het meest voorkomende dat mensen fout doen.
- Als je een gedeelde host gebruikt, controleer of ze een tweede poort toestaan. Sommige geven je er maar één.
How Geyser and Floodgate Work Together
Ik wil kort uitleggen hoe de twee plugins samenwerken, want het installeren van de ene zonder de andere kan ertoe leiden dat Bedrock-spelers niet goed kunnen verbinden (bijvoorbeeld doordat ze alsnog hun Java-account moeten koppelen).
Geyser doet de Java <-> Bedrock-vertaling. Het luistert op een UDP-poort, accepteert Bedrock-verbindingen, en spreekt aan de andere kant het Java Edition-protocol met jouw server. Op zichzelf laat Geyser een Bedrock-speler verbinden, maar die speler moet dan nog steeds authenticeren als een Java Edition-account, wat de meeste Bedrock-spelers niet hebben.
Floodgate haalt die vereiste weg. Het vertelt de Java-server om een speler te accepteren die door Geyser is goedgekeurd, zonder een Java-account nodig te hebben. Daarom worden de twee bijna altijd samen geïnstalleerd, en daarom levert Floodgate een key.pem-bestand mee waarvan je vrij nadrukkelijk te horen krijgt dat je het niet moet delen. Die sleutel is wat een account in staat stelt om Java-authenticatie over te slaan.
Geyser wordt eenmalig geïnstalleerd, op de plek waar jouw Bedrock-spelers naartoe verbinden. Floodgate wordt geïnstalleerd op de server die de spelerslijst beheert. Bij één server is dat dezelfde machine. Bij een proxynetwerk gaan Geyser en Floodgate allebei op de proxy.
Downloading
Alles komt van de officiële downloadpagina. We raden af om dit ergens anders te downloaden.
Op het moment van schrijven zijn de huidige builds Geyser build #1234 (2 september 2026) en Floodgate build #140 (9 augustus 2026). Beide projecten publiceren continu, dus de buildnummers die jij ziet zullen hoger zijn. Dat is normaal en te verwachten.
Which File Do I Need?
Geyser publiceert een build voor elk platform. Floodgate niet, en dat zorgt bij mensen voor verwarring:
| Platform | Geyser | Floodgate |
|---|---|---|
| Spigot / Paper | Geyser-Spigot.jar |
floodgate-spigot.jar |
| Fabric | Geyser-Fabric.jar |
floodgate-fabric.jar |
| NeoForge | Geyser-NeoForge.jar |
floodgate-neoforge.jar |
| BungeeCord | Geyser-BungeeCord.jar |
floodgate-bungee.jar |
| Velocity | Geyser-Velocity.jar |
floodgate-velocity.jar |
| ViaProxy | Geyser-ViaProxy.jar |
Niet beschikbaar |
| Standalone | Geyser-Standalone.jar |
Niet beschikbaar |
Er is geen Floodgate-build voor ViaProxy of voor standalone Geyser. Floodgate moet draaien binnen de Java-server die de spelerslijst beheert, en in die twee opstellingen draait Geyser extern. Je installeert de platformspecifieke Floodgate-jar op de Java-server waar je Geyser naartoe wijst, en kopieert vervolgens het key.pem-bestand van die server naar Geyser. Verderop staat hier een sectie over.
Direct Download Links
Deze URL's verwijzen altijd naar de nieuwste build, dus je kunt ze veilig bookmarken of gebruiken in scripts!
- Spigot
- Fabric
- NeoForge
- BungeeCord
- Velocity
- ViaProxy
- Standalone
- Floodgate Spigot
- Floodgate Bungee
- Floodgate Velocity
Op een Linux-server kun je er direct eentje binnenhalen:
wget -O plugins/Geyser-Spigot.jar \
https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/spigot
Installing Geyser
Kies de ene sectie die past bij jouw serveropstelling. Je hoeft alleen de instructies voor die opstelling te volgen.
Spigot & Paper
- Download
Geyser-Spigot.jar. - Plaats het in de
plugins/-map van jouw server. - Herstart de server. Gebruik geen
/reload, want plugin-reloads veroorzaken meer problemen dan ze oplossen. - Geyser genereert zijn config op
plugins/Geyser-Spigot/config.yml.
Fabric
- Download
Geyser-Fabric.jar. - Plaats het in de
mods/-map van je server. - Fabric-servers hebben ook de Fabric API-mod nodig in dezelfde map.
- Herstart de server. De config verschijnt op
config/Geyser-Fabric/config.yml.
NeoForge
- Download
Geyser-NeoForge.jar. - Plaats het in de
mods/-map van je server. - Herstart de server. De config verschijnt op
config/Geyser-NeoForge/config.yml.
BungeeCord
Installeer Geyser op de proxy, niet op de backend-servers. De proxy is waar Bedrock-spelers verbinding mee maken.
- Download
Geyser-BungeeCord.jar. - Plaats het in de
plugins/-map van de proxy. - Herstart de proxy. De config verschijnt op
plugins/Geyser-BungeeCord/config.yml.
Velocity
Hetzelfde idee als BungeeCord. Geyser komt op de proxy.
- Download
Geyser-Velocity.jar. - Plaats het in de
plugins/-map van de proxy. - Herstart de proxy. De config verschijnt op
plugins/Geyser-Velocity/config.yml.
ViaProxy
ViaProxy is een standalone proxy waarmee clients op de ene Minecraft-versie verbinding kunnen maken met een server op een andere. Geyser koppelt zich hieraan als addon.
- Download
Geyser-ViaProxy.jar. - Plaats het in de
plugins/-map van ViaProxy. - Start ViaProxy één keer op zodat Geyser zijn config genereert, en stop het daarna weer.
- Omdat Geyser hier buiten je Java-server draait, moet je aangeven waar die server zich bevindt. Zie The Remote Section.
Standalone
Standalone is Geyser dat als eigen programma draait, op zichzelf, gericht op een Java-server via het netwerk. Het is de juiste keuze wanneer je geen plugins of mods op de server zelf kunt installeren, en in vrijwel alle andere gevallen de verkeerde keuze, omdat het een extra netwerkstap toevoegt en zonder extra configuratie geen Floodgate kan gebruiken.
- Download
Geyser-Standalone.jar. - Plaats het in een eigen map.
- Voer het uit:
java -Xmx1G -jar Geyser-Standalone.jar
- Het genereert
config.ymlnaast zichzelf en sluit vervolgens af of wacht. Stop het, bewerk de config, en start het opnieuw.
Geyser Configureren
Open de config.yml voor jouw platform. De twee secties die ertoe doen zijn bedrock en, bij standalone en ViaProxy, remote.
De Bedrock-sectie
Dit is waar Bedrock-spelers verbinding mee maken:
bedrock:
# The IP address that will listen for connections.
# Generally, you should only change this if you want to limit what IPs can connect to your server.
address: 0.0.0.0
# The port that will Geyser will listen on for incoming Bedrock connections.
# Since Minecraft: Bedrock Edition uses UDP, this port must allow UDP traffic.
port: 19132
# Some hosting services change your Java port everytime you start the server and require the same port to be used for Bedrock.
# This option makes the Bedrock port the same as the Java port every time you start the server.
clone-remote-port: false
De poort is het onderdeel dat ertoe doet. 19132 is de standaardpoort van Bedrock Edition, en als je die zo laat staan, kunnen spelers je server toevoegen met alleen het adres, zonder een poort te hoeven typen. Verander het alleen als 19132 al bezet is of als je host je iets anders toewijst.
clone-remote-port is bedoeld voor hosts die je bij elke herstart een nieuwe poort geven en verwachten dat Bedrock-verkeer op diezelfde poort binnenkomt. Als je dit inschakelt, overschrijft het de port-waarde hierboven, dus beide instellen en je afvragen waarom je poort genegeerd wordt is een valkuil die het waard is om te kennen.
address: 0.0.0.0 betekent "luister op elke netwerkinterface", wat is wat je wilt tenzij je bewust de toegang wilt beperken.
De Remote-sectie (Alleen Standalone en ViaProxy)
Wanneer Geyser als plugin of mod draait, weet het al waar de server zich bevindt, omdat het zich erin bevindt. Wanneer het standalone of onder ViaProxy draait, moet je de remote-sectie configureren om naar je Java-server te verwijzen.
remote:
address: 127.0.0.1
port: 25565
auth-type: floodgate
Gebruik 127.0.0.1 (localhost) als de Java-server op dezelfde machine draait. Gebruik het echte adres als dat niet zo is, en besef dat je zojuist een onversleutelde Minecraft-verbinding op het netwerk tussen de twee hebt gezet.
Floodgate Installeren
Floodgate hoort op de Minecraft Java-server geplaatst te worden die de spelerslijst beheert.
Spigot & Paper
- Download
floodgate-spigot.jarvan de downloadpagina. - Plaats het in de
plugins/-map. - Herstart de server.
Fabric & NeoForge
- Download de mod van de Modrinth-pagina of de downloadpagina.
- Plaats het bestand in de
mods/-map. Fabric-servers hebben ook de Fabric API nodig, geïnstalleerd op de server. - Herstart de server.
Als de Fabric-server achter een Velocity-proxy zit, moet je ook FabricProxyLite configureren zodat de Fabric-server doorgestuurde spelersgegevens van Velocity accepteert.
BungeeCord & Velocity
Installeer Floodgate alleen op de proxy. Je hebt het niet nodig op de backend-servers, tenzij je daar specifiek de Floodgate API wilt gebruiken, of je wilt dat Bedrock-skins correct worden weergegeven op de backend.
- Download
floodgate-bungee.jaroffloodgate-velocity.jar. - Plaats het bestand in de
plugins/-map van de proxy. - Herstart de proxy.
auth-type Instellen Op floodgate
Dit is de stap die Bedrock-spelers daadwerkelijk toelaat, en veel mensen slaan deze stap per ongeluk over (inclusief mezelf, toen ik jaren geleden voor het eerst Geyser en Floodgate installeerde, haha).
Open het configuratiebestand van Geyser (niet dat van Floodgate), zoek de auth-type-sleutel, en zet deze op floodgate:
auth-type: floodgate
De drie waarden die het accepteert zijn:
floodgate- Bedrock-spelers doen mee zonder een Java Edition-account. Dit is wat je wilt, en het vereist dat Floodgate is geïnstalleerd.online- elke speler moet een Java Edition-account bezitten en authenticeren. Dit is de standaardwaarde.offline- helemaal geen authenticatie. Niet aanbevolen op publieke servers.
Herstart de server nadat je wijzigingen hebt toegepast. Geyser leest deze instelling bij het opstarten van de server.
Floodgate Achter Een Proxy Draaien
Als je een proxy hebt met backend-servers erachter, en je wilt dat de Floodgate API op die backends beschikbaar is, moet je nog het een en ander doen. Sla deze sectie volledig over als je maar één server hebt.
- Installeer Floodgate eerst op de proxy, zoals hierboven beschreven.
- Installeer Floodgate ook op elke backendserver, met
floodgate-spigot.jaroffloodgate-fabric.jar. - Schakel het doorsturen van spelerinformatie in:
- BungeeCord: zet
ip_forwardoptruein deconfig.ymlvan de proxy, en zetbungeecordoptruein despigot.ymlvan elke backend. - Velocity: stel player information forwarding in. Velocity heeft meerdere modi en elke modus vereist een andere configuratie op de backend, dus volg hun handleiding in plaats van te gokken.
- BungeeCord: zet
- Start de proxy zodat Floodgate zijn bestanden aanmaakt.
- Zet in de Floodgate-config van de proxy
send-floodgate-dataoptrue. - Kopieer het bestand
key.pemvan de Floodgate-configmap van de proxy naar de Floodgate-configmap van elke backendserver. - Herstart de backends en de proxy.
WAARSCHUWING: Zoals eerder gezegd, deel key.pem met niemand, en plak het niet in een supportkanaal wanneer je om hulp vraagt. Dat bestand is wat Bedrock-accounts in staat stelt om Java Edition-authenticatie te omzeilen. Iedereen die een kopie in handen heeft, kan in principe als vrijwel iedereen op je server inloggen als diegene daartoe in staat is.
Dezelfde key.pem-kopie is hoe je Floodgate gebruikt met standalone Geyser of met ViaProxy. Installeer de platformspecifieke Floodgate-jar op de Java-server en kopieer vervolgens het key.pem-bestand van die server naar de eigen configmap van Geyser.
De poort openen
Bedrock Edition gebruikt UDP. Als je alleen TCP opent, verschijnt de server niet in de serverlijst voor Bedrock-clients.
Op een Linux-server kun je dit meestal doen via de geïnstalleerde firewall.
# IPTables (underlying firewall used by ufw on many Linux distributions)
iptables -A INPUT -p udp --dport 19132 -j ACCEPT
# UFW (Uncomplicated Firewall)
sudo ufw allow 19132/udp
# Firewalld (used by many Linux distributions)
sudo firewall-cmd --permanent --add-port=19132/udp
sudo firewall-cmd --reload
Als je thuis host, moet je hoogstwaarschijnlijk UDP-poort 19132 op je router doorzetten naar de machine waarop Geyser draait. Bij een hostingprovider is dit meestal een poorttoewijzing in hun paneel in plaats van een firewallregel, en mogelijk moet je een ticket openen om een tweede poort te krijgen.
Verbinden vanaf Bedrock
Ga in de Bedrock-client naar Play, dan het tabblad Servers, scroll naar beneden en kies Add Server.
- Server Name: wat je maar wilt.
- Server Address: het IP-adres of de hostnaam van je server.
- Port:
19132, of wat je in de config hebt ingesteld.
LET OP: Dit werkt vreemd bij consolespelers. De PlayStation-, Xbox- en Nintendo Switch-edities laten je niet direct een serveradres toevoegen, en de gebruikelijke workaround is een DNS-truc die een van de uitgelichte servers naar de jouwe omleidt. Dat valt buiten het bestek van deze gids, maar is de moeite waard om te onderzoeken indien nodig.
Opmerkingen
Hier zijn wat nuttige opmerkingen.
Oudere Minecraft-versies hebben ViaVersion nodig
Geyser richt zich op de huidige Minecraft-versie. Als je Java-server een versie ouder dan 26.2 (of de nieuwste versie van Minecraft) draait, heb je ook ViaVersion nodig, zodat de oudere netwerkprotocollen begrepen kunnen worden. Geyser's eigen supported versions page raden we aan om te bekijken voor meer info.
Java- en Bedrock-accounts koppelen
Standaard krijgt een Bedrock-speler die via Floodgate binnenkomt een eigen, apart account op je server, met een prefix op hun naam (standaard een punt). Als je wilt dat een speler dezelfde inventaris, permissies en speeltijd kan gebruiken, ongeacht of diegene via Java of Bedrock binnenkomt, dan heet dat account linking.
Er zijn twee manieren om dit te doen. Global linking, dat gebruikmaakt van link.geysermc.org en geen instellingen van jouw kant vereist. Local linking bewaart de koppelingen in je eigen database en vereist een van de Floodgate-database-extensies, gepubliceerd op dezelfde downloadpagina:
floodgate-sqlite-database.jar: De eenvoudigste (lokale) optie, prima voor een enkele server.floodgate-mysql-database.jar: Voor MySQL-databases.floodgate-mongo-database.jar: Voor MongoDB-databases.
De meeste serverbeheerders kiezen voor global linking, omdat het geen extra configuratie vereist. Zorg dat je spelers weten dat ze hun accounts moeten koppelen via link.geysermc.org!
Bedrock-spelers & Java-mods
Geyser vertaalt het vanilla netwerkprotocol dat Minecraft gebruikt. Het vertaalt geen aangepaste blokken en items die door mods zijn toegevoegd, waardoor deze er voor een Bedrock-speler verkeerd uit kunnen zien of onzichtbaar kunnen zijn. Hydraulic is GeyserMC's eigen project hiervoor, en het zet mod-assets om in een Bedrock resource pack. We raden zeker aan om dit te bekijken als je van plan bent mods op je server te draaien.
Dingen die de poort niet kunnen delen
Alles anders op je server dat UDP op dezelfde poort wil gebruiken, zal conflicteren met Geyser. De bekendste zijn voicechat-plugins (met name Simple Voice Chat) en het Minecraft Query-protocol. Deze moeten op hun eigen poort draaien.
Zie ook
- How To Install A Minecraft Server (Java Edition)
- How Much RAM For A Minecraft Server
- Geyser Wiki
- Floodgate Wiki
Conclusie
Crossplay is een taak in twee delen. Geyser opent een UDP-deur waar Bedrock-clients doorheen kunnen lopen, en Floodgate is wat voorkomt dat ze onderweg om een Java Edition-account gevraagd worden. Installeer beide, zet auth-type op floodgate, open de poort als UDP, en de rest komt neer op controleren of je elke jar in de map hebt gezet die het betreffende platform daadwerkelijk uitleest.
Als het niet werkt, is de volgorde om dingen te controleren bijna altijd hetzelfde: staat de poort open als UDP, staat auth-type op floodgate in de config van Geyser in plaats van die van Floodgate, en is Floodgate geïnstalleerd op de server die de spelerslijst beheert in plaats van op een backend achter een proxy.
Als je vragen hebt of op zoek bent naar een moddingcommunity om deel van uit te maken, overweeg dan om lid te worden van onze Discord server!
De gidsen die wij maken staan altijd open voor bewerkingen en verbeteringen, dus als je suggesties hebt of problemen opmerkt, draag dan gerust bij door een pull request aan te maken op onze GitHub-repository!
Veel modplezier!