Eine Anleitung zur Installation und Konfiguration von Geyser und Floodgate, damit Minecraft: Bedrock Edition-Spieler deinem Java-Edition-Server beitreten können. Diese Anleitung behandelt Spigot/Paper, Fabric, NeoForge, BungeeCord, Velocity, ViaProxy und den Standalone-Build.
Geyser ist eine Brücke, die zwischen den beiden Editionen von Minecraft übersetzt. Sie lässt deinen Java-Edition-Server einem Bedrock-Client gegenüber so erscheinen, als wäre er ein Bedrock-Server, wodurch Spieler auf Handys, Tablets, Konsolen und der Windows-10/11-Edition einem Server beitreten können, den sie sonst nicht sehen könnten. Floodgate ist das dazugehörige Plugin und sorgt dafür, dass diese Bedrock-Spieler beitreten können, ohne einen Java-Edition-Account zu besitzen.
Anforderungen
- Ein Minecraft: Java-Edition-Server, dessen Dateien du selbst kontrollierst. Ein Host, der dir kein Hochladen von jars erlaubt, kann Geyser nicht betreiben.
- Java 21 oder neuer, was aktuelle Minecraft-Serversoftware ohnehin voraussetzt.
- Ein UDP-Port, den du öffnen und per Port-Forwarding freigeben kannst. Bedrock Edition verwendet UDP, nicht TCP, und das ist der mit Abstand häufigste Fehler, den Leute machen.
- Wenn du einen Shared Host nutzt, prüfe, ob dieser einen zweiten Port erlaubt. Manche geben dir nur einen.
Wie Geyser und Floodgate zusammenarbeiten
Ich möchte kurz erklären, wie die beiden Plugins zusammenarbeiten, denn wenn man nur eines von beiden installiert, kann es dazu führen, dass Bedrock-Spieler sich nicht richtig verbinden können (z. B. müssen sie sich dann noch mit einem Java-Account verbinden).
Geyser übernimmt die Java <-> Bedrock-Übersetzung. Es lauscht auf einem UDP-Port, nimmt Bedrock-Verbindungen an und spricht auf der anderen Seite das Protokoll der Java Edition mit deinem Server. Für sich allein lässt Geyser einen Bedrock-Spieler zwar verbinden, aber dieser Spieler muss sich trotzdem als Java-Edition-Account authentifizieren, was die meisten Bedrock-Spieler nicht besitzen.
Floodgate entfernt diese Anforderung. Es teilt dem Java-Server mit, dass er einen von Geyser genehmigten Spieler akzeptieren soll, ohne dass ein Java-Account nötig ist. Deshalb werden die beiden fast immer zusammen installiert, und deshalb liefert Floodgate eine key.pem-Datei mit, bei der einem in recht deutlichen Worten gesagt wird, sie nicht zu teilen. Dieser Schlüssel ist es, der einem Account erlaubt, die Java-Authentifizierung zu umgehen.
Geyser wird einmal installiert, an der Stelle, auf die deine Bedrock-Spieler zeigen werden. Floodgate wird auf dem Server installiert, der die Spielerliste besitzt. Bei einem einzelnen Server ist das dieselbe Maschine. Bei einem Proxy-Netzwerk kommen Geyser und Floodgate beide auf den Proxy.
Herunterladen
Alles kommt von der offiziellen Download-Seite. Wir empfehlen nicht, dies anderswo herunterzuladen.
Zum Zeitpunkt des Schreibens sind die aktuellen Builds Geyser Build #1234 (2. September 2026) und Floodgate Build #140 (9. August 2026). Beide Projekte veröffentlichen fortlaufend, sodass die Build-Nummern, die du siehst, höher sein werden. Das ist normal und zu erwarten.
Welche Datei brauche ich?
Geyser veröffentlicht einen Build für jede Plattform. Floodgate nicht, und das führt oft zu Verwirrung:
| 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 |
Nicht verfügbar |
| Standalone | Geyser-Standalone.jar |
Nicht verfügbar |
Es gibt keinen Floodgate-Build für ViaProxy oder für Standalone-Geyser. Floodgate muss innerhalb des Java-Servers laufen, der die Spielerliste besitzt, und bei diesen beiden Setups läuft Geyser extern. Du installierst das plattformspezifische Floodgate-jar auf dem Java-Server, auf den Geyser zeigt, und kopierst dann die key.pem dieses Servers zu Geyser hinüber. Dazu gibt es weiter unten einen Abschnitt.
Direkte Download-Links
Diese URLs verweisen immer auf den neuesten Build, du kannst sie also bedenkenlos als Lesezeichen speichern oder in Skripten verwenden!
- Spigot
- Fabric
- NeoForge
- BungeeCord
- Velocity
- ViaProxy
- Standalone
- Floodgate Spigot
- Floodgate Bungee
- Floodgate Velocity
Auf einem Linux-Server kannst du eine Datei direkt herunterladen:
wget -O plugins/Geyser-Spigot.jar \
https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/spigot
Geyser installieren
Wähle den einen Abschnitt, der zu deinem Server-Setup passt. Du musst nur die Anweisungen für dieses Setup befolgen.
Spigot & Paper
- Lade
Geyser-Spigot.jarherunter. - Lege sie in den
plugins/-Ordner deines Servers. - Starte den Server neu. Verwende nicht
/reload, da Plugin-Reloads mehr Probleme verursachen, als sie lösen. - Geyser erzeugt seine Konfiguration unter
plugins/Geyser-Spigot/config.yml.
Fabric
- Lade
Geyser-Fabric.jarherunter. - Lege sie in den
mods/-Ordner deines Servers. - Fabric-Server benötigen außerdem das Mod Fabric API im selben Ordner.
- Starte den Server neu. Die Konfiguration erscheint unter
config/Geyser-Fabric/config.yml.
NeoForge
- Lade
Geyser-NeoForge.jarherunter. - Lege sie in den
mods/-Ordner deines Servers. - Starte den Server neu. Die Konfiguration erscheint unter
config/Geyser-NeoForge/config.yml.
BungeeCord
Installiere Geyser auf dem Proxy, nicht auf den Backend-Servern. Der Proxy ist das, mit dem sich Bedrock-Spieler verbinden.
- Lade
Geyser-BungeeCord.jarherunter. - Lege sie in den
plugins/-Ordner des Proxys. - Starte den Proxy neu. Die Konfiguration erscheint unter
plugins/Geyser-BungeeCord/config.yml.
Velocity
Gleiches Prinzip wie bei BungeeCord. Geyser kommt auf den Proxy.
- Lade
Geyser-Velocity.jarherunter. - Lege sie in den
plugins/-Ordner des Proxys. - Starte den Proxy neu. Die Konfiguration erscheint unter
plugins/Geyser-Velocity/config.yml.
ViaProxy
ViaProxy ist ein eigenständiger Proxy, der Clients auf einer Minecraft-Version einem Server auf einer anderen Version beitreten lässt. Geyser klinkt sich als Addon ein.
- Lade
Geyser-ViaProxy.jarherunter. - Lege sie in den
plugins/-Ordner von ViaProxy. - Starte ViaProxy einmal, damit Geyser seine Konfiguration erzeugt, und stoppe es dann.
- Da Geyser hier außerhalb deines Java-Servers läuft, musst du ihm sagen, wo dieser Server ist. Siehe The Remote Section.
Standalone
Standalone bedeutet, dass Geyser als eigenständiges Programm für sich läuft und über das Netzwerk auf einen Java-Server zeigt. Es ist die richtige Wahl, wenn du auf dem Server selbst keine Plugins oder Mods installieren kannst, und in fast jedem anderen Fall die falsche, weil es einen zusätzlichen Netzwerk-Hop hinzufügt und ohne zusätzliche Einrichtung kein Floodgate nutzen kann.
- Lade
Geyser-Standalone.jarherunter. - Lege sie in einen eigenen Ordner.
- Starte sie:
java -Xmx1G -jar Geyser-Standalone.jar
- Sie erzeugt
config.ymlneben sich selbst und beendet sich dann oder wartet. Stoppe sie, bearbeite die Konfiguration und starte sie erneut.
Konfigurieren von Geyser
Öffne die config.yml für deine Plattform. Die beiden wichtigen Abschnitte sind bedrock und, bei Standalone und ViaProxy, remote.
Der Bedrock-Abschnitt
Das ist es, womit sich Bedrock-Spieler verbinden:
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
Der Port ist der entscheidende Teil. 19132 ist der Standard für Bedrock Edition, und wenn du ihn so lässt, können Spieler deinem Server allein über die Adresse beitreten, ohne einen Port eintippen zu müssen. Ändere ihn nur, wenn 19132 bereits belegt ist oder dein Host dir etwas anderes zuweist.
clone-remote-port ist für Hosts gedacht, die dir bei jedem Neustart einen neuen Port zuweisen und erwarten, dass der Bedrock-Verkehr auf demselben Port läuft. Wenn du das aktivierst, überschreibt es den oben gesetzten port-Wert, weshalb es eine Falle ist, beides zu setzen und sich dann zu wundern, warum der Port ignoriert wird.
address: 0.0.0.0 bedeutet „auf jeder Netzwerkschnittstelle lauschen“, was du willst, sofern du den Zugriff nicht gezielt einschränken möchtest.
Der Remote-Abschnitt (nur bei Standalone und ViaProxy)
Wenn Geyser als Plugin oder Mod läuft, weiß es bereits, wo der Server ist, weil es sich innerhalb von ihm befindet. Läuft es standalone oder unter ViaProxy, musst du den Abschnitt remote so konfigurieren, dass er auf deinen Java-Server zeigt.
remote:
address: 127.0.0.1
port: 25565
auth-type: floodgate
Verwende 127.0.0.1 (localhost), wenn der Java-Server auf derselben Maschine läuft. Verwende seine echte Adresse, wenn nicht, und sei dir bewusst, dass du damit eine unverschlüsselte Minecraft-Verbindung zwischen den beiden ins Netzwerk gestellt hast.
Installieren von Floodgate
Floodgate sollte auf dem Minecraft-Java-Server platziert werden, der die Spielerliste besitzt.
Spigot & Paper
- Lade
floodgate-spigot.jarvon der Download-Seite herunter. - Lege sie in den
plugins/-Ordner. - Starte den Server neu.
Fabric & NeoForge
- Lade das Mod von der Modrinth-Seite oder der Download-Seite herunter.
- Lege die Datei in den
mods/-Ordner. Fabric-Server benötigen außerdem die Fabric API, die auf dem Server installiert sein muss. - Starte den Server neu.
Wenn der Fabric-Server hinter einem Velocity-Proxy steht, musst du zusätzlich FabricProxyLite konfigurieren, damit der Fabric-Server die von Velocity weitergeleiteten Spielerdaten akzeptiert.
BungeeCord & Velocity
Installiere Floodgate nur auf dem Proxy. Du brauchst es nicht auf den Backend-Servern, außer du möchtest dort gezielt die Floodgate-API nutzen oder willst, dass Bedrock-Skins auf dem Backend korrekt angezeigt werden.
- Lade
floodgate-bungee.jaroderfloodgate-velocity.jarherunter. - Lege die Datei in den
plugins/-Ordner des Proxys. - Starte den Proxy neu.
auth-type auf floodgate setzen
Dies ist der Schritt, der Bedrock-Spielern tatsächlich den Zutritt ermöglicht, und viele Leute überspringen ihn versehentlich (mich eingeschlossen, als ich Geyser und Floodgate vor Jahren zum ersten Mal installiert habe, haha).
Öffne die Konfigurationsdatei von Geyser (nicht die von Floodgate), suche den Schlüssel auth-type und setze ihn auf floodgate:
auth-type: floodgate
Die drei akzeptierten Werte sind:
floodgate- Bedrock-Spieler treten ohne Java-Edition-Account bei. Das ist es, was du willst, und es erfordert, dass Floodgate installiert ist.online- jeder Spieler muss einen Java-Edition-Account besitzen und sich authentifizieren. Das ist die Standardeinstellung.offline- überhaupt keine Authentifizierung. Auf öffentlichen Servern nicht empfohlen.
Starte den Server nach jeder Änderung neu. Geyser liest diese Einstellung beim Serverstart.
Floodgate hinter einem Proxy betreiben
Wenn du einen Proxy mit dahinterliegenden Backend-Servern hast und die Floodgate-API auch auf diesen Backends verfügbar sein soll, gibt es noch etwas mehr zu tun. Überspringe diesen Abschnitt komplett, wenn du nur einen Server hast.
- Installiere Floodgate zuerst auf dem Proxy, wie oben beschrieben.
- Installiere Floodgate auch auf jedem Backend-Server, mit
floodgate-spigot.jaroderfloodgate-fabric.jar. - Aktiviere die Weiterleitung von Spielerinformationen:
- BungeeCord: Setze
ip_forwardauftruein derconfig.ymldes Proxys, und setzebungeecordauftruein derspigot.ymljedes Backends. - Velocity: Richte die Weiterleitung von Spielerinformationen ein. Velocity hat mehrere Modi, und jeder benötigt eine andere Einrichtung auf dem Backend, also folge deren Anleitung, statt zu raten.
- BungeeCord: Setze
- Starte den Proxy, damit Floodgate seine Dateien erzeugt.
- Setze in der Floodgate-Konfiguration des Proxys
send-floodgate-dataauftrue. - Kopiere die Datei
key.pemaus dem Floodgate-Konfigurationsordner des Proxys in den Floodgate-Konfigurationsordner jedes Backend-Servers. - Starte die Backends und den Proxy neu.
WARNUNG: Wie bereits erwähnt, teile key.pem mit niemandem, und poste sie nicht in einem Support-Kanal, wenn du um Hilfe bittest. Diese Datei ist es, die es Bedrock-Konten erlaubt, die Java Edition-Authentifizierung zu umgehen. Jeder, der eine Kopie besitzt, kann sich auf deinem Server als so ziemlich jeder anmelden, sofern er dazu in der Lage ist.
Dieselbe Kopie von key.pem ist der Weg, wie du Floodgate mit standalone Geyser oder mit ViaProxy nutzt. Installiere die plattformspezifische Floodgate-Jar auf dem Java-Server, kopiere dann die key.pem-Datei dieses Servers in Geysers eigenen Konfigurationsordner.
Öffnen des Ports
Bedrock Edition nutzt UDP. Wenn du nur TCP öffnest, wird der Server nicht in der Serverliste für Bedrock-Clients angezeigt.
Auf einem Linux-Server kannst du dies in der Regel über die installierte Firewall erreichen.
# 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
Wenn du von zu Hause aus hostest, musst du höchstwahrscheinlich den UDP-Port 19132 auf deinem Router an die Maschine weiterleiten, auf der Geyser läuft. Wenn du bei einem Hosting-Anbieter bist, ist dies meist eine Portzuweisung in dessen Panel statt einer Firewall-Regel, und du musst möglicherweise ein Ticket eröffnen, um einen zweiten Port zugewiesen zu bekommen.
Verbinden von Bedrock aus
Gehe im Bedrock-Client zu Spielen, dann zum Tab Server, scrolle nach unten und wähle Server hinzufügen.
- Servername: was immer du möchtest.
- Serveradresse: die IP-Adresse oder der Hostname deines Servers.
- Port:
19132, oder was auch immer du in der Konfiguration eingestellt hast.
HINWEIS: Das funktioniert bei Konsolenspielern etwas seltsam. Die PlayStation-, Xbox- und Nintendo Switch-Editionen erlauben es nicht, direkt eine Serveradresse hinzuzufügen, und der übliche Workaround ist ein DNS-Trick, der einen der vorgestellten Server auf deinen umleitet. Das liegt außerhalb dessen, was diese Anleitung abdeckt, ist aber bei Bedarf einen Blick wert.
Hinweise
Hier sind ein paar nützliche Hinweise.
Ältere Minecraft-Versionen benötigen ViaVersion
Geyser zielt auf aktuelles Minecraft ab. Wenn dein Java-Server eine Version älter als 26.2 (oder die neueste Version von Minecraft) läuft, benötigst du zusätzlich ViaVersion, damit die alten Netzwerkprotokolle verstanden werden können. Geysers eigene Seite zu unterstützten Versionen empfehlen wir für weitere Infos.
Java- und Bedrock-Konten verknüpfen
Standardmäßig erhält ein Bedrock-Spieler, der über Floodgate beitritt, einen eigenen separaten Account auf deinem Server, mit einem Präfix vor seinem Namen (standardmäßig ein Punkt). Wenn ein Spieler dasselbe Inventar, dieselben Berechtigungen und dieselbe Spielzeit nutzen können soll, egal ob er von Java oder von Bedrock beitritt, dann ist das Account-Verknüpfung.
Es gibt zwei Wege, das zu tun. Globale Verknüpfung, die link.geysermc.org nutzt und keine Einrichtung deinerseits erfordert. Lokale Verknüpfung speichert die Verknüpfungen in deiner eigenen Datenbank und benötigt eine der Floodgate-Datenbankerweiterungen, die auf derselben Download-Seite veröffentlicht werden:
floodgate-sqlite-database.jar: Die einfachste (lokal), und gut geeignet für einen einzelnen Server.floodgate-mysql-database.jar: Für MySQL-Datenbanken.floodgate-mongo-database.jar: Für MongoDB-Datenbanken.
Die meisten Serverbetreiber entscheiden sich für die globale Verknüpfung, da sie keine zusätzliche Einrichtung erfordert. Stelle sicher, dass deine Spieler wissen, dass sie ihre Accounts unter link.geysermc.org verknüpfen müssen!
Bedrock-Spieler & Java-Mods
Geyser übersetzt das Vanilla-Netzwerkprotokoll, das Minecraft verwendet. Es übersetzt keine benutzerdefinierten Blöcke und Items, die von Mods hinzugefügt wurden, welche für einen Bedrock-Spieler falsch aussehen oder unsichtbar sein können. Hydraulic ist GeyserMCs eigenes Projekt dafür, und es wandelt Mod-Assets in ein Bedrock-Resource-Pack um. Wir empfehlen definitiv, es dir anzuschauen, wenn du vorhast, Mods auf deinem Server zu betreiben.
Dinge, die sich den Port nicht teilen können
Alles andere auf deinem Server, das UDP auf demselben Port möchte, wird mit Geyser in Konflikt geraten. Die häufigsten sind Voice-Chat-Plugins (insbesondere Simple Voice Chat) und das Minecraft Query-Protokoll. Sie müssen auf ihrem eigenen Port laufen.
Siehe auch
- Wie man einen Minecraft-Server installiert (Java Edition)
- Wie viel RAM für einen Minecraft-Server
- Geyser Wiki
- Floodgate Wiki
Fazit
Crossplay ist eine Aufgabe in zwei Teilen. Geyser öffnet eine UDP-Tür, durch die Bedrock-Clients gehen können, und Floodgate ist das, was verhindert, dass sie dabei nach einem Java Edition-Account gefragt werden. Installiere das Paar, setze auth-type auf floodgate, öffne den Port als UDP, und der Rest besteht darin zu prüfen, dass du jede Jar in den Ordner gelegt hast, den ihre Plattform tatsächlich liest.
Wenn es nicht funktioniert, ist die Reihenfolge, in der man Dinge prüft, fast immer dieselbe: Ist der Port als UDP geöffnet, ist auth-type in Geysers Konfiguration (nicht in der von Floodgate) auf floodgate gesetzt, und ist Floodgate auf dem Server installiert, der die Spielerliste besitzt, statt auf einem Backend hinter einem Proxy.
Wenn du Fragen hast oder auf der Suche nach einer Modding-Community bist, der du beitreten kannst, tritt gerne unserem Discord-Server bei!
Unsere Guides sind stets offen für Änderungen und Verbesserungen. Wenn du also Vorschläge hast oder Probleme bemerkst, kannst du gerne einen Pull Request in unserem GitHub-Repository erstellen!
Happy Modding!