Bedrock und Geyser: Meldungen im Serverlog verstehen und beheben

Hier stehen die Meldungen, die rund um Bedrock-Spieler im Serverlog auftauchen. Sie kommen aus zwei Richtungen: Auf einem Java-Server übersetzt das Plugin Geyser die Verbindung von Bedrock-Spielern, Floodgate lässt sie ohne Java-Konto beitreten. Auf einem nativen Bedrock-Server (Bedrock Dedicated Server) stammen die Meldungen dagegen meist von Add-ons, also Verhaltens- und Ressourcenpaketen.

Jeder Abschnitt behandelt genau eine Meldung. Den vollständigen Wortlaut findest du in der Konsole, bei Java-Servern zusätzlich unter Dateien in logs/latest.log. Lies dort auch die Zeilen direkt darunter, denn sie nennen oft das betroffene Paket oder den eigentlichen Grund.

Bevor du Konfigurationsdateien, Add-ons oder Weltdateien änderst, lege unter Sicherungen eine Sicherung an. So kommst du jederzeit zum alten Stand zurück.

Geyser kann seine Sprachdateien nicht laden

So sieht die Meldung aus:

java.lang.AssertionError: Unable to load Geyser locale map for <Sprache>
    at Geyser-Spigot.jar//org.geysermc.geyser.text.GeyserLocale.loadGeyserLocale(GeyserLocale.java:141)

Was dahintersteckt: Geyser braucht für jeden Bedrock-Spieler die Minecraft-Sprachdatei seiner Spracheinstellung, zum Beispiel für Deutsch oder britisches Englisch. Diese Dateien lädt Geyser beim Start herunter und legt sie in einem eigenen Ordner ab. Ist der Download beim Start gescheitert oder der Ordner beschädigt, findet Geyser die Datei nicht. Der Beitritt des Bedrock-Spielers schlägt dann fehl, Java-Spieler sind nicht betroffen.

So behebst du es:

1. Starte den Server über die Konsole neu. Geyser lädt die Sprachdateien dabei erneut.
2. Lies den Start in der Konsole mit. Steht dort „Unable to download and extract … locale“, ist schon der Download gescheitert. Dazu gibt es weiter unten einen eigenen Abschnitt.
3. Bleibt die Meldung, stoppe den Server und lösche unter Dateien den Ordner plugins/Geyser-Spigot/locales bzw. den Ordner .cache von Geyser.
4. Starte den Server wieder und lass einen Bedrock-Spieler beitreten.

Gut zu wissen: Diese Ordner enthalten nur Daten, die Geyser selbst wieder herunterlädt. Deine Einstellungen in config.yml bleiben erhalten.

Geyser meldet einen Fehler in der Sitzung eines Bedrock-Spielers

So sieht die Meldung aus:

[Geyser-Spigot] Exception caught in session of unknown (pre-login)
[Geyser-Spigot] Error thrown in <Spieler>'s event loop!
[Geyser-Spigot] An exception occurred:

Was dahintersteckt: Für jeden Bedrock-Spieler führt Geyser eine eigene Sitzung und übersetzt darin alles, was zwischen Bedrock-Client und Java-Server hin- und hergeht. Ist bei dieser Übersetzung etwas schiefgegangen, wird meist nur dieser eine Spieler getrennt. Der Server und alle anderen Spieler laufen weiter. „pre-login“ bedeutet, dass die Verbindung schon vor der Anmeldung abgebrochen ist. Eine ReadTimeoutException darunter deutet auf eine abgerissene Verbindung hin.

So behebst du es:

1. Notiere Uhrzeit, betroffenen Spieler und was er gerade getan hat, etwa ein Menü geöffnet oder die Welt gewechselt.
2. Aktualisiere Geyser und Floodgate unter Plugins auf den neuesten Stand. Hast du sie selbst hochgeladen, ersetze die alten JAR-Dateien in plugins/, statt neue daneben zu legen.
3. Starte den Server neu und lass den Spieler den Vorgang wiederholen.
4. Tritt der Fehler bei demselben Spieler oder Vorgang immer wieder auf, melde ihn mit der Fehlerzeile und den Zeilen darunter im Discord des Geyser-Projekts.

