Hier staan de meldingen die rond Bedrock-spelers in het serverlog verschijnen. Ze komen uit twee richtingen: op een Java-server vertaalt de plugin Geyser de verbinding van Bedrock-spelers, en Floodgate laat hen zonder Java-account joinen. Op een native Bedrock-server (Bedrock Dedicated Server) komen de meldingen daarentegen meestal van add-ons, dus gedrags- en resourcepakketten.

Elke paragraaf behandelt precies één melding. De volledige tekst vind je in de Console, bij Java-servers bovendien onder Bestanden in logs/latest.log. Lees daar ook de regels direct eronder, want die noemen vaak het betreffende pakket of de eigenlijke oorzaak.

Voordat je configuratiebestanden, add-ons of wereldbestanden wijzigt, maak je onder Back-ups een back-up aan. Zo kun je altijd terug naar de oude stand.

„Unable to load Geyser locale map“: Geyser-taalbestand niet geladen

Zo ziet de melding eruit:

java.lang.AssertionError: Unable to load Geyser locale map for en_GB
Caught previously unhandled exception in Paper Async Command Builder Thread Pool - <Number>
java.lang.AssertionError: Unable to load Geyser locale map for de_DE

Wat erachter zit: Geyser kan benodigde taalgegevens niet laden. Bij het joinen via Bedrock mislukt daardoor het inloggen; de voorbeelden tonen de fout ook bij het opbouwen van commando's in Paper. In dat geval kunnen commandosuggesties worden beïnvloed, terwijl de server blijft draaien. Bijbehorende downloadfouten of beschadigde opgeslagen taalgegevens helpen om de oorzaak te achterhalen.

Zo los je het op:

  1. Start de server volledig opnieuw op en lees het opstarten mee in de Console.
  2. Controleer of daarnaast „Unable to download and extract … locale“ verschijnt. Deze melding gaat over het downloaden van de Minecraft-taalbestanden; hiervoor is verderop een eigen sectie.
  3. Blijft de fout bestaan, stop dan de server en maak een back-up van de Geyser-bestanden. Controleer bij Plugins of er een passende, actuele Geyser-versie beschikbaar is en vervang het pluginbestand terwijl de server gestopt is.
  4. Bij aanvullende download- of cachefouten maak je onder Bestanden een back-up van de betreffende gedownloade taalgegevens uit plugins/Geyser-Spigot/locales resp. Geysers .cache en verwijder je ze. Behoud je eigen aanpassingen en config.yml.
  5. Start opnieuw op en test het joinen via Bedrock en de commandosuggesties. Blijft de melding bestaan, open dan een ticket en vermeld het tijdstip van de melding.

„Exception caught in session …“: Geyser-verbinding van een Bedrock-speler verstoord

Zo ziet de melding eruit:

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

Wat erachter zit: Voor elke Bedrock-speler voert Geyser een eigen sessie uit en vertaalt daarin alles wat heen en weer gaat tussen de Bedrock-client en de Java-server. Als er bij deze vertaling iets misgaat, wordt meestal alleen die ene speler losgekoppeld; de server en alle andere spelers blijven gewoon doorlopen. „pre-login“ betekent dat de verbinding al vóór het inloggen is afgebroken; een ReadTimeoutException betekent dat gegevens niet op tijd aankwamen. Een IllegalAccessError bij formulieren kan de toegang tussen Geyser en Floodgate betreffen; controleer daarom beide samen.

Zo los je het op:

  1. Noteer het tijdstip, de betrokken speler en wat die speler op dat moment deed, bijvoorbeeld een menu openen of van wereld wisselen.
  2. Werk Geyser en Floodgate onder Plugins bij naar de nieuwste versie. Heb je ze zelf geüpload, vervang dan de oude JAR-bestanden in plugins/ in plaats van nieuwe ernaast te zetten.
  3. Start de server opnieuw op en laat de speler de handeling herhalen.
  4. Komt de fout steeds terug bij dezelfde speler of dezelfde handeling, meld haar dan met de foutregel en de regels eronder op de Discord van het Geyser-project.

Goed om te weten: Een enkele melding met „pre-login“ waarover geen enkele speler een probleem meldt, kun je negeren.

Een add-on meldt een scriptfout

Zo ziet de melding eruit:

[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?).

Wat erachter zit: Veel Bedrock-add-ons brengen eigen scripts mee in het gedragspakket. Deze regels worden gemeld door het script van de add-on zelf, de fout zit dus in de add-on en niet in de server. Typisch zijn toegangen tot een wezen dat niet meer bestaat of tot een gebied dat op dat moment niet geladen is. De server draait door, meestal valt alleen een functie van de add-on even uit. Bij heel veel meldingen kan de add-on de prestaties drukken.

