Wie man GeyserMC (Crossplay Java/Bedrock) auf OuiPanel konfiguriert

GeyserMC ist ein Plugin, mit dem Spieler von Minecraft Bedrock Ihrem Minecraft-Java-Server beitreten können. Es übersetzt zwischen den beiden Spielversionen und ermöglicht so Crossplay zwischen PC, Mobilgeräten und Konsolen. Diese Anleitung zeigt, wie Sie GeyserMC mit Floodgate in OuiPanel, dem Game-Panel, installieren und konfigurieren, die Verbindung mit geyser connectiontest prüfen und Bedrock-Spieler verbinden.

---

Was Sie brauchen

Von Geyser unterstützte Plattformen

Plattform	Unterstützung
Windows 10/11 (Bedrock)	vollständig
iOS (iPhone, iPad)	vollständig
Android	vollständig
Xbox	vollständig, mit der unten beschriebenen DNS-Methode
Nintendo Switch	vollständig, mit der unten beschriebenen DNS-Methode
PlayStation 4/5	besondere Einrichtung nötig
Java Edition	nativ, ohne Geyser

Das Prinzip

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Java-Spieler   │────▶│                 │────▶│                 │
│  (PC)           │     │   Minecraft-    │     │                 │
└─────────────────┘     │   Java-         │     │   Gemeinsame    │
                        │   Server        │     │   Welt          │
┌─────────────────┐     │   +             │     │                 │
│ Bedrock-Spieler │────▶│   GeyserMC      │────▶│                 │
│ (Mobil/Konsole) │     │   (Übersetzer)  │     │                 │
└─────────────────┘     └─────────────────┘     └─────────────────┘

Geyser übersetzt Bedrock-Daten in Java-Daten und umgekehrt. Beide Spielerarten teilen dieselbe Welt.

Benötigte Plugins

Plugin	Aufgabe	Status
GeyserMC	übersetzt das Bedrock-Protokoll nach Java	Pflicht
Floodgate	lässt Bedrock-Spieler ohne Java-Konto beitreten	empfohlen
ViaVersion	nimmt ältere Minecraft-Versionen an	optional

Ohne Floodgate bräuchte jeder Bedrock-Spieler ein Konto für Minecraft Java Edition.

Passende Server-Software

Software	Unterstützung	Geyser-Datei
Paper	empfohlen	Geyser-Spigot.jar
Spigot	vollständig	Geyser-Spigot.jar
Purpur	vollständig	Geyser-Spigot.jar
BungeeCord	vollständig	Geyser-BungeeCord.jar
Velocity	vollständig	Geyser-Velocity.jar
Fabric	vollständig	Geyser-Fabric.jar
NeoForge	vollständig	Geyser-NeoForge.jar
Vanilla	nicht unterstützt	keine

Ein Vanilla-Server muss zuerst unter Versionen/Modpacks › Versionsmanager auf Paper oder Spigot umgestellt werden. Die Anleitung Plugins auf Ihrem Minecraft-Server installieren zeigt, wie das geht.

Ein zweiter Port, über UDP

Geyser braucht einen eigenen Port für Bedrock-Spieler.

• Java-Port, standardmäßig 25565 (TCP), für Java-Spieler.

• Bedrock-Port, standardmäßig 19132 (UDP), für Bedrock-Spieler.

In OuiPanel fügen Sie diesen Port unter Konfiguration › Port-Verwaltung hinzu, wie weiter unten beschrieben.

---

Geyser und Floodgate installieren

GeyserMC herunterladen

1. Öffnen Sie geysermc.org und klicken Sie auf Download.

2. Wählen Sie die Datei, die zu Ihrem Server passt.

Ihr Server	Herunterzuladende Datei
Paper, Spigot, Purpur	Geyser-Spigot.jar
BungeeCord, Waterfall	Geyser-BungeeCord.jar
Velocity	Geyser-Velocity.jar
Fabric	Geyser-Fabric.jar
NeoForge	Geyser-NeoForge.jar

Floodgate herunterladen

Öffnen Sie auf geysermc.org den Tab Floodgate und laden Sie die Datei für Ihren Server herunter.

Ihr Server	Herunterzuladende Datei
Paper, Spigot, Purpur	Floodgate-Spigot.jar
BungeeCord, Waterfall	Floodgate-BungeeCord.jar
Velocity	Floodgate-Velocity.jar
Fabric	Floodgate-Fabric.jar

Die Dateien auf den Server legen

1. Melden Sie sich bei OuiPanel an und wählen Sie Ihren Minecraft-Server.