Gut zu wissen: Bedrock-Clients bekommen häufig Updates, und ein veralteter Geyser kommt mit neuen Clients oft nicht zurecht. Eine einzelne Meldung mit „pre-login“, zu der kein Spieler ein Problem meldet, kannst du ignorieren.

Ein Add-on meldet einen Skriptfehler

So sieht die Meldung aus:

[Scripting] [<Add-on>] LocationInUnloadedChunkError: Trying to access location (<x>, <y>, <z>) which is not in a chunk currently loaded and ticking.
[Scripting] [<Add-on>] InvalidEntityError: Failed to get property 'dimension' due to Entity being invalid (has the Entity been removed?).

Was dahintersteckt: Viele Bedrock-Add-ons bringen eigene Skripte im Verhaltenspaket mit. Diese Zeilen meldet das Skript des Add-ons selbst, der Fehler liegt also im Add-on und nicht am Server. Typisch sind Zugriffe auf ein Wesen, das es nicht mehr gibt, oder auf ein Gebiet, das gerade nicht geladen ist. Der Server läuft weiter, meist fällt nur eine Funktion des Add-ons kurz aus. Bei sehr vielen Meldungen kann das Add-on die Leistung drücken.

So behebst du es:

1. Lies den Namen des Add-ons ab. Er steht in der zweiten eckigen Klammer.
2. Vergleiche die Bedrock-Version deines Servers unter Version mit den Versionen, die der Ersteller des Add-ons nennt.
3. Gibt es eine neuere Ausgabe des Add-ons, lege eine Sicherung an und installiere sie nach dessen Anleitung.
4. Stört das Add-on das Spiel, deaktiviere es testweise. Dazu entfernst du unter Dateien seinen Eintrag aus worlds/<Welt>/world_behavior_packs.json und startest neu.

Gut zu wissen: Inhalte, die nur das Add-on mitbringt, können beim Deaktivieren aus der Welt verschwinden. Den Fehler im Skript kann nur der Ersteller beheben, die Zeilen mit „at“ helfen ihm dabei.

Add-on-Pakete lassen sich nicht sauber laden

So sieht die Meldung aus:

The following issues were found when loading packs:
    behavior_packs/<Paket>
        The property '/header/min_engine_version' has a version of '<Version>' which is too high. The highest value we accept is '<Version>'.

Was dahintersteckt: Jedes Add-on-Paket hat eine Beschreibungsdatei manifest.json. Darin stehen unter anderem Name, Kennung, Version und die Bedrock-Version, die das Paket mindestens braucht. Findet der Server beim Start dort Fehler, listet er sie eingerückt unter dieser Zeile auf: erst das Paket, darunter den Grund. Je nach Fehler lädt er das Paket gar nicht oder anders als gedacht, etwa als Ressourcenpaket statt als Verhaltenspaket („Defaulting to resource pack“).

So behebst du es:

1. Lies die eingerückten Zeilen unter der Meldung. Sie nennen Paket und Grund.
2. Steht dort „too high“, braucht das Add-on eine neuere Bedrock-Version als dein Server. Nimm eine ältere Ausgabe des Add-ons oder warte, bis die passende Version unter Version bzw. Updates bereitsteht.
3. Bei anderen Gründen hilft meist die aktuelle Ausgabe des Add-ons vom Ersteller.
4. Hast du manifest.json selbst bearbeitet, prüfe sie unter Dateien. Sie muss gültiges JSON sein (Klammern, Kommas, Anführungszeichen) und alle Pflichtfelder enthalten, zum Beispiel format_version, header mit name, uuid und version sowie modules.
5. Starte neu und prüfe, ob die Liste verschwunden ist.

Die Geyser-Konfiguration lässt sich nicht lesen

So sieht die Meldung aus:

[Geyser-Spigot] Failed to read/create config.yml! Make sure it's up to date and/or readable+writable!
org.geysermc.geyser.platform.spigot.shaded.org.spongepowered.configurate.loader.ParsingException: …

Was dahintersteckt: Geyser liest seine Einstellungen aus plugins/Geyser-Spigot/config.yml. Die Datei ist in YAML geschrieben, einem Textformat, in dem Einrückung mit Leerzeichen und Doppelpunkte die Struktur bestimmen. Eine ParsingException darunter heißt: Die Datei ist an einer Stelle beschädigt, oft nach einer Bearbeitung von Hand. Seltener ist sie veraltet oder nicht les- bzw. schreibbar. Ohne gültige Konfiguration startet Geyser in der Regel nicht, und Bedrock-Spieler kommen nicht auf den Server. Java-Spieler merken davon nichts.

