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.

Geyser kan zijn taalbestanden niet laden

Zo ziet de melding eruit:

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

Wat erachter zit: Geyser heeft voor elke Bedrock-speler het Minecraft-taalbestand van zijn taalinstelling nodig, bijvoorbeeld voor Duits of Brits Engels. Geyser downloadt deze bestanden bij het starten en slaat ze op in een eigen map. Is de download bij het starten mislukt of is de map beschadigd, dan vindt Geyser het bestand niet. Het toetreden van de Bedrock-speler mislukt dan, Java-spelers hebben hier geen last van.

Zo los je het op:

  1. Herstart de server via de Console. Geyser laadt de taalbestanden daarbij opnieuw.
  2. Lees het opstarten in de console mee. Staat daar „Unable to download and extract … locale“, dan is al de download mislukt. Daarvoor is verderop een apart onderdeel.
  3. Blijft de melding terugkomen, stop dan de server en verwijder onder Bestanden de map plugins/Geyser-Spigot/locales of de map .cache van Geyser.
  4. Start de server weer en laat een Bedrock-speler meedoen.

Goed om te weten: Deze mappen bevatten alleen gegevens die Geyser zelf weer downloadt. Je instellingen in config.yml blijven behouden.

Geyser meldt een fout in de sessie van een Bedrock-speler

Zo ziet de melding eruit:

[Geyser-Spigot] Exception caught in session of unknown (pre-login)
[Geyser-Spigot] Error thrown in <Player>'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. Gaat er bij die vertaling iets mis, dan wordt meestal alleen die ene speler losgekoppeld. De server en alle andere spelers draaien gewoon door. „pre-login“ betekent dat de verbinding al vóór het inloggen is verbroken. Een ReadTimeoutException eronder wijst op een weggevallen verbinding.

Zo los je het op:

  1. Noteer het tijdstip, de betreffende speler en wat hij 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. Herstart de server en laat de speler de handeling herhalen.
  4. Komt de fout steeds terug bij dezelfde speler of handeling, meld haar dan met de foutregel en de regels eronder in de Discord van het Geyser-project.

Goed om te weten: Bedrock-clients krijgen vaak updates, en een verouderde Geyser kan vaak niet overweg met nieuwe clients. Een enkele melding met „pre-login“ waar geen speler een probleem mee 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.

Add-on-pakketten laden niet netjes

Zo ziet de melding eruit:

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

Wat erachter zit: Elk add-on-pakket heeft een beschrijvingsbestand manifest.json. Daarin staan onder andere naam, identificatie, versie en de Bedrock-versie die het pakket minimaal nodig heeft. Vindt de server bij het starten daar fouten, dan somt hij ze ingesprongen onder deze regel op: 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. Ze noemen het pakket en de reden.
  2. Staat er „too high“, dan heeft de add-on een nieuwere Bedrock-versie nodig dan je server. Neem 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. Herstart 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.

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.