2. Öffnen Sie im Seitenmenü Dateimanager und dann den Ordner plugins (oder mods unter Fabric).

3. Ziehen Sie Geyser-Spigot.jar und Floodgate-Spigot.jar vom Computer auf die Seite. Eine Schaltfläche zum Hochladen gibt es nicht.

4. Lassen Sie sie los, sobald die Einblendung „Dateien hier ablegen“ erscheint.

Unter Paper, Spigot oder Purpur können Sie Geyser und Floodgate auch auf der Seite Plugins im Tab Katalog suchen und auf Installieren klicken.

Erster Start

1. Starten Sie den Server in der Konsole und warten Sie, bis er ganz geladen ist.

2. Prüfen Sie, ob Geyser und Floodgate geladen werden.

[INFO]: [Geyser-Spigot] Loading Geyser version X.X.X...
[INFO]: [Geyser-Spigot] Geyser is now ready to accept Bedrock connections!
[INFO]: [Floodgate] Floodgate has been enabled!

Stoppen Sie den Server danach, bevor Sie ihn konfigurieren. Dieser erste Start hat die Konfigurationsdateien angelegt.

---

Einen Port für Bedrock hinzufügen

1. Öffnen Sie im Seitenmenü Konfiguration › Port-Verwaltung. Die Seite „Netzwerk-Ports“ zeigt, wie viele Ports Ihr Angebot erlaubt.

2. Klicken Sie auf Neuen Port zuweisen. Das Panel wählt die Nummer und fügt den Port sofort hinzu, ohne Bestätigungsfenster.

3. Notieren Sie die Nummer des neuen Ports.

4. Klicken Sie unter diesem Port auf Notiz bearbeiten und schreiben Sie zum Beispiel „Bedrock-Port GeyserMC“.

Der Standard-Port für Bedrock ist 19132, OuiPanel weist aber fast immer eine andere Nummer zu. Genau diese tragen Sie in Geyser ein, und genau diese nutzen die Spieler.

---

Geyser und Floodgate konfigurieren

Die Konfiguration von Geyser öffnen

Öffnen Sie im Dateimanager die folgende Datei, bearbeiten Sie sie im Editor und klicken Sie auf Speichern.

/plugins/Geyser-Spigot/config.yml

Den Bedrock-Port einstellen

Suchen Sie den Abschnitt bedrock: und tragen Sie Ihren Port ein.

bedrock:
  # Die Adresse, auf der Geyser lauscht
  address: 0.0.0.0
  # Der Bedrock-Port (durch den zugewiesenen Port ersetzen)
  port: 19132
  # Port des Java-Servers übernehmen (hier auf false lassen)
  clone-remote-port: false
  # MOTD für Bedrock-Spieler
  motd1: "Mein Minecraft-Server"
  motd2: "Crossplay Java & Bedrock!"
  # Servername in der Liste
  server-name: "Mein Server"

Ersetzen Sie 19132 durch den Port aus der Port-Verwaltung.

Die Verbindung zum Java-Server einstellen

Suchen Sie den Abschnitt remote:.

remote:
  # Die Adresse des Java-Servers (meist automatisch erkannt)
  address: auto
  # Der Port des Java-Servers
  port: 25565
  # Art der Authentifizierung
  auth-type: floodgate

Einstellung	Wert	Erklärung
address	auto	automatische Erkennung (empfohlen)
port	25565	Port Ihres Java-Servers
auth-type	floodgate	nutzt Floodgate für die Authentifizierung

Nützliche Optionen

# Mit Floodgate geteilter Schlüssel
floodgate-key-file: key.pem

# Befehle für Bedrock-Spieler vorschlagen
command-suggestions: true

# Koordinaten für Bedrock-Spieler anzeigen
show-coordinates: true

# Debug-Modus (im Betrieb ausschalten)
debug-mode: false

# Höchstzahl angezeigter Bedrock-Spieler
max-players: 100

# Anonyme Statistiken
metrics:
  enabled: true

Beispiel einer vollständigen config.yml

bedrock:
  address: 0.0.0.0
  port: 19132  # Durch Ihren Port ersetzen!
  clone-remote-port: false
  motd1: "Mein Crossplay-Server"
  motd2: "Java & Bedrock zusammen!"
  server-name: "MeinServer"
  compression-level: 6
  enable-proxy-protocol: false

remote:
  address: auto
  port: 25565
  auth-type: floodgate

floodgate-key-file: key.pem

command-suggestions: true
passthrough-motd: true
passthrough-player-counts: true
legacy-ping-passthrough: false