So behebst du es:

1. Stoppe den Server und öffne unter Dateien die Datei plugins/Geyser-Spigot/config.yml.
2. Prüfe die Zeilen, die die Fehlermeldung nennt: Tabulatoren statt Leerzeichen, verrutschte Einrückung, fehlender Doppelpunkt oder ein nicht geschlossenes Anführungszeichen.
3. Findest du den Fehler nicht, benenne die Datei um, zum Beispiel in config.yml.alt. Geyser legt beim nächsten Start eine neue Standarddatei an.
4. Übertrage danach nur die nötigen Werte aus der alten Datei. Der Bedrock-Port muss dem UDP-Port entsprechen, den das Panel deinem Server zuweist.
5. Starte den Server und prüfe in der Konsole, ob Geyser ohne Fehler startet.

Gut zu wissen: Meldet auch eine frisch erzeugte Datei den Fehler, liegt es eher an den Dateiberechtigungen. Kommst du nicht weiter, öffne ein Ticket und nenne die Uhrzeit der Meldung.

Floodgate ist doppelt geladen

So sieht die Meldung aus:

java.lang.IllegalArgumentException: Duplicate handler name: floodgate-init

Was dahintersteckt: Floodgate klinkt sich beim Start in die Netzwerkverbindung des Servers ein, damit es Bedrock-Spieler erkennen kann. Diesen Eingriff darf es nur einmal geben. Die Meldung zeigt, dass Floodgate ein zweites Mal geladen wurde. Meist liegen zwei Floodgate-Dateien im Ordner plugins/, zum Beispiel eine alte und eine neue Version. Manchmal bringt auch ein anderes Plugin Floodgate selbst mit. Bedrock-Spieler können dann beim Beitritt scheitern.

So behebst du es:

1. Öffne unter Dateien den Ordner plugins/ und suche alle Dateien, die „floodgate“ im Namen tragen und auf .jar enden.
2. Behalte nur eine davon, am besten die neueste, und lösche die übrigen.
3. Prüfe bei kürzlich installierten Plugins, ob sie laut ihrer Beschreibung Floodgate enthalten. Dann brauchst du nur eine der beiden Quellen.
4. Starte den Server neu und lass einen Bedrock-Spieler beitreten.

Gut zu wissen: Der Ordner plugins/floodgate ist kein zweites Plugin. Er enthält die Einstellungen und den Schlüssel von Floodgate und bleibt bestehen.

Ein Add-on enthält Einträge, die der Server nicht versteht

So sieht die Meldung aus:

[FeatureRegistry] Feature rule <add-on>:<name> can't place internal feature type.
[Animation] Error: can't find animation <name>

Was dahintersteckt: Add-ons beschreiben Wesen, Gegenstände, Blöcke, Animationen und Teile der Weltgenerierung in eigenen Dateien. Versteht der Bedrock-Server einen dieser Einträge in seiner Version nicht, schreibt er eine solche Zeile ins Log. „Feature rule“ betrifft zum Beispiel Regeln, die Pflanzen oder Strukturen in der Welt verteilen. Dieser Teil des Add-ons funktioniert dann nicht oder nur teilweise, der Rest und der Server laufen weiter. Meist ist das Add-on für eine andere Bedrock-Version gebaut.

So behebst du es:

1. Finde das betroffene Paket. Der Teil vor dem Doppelpunkt ist meist das Kürzel des Add-ons, andere Zeilen nennen den Pfad behavior_packs/….
2. Sieh unter Version nach, welche Bedrock-Version dein Server hat.
3. Lege eine Sicherung an, lade beim Ersteller die Ausgabe des Add-ons, die zu dieser Version passt, und ersetze das alte Paket.
4. Starte neu und prüfe, ob die Zeilen verschwinden.

Gut zu wissen: Nach einem Update des Bedrock-Servers tauchen solche Zeilen oft gehäuft auf, bis die Ersteller ihre Add-ons angepasst haben.

Geyser erwartet Floodgate, aber Floodgate fehlt

So sieht die Meldung aus:

Auth-type set to Floodgate but Floodgate is not installed

Was dahintersteckt: In der Geyser-Konfiguration ist als Anmeldeart floodgate eingestellt. Damit sollen Bedrock-Spieler ohne zusätzliches Java-Konto beitreten können. Dafür muss das Plugin Floodgate aber installiert und aktiv sein. Fehlt es, schaltet Geyser sich ab, und Bedrock-Spieler kommen nicht auf den Server. Java-Spieler sind nicht betroffen.

So behebst du es:

1. Prüfe unter Plugins bzw. im Ordner plugins/, ob Floodgate vorhanden ist und ob es beim Start einen eigenen Fehler meldet.
2. Fehlt es, installiere Floodgate aus derselben Quelle wie Geyser und passend zu deiner Server-Software in den Ordner plugins/.
3. Willst du Floodgate nicht nutzen, setze stattdessen in plugins/Geyser-Spigot/config.yml den Wert auth-type auf online. Dann brauchen Bedrock-Spieler zusätzlich ein Java-Konto.
4. Starte den Server neu und teste den Beitritt mit Bedrock.

Ausführlich: Bedrock-Crossplay mit Geyser und Floodgate einrichten

Geyser kann die Sprachdateien nicht herunterladen

So sieht die Meldung aus:

[Geyser-Spigot] Unable to download and extract <Sprache> locale!

Was dahintersteckt: Beim Start lädt Geyser die Minecraft-Sprachdateien von Mojang herunter. Hier wurde diese Verbindung unterbrochen, darunter steht meist „Connection reset“. Bis zum nächsten erfolgreichen Start sehen Bedrock-Spieler unübersetzte Texte oder können gar nicht beitreten. Der Server selbst und Java-Spieler sind nicht betroffen.

So behebst du es:

1. Starte den Server neu. Oft klappt der Download beim nächsten Versuch.
2. Achte beim Start in der Konsole darauf, ob die Meldung wieder erscheint.
3. Bleibt sie, stoppe den Server und lösche unter Dateien den Ordner plugins/Geyser-Spigot/locales bzw. den Ordner .cache von Geyser.
4. Starte erneut und teste den Beitritt mit Bedrock.

Gut zu wissen: Folgt beim Beitritt die Meldung „Unable to load Geyser locale map“, ist das meist eine Folge dieses gescheiterten Downloads. Scheitert er über mehrere Starts hinweg, öffne ein Ticket und nenne die Uhrzeit der Meldung.

Geyser erreicht einen benötigten Netzwerkdienst nicht

So sieht die Meldung aus:

[Geyser-Spigot] Got an error
java.net.ConnectException: Connection refused

Was dahintersteckt: Geyser baut für seine Arbeit Verbindungen zu anderen Stellen auf, etwa zu einer eingetragenen Gegenstelle oder zu externen Diensten. Hier kam eine dieser Verbindungen nicht zustande. Die Zeile direkt darunter nennt den Grund: ConnectException heißt, die Gegenstelle hat abgelehnt, oft weil dort nichts läuft. NoRouteToHostException heißt, die Adresse ist gar nicht erreichbar. Was ausfällt, hängt von der Gegenstelle ab.

So behebst du es:

1. Lies die Zeilen unter „Got an error“ vollständig. Oft steht dort die Adresse, die Geyser erreichen wollte.
2. Hast du in plugins/Geyser-Spigot/config.yml eine Zieladresse oder einen Port geändert, vergleiche sie mit den Angaben im Panel und korrigiere sie.
3. Liegt das Ziel auf einem anderen Server, prüfe, ob dieser läuft und erreichbar ist.
4. Aktualisiere Geyser unter Plugins und starte den Server neu.

Gut zu wissen: Erscheint die Meldung nur einmal und Bedrock-Spieler kommen weiter auf den Server, kannst du sie zunächst beobachten, statt sofort einzugreifen.

Geyser kann seinen Bedrock-Port nicht öffnen

So sieht die Meldung aus:

[Geyser-Spigot] Failed to start Geyser on <IP>:<Port>