Zo los je het op:

  1. Lees de naam van de add-on af. Die staat in de tweede rechte haak.
  2. Vergelijk de Bedrock-versie van je server onder Versie met de versies die de maker van de add-on noemt.
  3. Is er een nieuwere uitgave van de add-on, maak dan een back-up en installeer die volgens de handleiding van de maker.
  4. Verstoort de add-on het spel, schakel hem dan proefsgewijs uit. Daarvoor verwijder je onder Bestanden zijn vermelding uit worlds/<World>/world_behavior_packs.json en herstart je.

Goed om te weten: Inhoud die alleen de add-on meebrengt, kan bij het uitschakelen uit de wereld verdwijnen. De fout in het script kan alleen de maker verhelpen, de regels met „at“ helpen hem daarbij.

„The following issues were found when loading packs“: Bedrock-add-on bevat fouten

Zo ziet de melding eruit:

The following issues were found when loading packs:
Provided 'pack.name' element has an invalid value in pack manifest; Defaulting to resource pack.
The property '/header/min_engine_version' has a version of '<Versie>' which is too high. The highest value we accept is '<Versie>'.

Wat erachter zit: Elk add-onpakket heeft een beschrijvingsbestand manifest.json. Daarin staan onder andere de naam, de identificatie, de versie en de Bedrock-versie die het pakket minimaal nodig heeft. Vindt de server bij het starten daar fouten, dan toont hij die ingesprongen onder deze regel: eerst het pakket, daaronder de reden. Afhankelijk van de fout laadt hij het pakket helemaal niet of anders dan bedoeld, bijvoorbeeld als resourcepakket in plaats van als gedragspakket („Defaulting to resource pack“).