max-players: 100

show-coordinates: true

emote-offhand-workaround: "disabled"

cache-images: 0

allow-custom-skulls: true

add-non-bedrock-items: true

above-bedrock-nether-building: false

force-resource-packs: true

xbox-achievements-enabled: false

Floodgate konfigurieren

Öffnen Sie die folgende Datei.

/plugins/floodgate/config.yml

# Präfix vor Bedrock-Namen (vermeidet Konflikte)
username-prefix: "."

# Leerzeichen in Namen ersetzen (Bedrock-Namen können welche enthalten)
replace-spaces: "_"

# Debug-Modus
debug-mode: false

# Datenbank der verknüpften Konten
player-link:
  enabled: true
  type: sqlite

Mit dem Präfix . erscheint ein Bedrock-Spieler namens Steve auf dem Server als .Steve. So gibt es keinen Konflikt mit einem Java-Spieler gleichen Namens.

---

Neu starten und testen

1. Klicken Sie in der Konsole auf Starten und warten Sie, bis der Server ganz geladen ist.

2. Prüfen Sie, ob Geyser auf Ihrem Port lauscht.

[INFO]: [Geyser-Spigot] Loading Geyser...
[INFO]: [Geyser-Spigot] Geyser version X.X.X
[INFO]: [Geyser-Spigot] Listening on /0.0.0.0:19132
[INFO]: [Geyser-Spigot] Geyser is now ready to accept Bedrock connections!
[INFO]: [Floodgate] Floodgate has been enabled!

Den Befehl geyser connectiontest ausführen

Geben Sie in der Konsole diesen Befehl ein, ohne Schrägstrich.

geyser connectiontest IP:PORT

Mit einer Beispieladresse sieht das so aus.

geyser connectiontest 203.0.113.10:19132

Ist alles in Ordnung, antwortet Geyser so.

[Geyser] Connection test successful!

---

Bedrock-Spieler verbinden

Bedrock-Spieler nutzen die IP-Adresse des Servers und den Bedrock-Port. Die Adresse steht auf der Seite Globale Ansicht in der Karte Verbindungsadresse (Hauptadresse). Nehmen Sie nur den Teil vor dem Doppelpunkt und geben Sie den Bedrock-Port getrennt an.

Angabe	Wert
Adresse	die IP Ihres Servers
Port	der zugewiesene Bedrock-Port

Der Bedrock-Port ist nicht der Java-Port. Ein Bedrock-Spieler mit dem Java-Port kann sich nicht verbinden.

Unter Windows 10/11

1. Starten Sie Minecraft für Windows (Bedrock Edition).

2. Klicken Sie auf Spielen, dann auf Server und Server hinzufügen.

3. Geben Sie dem Server einen Namen und tragen Sie die IP des Servers und den Bedrock-Port ein.

4. Klicken Sie auf Speichern, wählen Sie den Server und dann Server beitreten.

Auf dem Smartphone oder Tablet (iOS, Android)

1. Starten Sie Minecraft auf Ihrem Gerät.

2. Tippen Sie auf Spielen, dann auf Server und Server hinzufügen.

3. Geben Sie Adresse und Port ein, speichern Sie und treten Sie bei.

Auf der Xbox

Auf der Xbox sind eigene Server nicht direkt erreichbar. Es gibt zwei Lösungen, BedrockConnect (DNS-Änderung) oder die App MC Server Connector aus dem Microsoft Store.

Die DNS-Methode (BedrockConnect) läuft so ab.

1. Öffnen Sie auf der Xbox Einstellungen, Netzwerk und dann Erweiterte Einstellungen.

2. Wählen Sie unter DNS-Einstellungen die Option Manuell.

3. Tragen Sie den primären DNS 104.238.130.180 und den sekundären DNS 8.8.8.8 ein.

4. Starten Sie Minecraft neu.

5. Klicken Sie im Tab Server auf einen Partnerserver. Ein Menü erlaubt dann, die IP Ihres Servers einzugeben.

Auf der Nintendo Switch

Die Methode ist dieselbe wie auf der Xbox.

1. Öffnen Sie Systemeinstellungen, Internet und dann Interneteinstellungen.

2. Wählen Sie Ihr Netzwerk und dann Einstellungen ändern.

3. Wählen Sie unter DNS-Einstellungen die Option Manuell und tragen Sie den primären DNS 104.238.130.180 ein.

4. Folgen Sie danach denselben Schritten wie auf der Xbox.

Auf der PlayStation

