setupmc.com

Geyser und Floodgate auf Paper einrichten

Lass Bedrock-Spieler einem Java-Server beitreten: Plugins installieren, NetherNet konfigurieren und Verbindung prüfen.

Netzwerk
setupmc.com Team

NetherNet ist jetzt erforderlich: Bedrock 26.60 erschien am 27. Oktober 2026. Laut Geyser verbinden sich Clients ab 26.60 nicht mehr über RakNet. Aktualisiere Geyser und verwende transport: nethernet; ein Rückwechsel zu RakNet repariert aktuelle Clients nicht.

Für iPhone-/iPad-Probleme und Zertifikate: HTTPS-Guide für iOS und iPadOS.

Direktes Crossplay ohne Proxy

Diese Anleitung verwendet folgende Komponenten auf einem Server:

  • ein Paper-Server
  • Geyser direkt als Plugin
  • Floodgate direkt als Plugin
  • keine separate Proxy-Schicht

Wenn du noch nicht auf Paper bist, lies zuerst Paper vs Vanilla vs Fabric vs Forge.

Kompatibilität vor Updates prüfen

Prüfe auf der offiziellen Kompatibilitätsseite, welche Bedrock-Versionen dein Geyser unterstützt und welchen Java-Client es emuliert. Dein Java-Server muss diese Clientversion akzeptieren.

Bedrock-Clients aktualisieren sich häufig automatisch. Wenn Paper den von Geyser emulierten Client nicht akzeptiert, prüfe die dort beschriebene Verwendung von ViaVersion für deine konkrete Serverversion. ViaVersion ergänzt keine fehlende Bedrock-Unterstützung in Geyser.

Was Geyser und Floodgate tun

Geyser übersetzt zwischen Bedrock-Clients und dem Java-Server. Floodgate ermöglicht Xbox-Live-authentifizierten Bedrock-Spielern den Beitritt ohne zusätzlichen Java-Edition-Account.

Schritt 1: Auf Paper als Basis setzen

Für den aktuellen Geyser-Spigot-Plugin-Pfad verlangt Geyser mindestens einen Minecraft-Java-Edition-Server in Version 1.20.5 und Java 21. Neuere Paper-Versionen können eine neuere Java-Runtime benötigen; prüfe vor einem Wechsel von Image oder Host-Runtime den Java-Kompatibilitäts-Guide.

Wenn du den Server gerade erst aufsetzt, beginne mit dem Hetzner-Docker-Guide und stelle den Server-Typ danach auf Paper um.

Schritt 2: Die Plugins installieren

  1. Lade den aktuellen Geyser-Plugin-Build für Paper/Spigot von der offiziellen Download-Seite herunter.
  2. Lege die Plugin-JAR in das plugins-Verzeichnis des Servers.
  3. Starte den Server neu.

Danach Floodgate:

  1. Lade den aktuellen Floodgate-Plugin-Build für Paper/Spigot von der offiziellen Download-Seite herunter.
  2. Lege die Plugin-JAR ebenfalls in plugins.
  3. Starte den Server erneut.

Das Geyser-Wiki beschreibt den direkten Einbau im Paper/Spigot-Setup-Guide, und Floodgate dokumentiert die nötige auth-type-Umstellung im Paper/Spigot-Setup-Guide.

Schritt 3: Geyser auf Floodgate-Authentifizierung umstellen

Öffne /plugins/Geyser-Spigot/config.yml, suche die Einstellung auth-type und setze sie auf floodgate.

Danach den Server erneut starten.

Schritt 4: Den Bedrock-Port veröffentlichen

Du hostest auf deinem PC oder NAS? Die Anleitung Öffentliche IP ohne gemieteten Server finden erklärt die Abfrage im Heimnetz und den Vergleich mit der Router-WAN-Adresse. Nutze keine lokale PC-IP als öffentliche Ankündigung.

Konfiguriere für aktuelle Bedrock-Clients NetherNet. Ersetze DEINE_OEFFENTLICHE_IP durch deine erreichbare öffentliche IP:

bedrock:
  address: 0.0.0.0
  port: 19132
  clone-remote-port: false
  transport: nethernet
  webrtc-port: 0
  signaling:
    mode: builtin
    advertise-addresses:
      - "DEINE_OEFFENTLICHE_IP:19132"