Was dahintersteckt: Geyser nimmt Bedrock-Verbindungen über einen eigenen UDP-Port an. UDP ist das Netzwerkprotokoll, das Bedrock für die Verbindung nutzt. Diesen Port konnte Geyser nicht öffnen: Entweder belegt ihn schon ein anderer Dienst, oder er ist deinem Server nicht zugewiesen und lässt sich deshalb nicht nutzen. Bedrock-Verbindungen funktionieren dann nicht, Java-Spieler kommen weiter auf den Server.

So behebst du es:

1. Lies im Panel ab, welcher Bedrock-Port (UDP) deinem Server zugewiesen ist.
2. Öffne unter Dateien die Datei plugins/Geyser-Spigot/config.yml und vergleiche im Abschnitt bedrock den Wert port. Er muss genau dem zugewiesenen Port entsprechen.
3. Prüfe, ob ein anderer UDP-Dienst denselben Port nutzt, etwa die Query (query.port in server.properties) oder ein Voice-Chat-Plugin. Jeder dieser Dienste braucht einen eigenen Port.
4. Speichere, starte den Server neu und teste den Beitritt mit Bedrock.

Ausführlich: Bedrock-Crossplay: Geyser, Floodgate und UDP-Port

Das Skript eines Add-ons hing und wurde abgebrochen

So sieht die Meldung aus:

[Watchdog] Unhandled critical exception of type '<Typ>' in behavior pack '<Add-on>'

Was dahintersteckt: Der Bedrock-Server überwacht die Skripte der Add-ons mit einem Wächter, dem Watchdog. Braucht ein Skript zu lange, bricht der Server es ab, damit nicht die ganze Welt stehen bleibt. Den Namen des Add-ons zeigt die Meldung hinter „behavior pack“. In diesem Moment kann der Server kurz ruckeln, und Funktionen des Add-ons fallen aus. Der Server selbst läuft weiter.

So behebst du es:

1. Lies den Namen des Add-ons aus der Meldung ab.
2. Prüfe beim Ersteller, ob es eine neuere Ausgabe für die Bedrock-Version deines Servers gibt (siehe Version), und installiere sie nach einer Sicherung.
3. Achte darauf, ob die Meldung bei einer bestimmten Aktion auftaucht, etwa beim Betreten eines Gebiets oder wenn viele Wesen an einer Stelle sind.
4. Kommt sie oft, deaktiviere das Add-on testweise und beobachte, ob das Ruckeln verschwindet.

Gut zu wissen: Eine einzelne Meldung ist kein Grund zur Sorge. Entscheidend ist, ob sie sich wiederholt.

Ein Berechtigungseintrag ohne XUID oder Stufe

So sieht die Meldung aus:

xuid or permission missing from permissions file

Was dahintersteckt: Auf einem Bedrock-Server legt die Datei permissions.json fest, wer welche Berechtigungsstufe hat, zum Beispiel Operator. Jeder Eintrag braucht zwei Angaben: die XUID, also die feste Kennung des Xbox- bzw. Microsoft-Kontos, und die Stufe. Fehlt eine davon, kann der Server den Eintrag keinem Spieler zuordnen und wendet ihn nicht an. Der Server läuft normal, nur diese Berechtigung greift nicht.

So behebst du es:

1. Öffne die Server-Konfiguration deines Servers und dort den Abschnitt „Berechtigungen (Ops)“.
2. Lösche die Zeile ohne XUID oder trage die XUID des Spielers nach.
3. Starte den Server danach neu.
4. Einfacher geht es mit dem Befehl op <Spieler> in der Konsole, während der Spieler online ist. Dann trägt der Server die XUID selbst ein.

Gut zu wissen: Auf Bedrock zählt die XUID, nicht der Spielername. Ein Eintrag ohne XUID bleibt deshalb wirkungslos, auch wenn der Name stimmt.

Deine Meldung ist nicht dabei?

Lies die ganze Meldung in der Konsole oder in logs/latest.log, auch die Zeilen direkt davor. Folgt ein Stacktrace, also eine Liste von Zeilen, die mit „at“ beginnen, zeigt er, wo der Fehler entstanden ist. Namen wie Geyser-Spigot.jar oder floodgate darin verraten das betroffene Plugin. Auf Bedrock-Servern nennen eckige Klammern oder Pfade unter behavior_packs/ das Add-on. Lege eine Sicherung an, bevor du etwas änderst. Kommst du nicht weiter, öffne ein Ticket und nenne die Uhrzeit der Meldung.