Die PlayStation ist strenger. Sie brauchen ein Relais (Proxy) in Ihrem lokalen Netzwerk.

1. Installieren Sie BedrockConnect oder Phantom auf einem PC im selben Netzwerk.

2. Richten Sie das Relais ein.

3. Stellen Sie den DNS der PlayStation auf die IP dieses PCs.

---

GeyserMC-Befehle

Geben Sie diese Befehle in der Konsole von OuiPanel ohne Schrägstrich ein.

Befehl	Beschreibung
geyser reload	lädt die Konfiguration neu
geyser version	zeigt die Geyser-Version
geyser dump	erstellt einen Diagnosebericht
geyser statistics	zeigt Statistiken
geyser connectiontest IP:PORT	testet die Bedrock-Verbindung
geyser list	listet verbundene Bedrock-Spieler

Im Spiel haben die Spieler diese Befehle.

Befehl	Beschreibung
/geyser help	listet die verfügbaren Befehle
/geyser offhand	tauscht den Gegenstand in der Zweithand
/geyser advancements	öffnet das Fortschrittsmenü
/geyser statistics	öffnet das Statistikmenü
/geyser settings	öffnet die Geyser-Einstellungen

Die vollständige Dokumentation finden Sie im GeyserMC-Wiki. Das Projekt hat außerdem einen Discord und ein GitHub-Repository.

---

Wenn Bedrock-Spieler sich nicht verbinden können

Ursache	Lösung
Falscher Port	vergleichen Sie den Port in config.yml mit dem in der Port-Verwaltung
Port fehlt	prüfen Sie in der Port-Verwaltung, ob der Bedrock-Port existiert
Falsche IP	nutzen Sie die IP der Hauptadresse des Servers
Protokoll	der Bedrock-Port muss per UDP erreichbar sein

Fehler „Unable to connect to world“

1. Prüfen Sie, ob der Server läuft.

2. Prüfen Sie im Protokoll der Konsole, ob Geyser geladen ist.

3. Führen Sie geyser connectiontest aus.

4. Prüfen Sie, ob der Port stimmt.

Fehler „Disconnected from server“

1. Prüfen Sie auth-type: floodgate in der Geyser-Konfiguration.

2. Prüfen Sie, ob Floodgate installiert und aktiv ist.

3. Prüfen Sie, ob key.pem im Ordner von Floodgate liegt.

Fehler „Invalid credentials“

1. Prüfen Sie, ob auth-type auf floodgate steht.

2. Starten Sie den Server neu.

3. Löschen Sie die Dateien key.pem und legen Sie sie neu an.

Bedrock-Skins werden falsch angezeigt

Das ist eine bekannte Grenze. Das Plugin SkinsRestorer hilft auf der Java-Seite, eigene Bedrock-Skins funktionieren unter Java aber nicht.

Chat-Problem (ab 1.19.1)

Fügen Sie ab Version 1.19.1 diese Zeile in server.properties ein oder installieren Sie das Plugin NoEncryption oder FreedomChat.

enforce-secure-profile=false

---

Grenzen des Crossplay und bewährte Vorgehensweisen

Funktion	Java	Bedrock über Geyser
PvP-Kombos	nativ	anders
Redstone	vollständig	kleine Unterschiede
Manche Blöcke	alle	anderes Aussehen
Befehle	alle	Syntax teils anders
F3-Bildschirm (Debug)	ja	nein
Mods	ja, auf einem Mod-Server	nein

Erkunden, Bauen, Survival, Abenteuer, einfache Minispiele, Chat und gängige Plugins (Wirtschaft usw.) funktionieren gut. Kompetitives PvP, komplexe Kolben- oder Redstone-Schaltungen, manche fortgeschrittenen Plugins und eigene Resource Packs können Probleme machen.

Vorgehen	Grund
Floodgate nutzen	kein Java-Konto nötig
**Ein Präfix festlegen (.)**	Namenskonflikte vermeiden
Regelmäßig testen	sicherstellen, dass Crossplay läuft
Geyser aktuell halten	Korrekturen und Neuerungen erhalten

Raten Sie den Spielern, denselben Namen zu behalten, Fehler zu melden und zu akzeptieren, dass manche Mechaniken anders sind.

---

Brauchen Sie Hilfe?

Eröffnen Sie ein Ticket über Tickets › Ticket öffnen oder über die Kachel Support kontaktieren unten auf der Seite Ihres Servers im Kundenbereich. Sie können Ihre Frage auch auf dem Discord von OuiHeberg stellen.

Ticket eröffnenDiscord