Zo los je het op:

  1. Lees de ingesprongen regels onder de melding. Daarin staan het pakket en de reden.
  2. Staat er „too high“, dan heeft de add-on een nieuwere Bedrock-versie nodig dan jouw server. Gebruik een oudere uitgave van de add-on of wacht tot de passende versie beschikbaar is onder Versie of Updates.
  3. Bij andere redenen helpt meestal de actuele uitgave van de add-on van de maker.
  4. Heb je manifest.json zelf bewerkt, controleer het bestand dan onder Bestanden. Het moet geldige JSON zijn (haakjes, komma's, aanhalingstekens) en alle verplichte velden bevatten, bijvoorbeeld format_version, header met name, uuid en version en modules.
  5. Start opnieuw op en controleer of de lijst verdwenen is.

De Geyser-configuratie kan niet worden gelezen

Zo ziet de melding eruit:

[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: …

Wat erachter zit: Geyser leest zijn instellingen uit plugins/Geyser-Spigot/config.yml. Het bestand is geschreven in YAML, een tekstformaat waarin inspringing met spaties en dubbele punten de structuur bepalen. Een ParsingException eronder betekent: het bestand is op één plek beschadigd, vaak na handmatig bewerken. Minder vaak is het verouderd of niet leesbaar of beschrijfbaar. Zonder geldige configuratie start Geyser in de regel niet, en Bedrock-spelers komen niet op de server. Java-spelers merken hier niets van.

Zo los je het op:

  1. Stop de server en open onder Bestanden het bestand plugins/Geyser-Spigot/config.yml.
  2. Controleer de regels die de foutmelding noemt: tabs in plaats van spaties, verschoven inspringing, ontbrekende dubbele punt of een niet gesloten aanhalingsteken.
  3. Vind je de fout niet, hernoem het bestand dan, bijvoorbeeld naar config.yml.alt. Geyser maakt bij de volgende start een nieuw standaardbestand aan.
  4. Neem daarna alleen de nodige waarden over uit het oude bestand. De Bedrock-poort moet overeenkomen met de UDP-poort die het paneel aan je server toewijst.
  5. Start de server en controleer in de Console of Geyser zonder fouten start.

Goed om te weten: Meldt ook een nieuw aangemaakt bestand de fout, dan ligt het eerder aan de bestandsrechten. Kom je er niet uit, open dan een ticket en noem het tijdstip van de melding.

Floodgate is dubbel geladen

Zo ziet de melding eruit:

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

Wat erachter zit: Floodgate haakt bij het starten in op de netwerkverbinding van de server, zodat het Bedrock-spelers kan herkennen. Die ingreep mag er maar één keer zijn. De melding laat zien dat Floodgate een tweede keer is geladen. Meestal staan er twee Floodgate-bestanden in de map plugins/, bijvoorbeeld een oude en een nieuwe versie. Soms brengt ook een andere plugin Floodgate zelf mee. Bedrock-spelers kunnen dan bij het toetreden mislukken.

Zo los je het op:

  1. Open onder Bestanden de map plugins/ en zoek alle bestanden met „floodgate“ in de naam die op .jar eindigen.
  2. Houd er maar één van over, het liefst de nieuwste, en verwijder de rest.
  3. Controleer bij recent geïnstalleerde plugins of ze volgens hun beschrijving Floodgate bevatten. Dan heb je maar één van beide bronnen nodig.
  4. Herstart de server en laat een Bedrock-speler meedoen.

Goed om te weten: De map plugins/floodgate is geen tweede plugin. Ze bevat de instellingen en de sleutel van Floodgate en blijft bestaan.

Een add-on bevat items die de server niet begrijpt

Zo ziet de melding eruit:

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

Wat erachter zit: Add-ons beschrijven wezens, voorwerpen, blokken, animaties en delen van de wereldgeneratie in eigen bestanden. Begrijpt de Bedrock-server een van deze items in zijn versie niet, dan schrijft hij zo'n regel in het log. "Feature rule" gaat bijvoorbeeld over regels die planten of structuren in de wereld verspreiden. Dat deel van de add-on werkt dan niet of maar gedeeltelijk, de rest en de server blijven draaien. Meestal is de add-on gebouwd voor een andere Bedrock-versie.

Zo los je het op:

  1. Zoek het betreffende pakket. Het deel voor de dubbele punt is meestal de afkorting van de add-on, andere regels noemen het pad behavior_packs/….
  2. Kijk onder Versie welke Bedrock-versie je server heeft.
  3. Maak een back-up, download bij de maker de uitgave van de add-on die bij deze versie past en vervang het oude pakket.
  4. Start opnieuw op en controleer of de regels verdwijnen.

Goed om te weten: Na een update van de Bedrock-server verschijnen zulke regels vaak in groten getale, totdat de makers hun add-ons hebben aangepast.

Geyser verwacht Floodgate, maar Floodgate ontbreekt

Zo ziet de melding eruit:

Auth-type set to Floodgate but Floodgate is not installed

Wat erachter zit: In de Geyser-configuratie is als aanmeldmethode floodgate ingesteld. Hiermee kunnen Bedrock-spelers zonder extra Java-account meedoen. Daarvoor moet de plugin Floodgate wel geïnstalleerd en actief zijn. Ontbreekt die, dan schakelt Geyser zichzelf uit en komen Bedrock-spelers niet op de server. Java-spelers hebben er geen last van.

Zo los je het op:

  1. Controleer onder Plugins of in de map plugins/ of Floodgate aanwezig is en of het bij het opstarten een eigen foutmelding geeft.
  2. Ontbreekt het, installeer Floodgate dan uit dezelfde bron als Geyser en passend bij je serversoftware in de map plugins/.
  3. Wil je Floodgate niet gebruiken, zet dan in plugins/Geyser-Spigot/config.yml de waarde auth-type op online. Bedrock-spelers hebben dan wel een extra Java-account nodig.
  4. Start de server opnieuw op en test het meedoen met Bedrock.

Uitgebreid: Bedrock-crossplay met Geyser en Floodgate instellen

Geyser kan de taalbestanden niet downloaden

Zo ziet de melding eruit:

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

Wat erachter zit: Bij het opstarten downloadt Geyser de Minecraft-taalbestanden van Mojang. Hier is die verbinding verbroken, daaronder staat meestal "Connection reset". Tot de volgende geslaagde start zien Bedrock-spelers onvertaalde teksten of kunnen ze helemaal niet meedoen. De server zelf en Java-spelers hebben er geen last van.

Zo los je het op:

  1. Start de server opnieuw op. Vaak lukt de download bij de volgende poging.
  2. Let bij het opstarten in de Console op of de melding weer verschijnt.
  3. Blijft ze terugkomen, stop dan de server en verwijder onder Bestanden de map plugins/Geyser-Spigot/locales of de map .cache van Geyser.
  4. Start opnieuw op en test het meedoen met Bedrock.

Goed om te weten: Volgt er bij het meedoen de melding "Unable to load Geyser locale map", dan is dat meestal een gevolg van deze mislukte download. Mislukt hij over meerdere starts heen, open dan een ticket en noem de tijd van de melding.

Geyser bereikt een benodigde netwerkdienst niet

Zo ziet de melding eruit:

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

Wat erachter zit: Geyser bouwt voor zijn werk verbindingen op naar andere plekken, bijvoorbeeld naar een ingevoerde tegenpartij of naar externe diensten. Hier kwam een van die verbindingen niet tot stand. De regel direct daaronder noemt de reden: ConnectException betekent dat de tegenpartij de verbinding heeft geweigerd, vaak omdat daar niets draait. NoRouteToHostException betekent dat het adres helemaal niet bereikbaar is. Wat uitvalt, hangt af van de tegenpartij.

Zo los je het op:

  1. Lees de regels onder "Got an error" helemaal. Vaak staat daar het adres dat Geyser wilde bereiken.
  2. Heb je in plugins/Geyser-Spigot/config.yml een doeladres of een poort gewijzigd, vergelijk die dan met de gegevens in het paneel en corrigeer ze.
  3. Staat het doel op een andere server, controleer dan of die draait en bereikbaar is.
  4. Werk Geyser bij onder Plugins en start de server opnieuw op.

Goed om te weten: Verschijnt de melding maar één keer en kunnen Bedrock-spelers gewoon op de server komen, dan kun je het eerst even aanzien in plaats van meteen in te grijpen.

Geyser kan zijn Bedrock-poort niet openen

Zo ziet de melding eruit:

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

Wat erachter zit: Geyser accepteert Bedrock-verbindingen via een eigen UDP-poort. UDP is het netwerkprotocol dat Bedrock voor de verbinding gebruikt. Geyser kon deze poort niet openen: of een andere dienst gebruikt hem al, of hij is niet aan je server toegewezen en kan daarom niet worden gebruikt. Bedrock-verbindingen werken dan niet, Java-spelers komen nog wel op de server.

Zo los je het op:

  1. Lees in het paneel af welke Bedrock-poort (UDP) aan je server is toegewezen.
  2. Open onder Bestanden het bestand plugins/Geyser-Spigot/config.yml en vergelijk in het gedeelte bedrock de waarde port. Die moet precies overeenkomen met de toegewezen poort.
  3. Controleer of een andere UDP-dienst dezelfde poort gebruikt, bijvoorbeeld de query (query.port in server.properties) of een voicechat-plugin. Elk van deze diensten heeft een eigen poort nodig.
  4. Sla op, start de server opnieuw op en test het meedoen met Bedrock.

Uitgebreid: Bedrock-crossplay: Geyser, Floodgate en UDP-poort

Het script van een add-on liep vast en is afgebroken

Zo ziet de melding eruit:

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

Wat erachter zit: De Bedrock-server houdt de scripts van add-ons in de gaten met een bewaker, de watchdog. Duurt een script te lang, dan breekt de server het af, zodat niet de hele wereld stilvalt. De naam van de add-on staat in de melding achter "behavior pack". Op dat moment kan de server even haperen en vallen functies van de add-on uit. De server zelf blijft draaien.

Zo los je het op:

  1. Lees de naam van de add-on af uit de melding.
  2. Controleer bij de maker of er een nieuwere uitgave is voor de Bedrock-versie van je server (zie Versie) en installeer die na een back-up.
  3. Let erop of de melding bij een bepaalde actie verschijnt, bijvoorbeeld bij het betreden van een gebied of wanneer veel wezens op één plek zijn.
  4. Komt ze vaak voor, zet de add-on dan om te testen uit en kijk of het haperen verdwijnt.

Goed om te weten: Een enkele melding is geen reden tot zorg. Bepalend is of ze zich herhaalt.

Een rechtenvermelding zonder XUID of niveau

Zo ziet de melding eruit:

xuid or permission missing from permissions file

Wat erachter zit: Op een Bedrock-server bepaalt het bestand permissions.json wie welk rechtenniveau heeft, bijvoorbeeld operator. Elke vermelding heeft twee gegevens nodig: de XUID, oftewel de vaste identificatie van het Xbox- of Microsoft-account, en het niveau. Ontbreekt een van beide, dan kan de server de vermelding niet aan een speler koppelen en past hij deze niet toe. De server draait normaal, alleen dit recht werkt niet.

Zo los je het op:

  1. Open de serverconfiguratie van je server en ga daar naar het gedeelte "Rechten (Ops)".
  2. Verwijder de regel zonder XUID of vul de XUID van de speler alsnog in.
  3. Start de server daarna opnieuw op.
  4. Eenvoudiger gaat het met het commando op <speler> in de Console, terwijl de speler online is. Dan voegt de server de XUID zelf toe.

Goed om te weten: Op Bedrock telt de XUID, niet de spelersnaam. Een vermelding zonder XUID blijft daarom zonder effect, ook als de naam klopt.

Floodgate breekt het instellen van zijn interne onderdelen af

Zo ziet de melding eruit:

Unable to create injector, see the following errors:
IllegalStateException: Couldn't create lambda for: "MethodHandle(PlayerLinkHolder,ShutdownEvent)void"

Wat erachter zit: De injector is de inrichting van de interne bouwstenen van de plugin. Hier lukt het Floodgate niet om een event-handler voor de accountkoppeling aan te maken. Daarom start Floodgate niet volledig op. De Bedrock-aanmelding die Floodgate nodig heeft, is daardoor niet beschikbaar.

Zo los je het op:

  1. Lees het volledige foutrapport in de Console of onder Bestanden in logs/latest.log.
  2. Noteer de serversoftware en de versies van Java, Geyser en Floodgate uit het startlogboek.
  3. Controleer de ondersteunde omgevingen van het Floodgate-project. Installeer passende versies van Floodgate en Geyser; bij hybride software controleer je expliciet of die wordt ondersteund.
  4. Start de server volledig opnieuw op en test het joinen met Bedrock. Blijft de fout bestaan, meld die dan met het volledige rapport bij het Floodgate-project.

Bedrock kan de rechtenlijst niet inlezen

Zo ziet de melding eruit:

Malformed permissions file. Top level needs to be an array [], with inner levels nested in {}

Wat erachter zit: De Bedrock-server kan zijn rechtenlijst niet inlezen. Het bestand gebruikt JSON, een gestructureerd tekstformaat. Aan de buitenkant moet een lijst tussen vierkante haken staan, daarbinnen telkens een rechtenvermelding tussen accolades. Een andere structuur zorgt ervoor dat deze vermeldingen niet worden overgenomen.

Zo los je het op:

  1. Stop de server. Maak onder Bestanden een back-up van de bestaande permissions.json voordat je het bestand bewerkt.
  2. Herstel een werkende versie of corrigeer de structuur: aan de buitenkant [ en ], binnenin de afzonderlijke objecten met { en }. Scheid meerdere objecten met komma's.
  3. Behoud de bestaande vermeldingen en gebruik dubbele aanhalingstekens voor veldnamen en tekstwaarden. Verwijder overbodige komma's en sluit alle haken.
  4. Sla het bestand op, start de server opnieuw en controleer de Console. Test daarna of de bedoelde rechten weer gelden.

Goed om te weten: Een lege lijst verwijdert de ingestelde speciale rechten. Gebruik deze niet als vervanging voor het repareren van bestaande vermeldingen.

Geyser: externe signalering krijgt geen ICE-UDP-eindpunt

Zo ziet de melding eruit:

[Geyser-Spigot] Could not start the external signaling service
java.lang.IllegalStateException: Cannot acquire ICE UDP mux endpoint
Failed to register pending ICE UDP mux listener

Wat erachter zit: ICE regelt het opzetten van een dataverbinding. De UDP-multiplexer verdeelt netwerkpakketten over één gezamenlijk eindpunt. De listener daarvan kan hier niet worden ingesteld. In Geyser valt daardoor de externe signalering voor nieuwe verbindingen weg; de gameserver blijft gewoon draaien.

Zo los je het op:

  1. Lees de voorafgaande netwerkfouten in de Console. Let op andere meldingen over de initialisatie of over het binden van de UDP-poort.
  2. Controleer onder Bestanden de Geyser-instellingen voor transport, signalering en UDP-poort aan de hand van de actuele Geyser-documentatie.
  3. Controleer onder Plugins of er een passende Geyser-update beschikbaar is. Wijzig het signaleringstype alleen als dat past bij de verbindingsopzet die je wilt gebruiken.
  4. Start na de correctie volledig opnieuw op en test een nieuwe verbinding. Blijft de fout bestaan, open dan een ticket en vermeld het tijdstip en alle bijbehorende meldingen in hun geheel.

Staat jouw melding er niet bij?

Lees de hele melding in de Console of in logs/latest.log, ook de regels direct ervoor. Volgt er een stacktrace, dus een lijst regels die met „at“ beginnen, dan laat die zien waar de fout is ontstaan. Namen als Geyser-Spigot.jar of floodgate daarin verraden de betreffende plugin. Op Bedrock-servers noemen blokhaken of paden onder behavior_packs/ de add-on. Maak een back-up aan voordat je iets wijzigt. Kom je er niet uit, open dan een ticket en geef het tijdstip van de melding door.