Diese Konfiguration benötigt TCP 19132 für Signaling und UDP 19132 für das Spiel.

Lass clone-remote-port für eingebautes Signaling deaktiviert: Java belegt seinen TCP-Port bereits. Verlangt dein Hoster einen gemeinsamen Port, nutze externes Signaling wie im NetherNet-Guide beschrieben.

Wenn du Docker nutzt, mappe ihn explizit:

ports:
  - "25565:25565/tcp"
  - "19132:19132/tcp"
  - "19132:19132/udp"

Starte Paper nach dem Speichern der Geyser-Konfiguration vollständig neu; /geyser reload reicht für diese Transportänderung nicht. Wenn du Docker-Portfreigaben ergänzt hast, erstelle den Dienst mit docker compose up -d neu und behalte das Datenvolume. Ein bloßes docker compose restart übernimmt keine geänderten Portfreigaben. Prüfe die Startlogs, bevor du mit Schritt 5 fortfährst.

Wenn Bedrock-Spieler trotzdem nicht verbinden können, arbeite die Port-Anleitung durch. Prüfe für diese Einrichtung TCP und UDP 19132.

Voice-Chat und Query benötigen einen anderen UDP-Port als Geyser.

Bestehende RakNet-Installation migrieren

Sichere die erzeugte Geyser-Konfiguration, übernimm die NetherNet-Einstellungen oben und ergänze die TCP-Freigabe neben der UDP-Freigabe. Behalte Floodgate- und Backend-Einstellungen. Nach geänderten Docker-Freigaben verwendest du docker compose up -d, danach einen vollständigen Server-/Proxy-Neustart. Der NetherNet-Guide erklärt abweichende Portzuordnungen, externes Signaling und aktuelle Fehlerberichte.

Schritt 5: Mit einem Bedrock-Test validieren

Für NetherNet prüfst du zuerst die TCP-Signalisierung mit curl --fail --max-time 10 http://DEINE_OEFFENTLICHE_IP:19132/v1/join. Ersetze den Platzhalter durch deine öffentliche IP. Wenn du Server-JSON erhältst, teste den Beitritt mit einem Bedrock-Client aus einem anderen Netzwerk, damit auch die UDP-Spielverbindung geprüft wird. Folge bei Fehlern den NetherNet-Verbindungstests.

Beitritt auf Konsolen

Auf Handy, Tablet und Windows lässt sich ein eigener Bedrock-Server meist direkt eintragen. Auf Konsolen fehlt diese Eingabe oft. Je nach Konsole und Heimnetz helfen zusätzliche Verbindungswege:

Funktioniert der Beitritt auf Handy oder Windows, prüfe zuerst diesen zusätzlichen Verbindungsweg der Konsole.

Spielverhalten und Plugin-Kompatibilität

Einige Spielmechaniken und Plugins verhalten sich für Bedrock-Spieler anders als für Java-Spieler. Teste die für deinen Server wichtigen Funktionen mit beiden Editionen.

Häufige Fehler

FehlerFolgeFix
Nur Geyser installiert, aber nicht FloodgateBedrock-Spieler hängen weiter an Java-AuthFloodgate ergänzen und auth-type: floodgate setzen
Nur TCP-Ports geöffnetDie Bedrock-Spielverbindung scheitertRakNet: UDP 19132 öffnen; NetherNet: TCP-Signalisierung und den angekündigten UDP-Spielport öffnen
Falscher Server-TypDie direkte Plugin-Variante wird unnötig umständlichPaper als Grundlage verwenden
Unterstützte Versionen nicht geprüftNach einem Bedrock-Update funktioniert der Beitritt plötzlich nicht mehrGeysers Matrix prüfen und Geyser aktualisieren oder bei Bedarf ViaVersion ergänzen
SRV-Records als Bedrock-Lösung betrachtenBedrock-Spieler benötigen weiterhin den passenden ServerportDie Verbindung für beide Editionen getrennt prüfen

Nächste Schritte

Quellen

Java-Konfigurator

Compose-Datei erstellen

Wähle Server-Software, Version und Einstellungen und lade deine Konfiguration herunter.

Java-Konfigurator öffnen

Häufige Fragen