De wereld van je Minecraft-server bestaat uit veel bestanden: level.dat met de basisgegevens, regiobestanden met de chunks (wereldsecties van 16 × 16 blokken), spelergegevens en lijsten zoals ops.json. Gaat er bij het opslaan iets mis of past een bestand niet bij de serverversie, dan schrijft de server een melding naar de log. Elk onderstaand onderdeel behandelt precies één van deze meldingen: hoe die eruitziet, wat erachter zit en wat je kunt doen. Eerst komen fouten waarbij wereldvoortgang verloren kan gaan, daarna waarschuwingen waarbij de server meestal gewoon doorloopt.

De volledige melding inclusief de regels ervoor vind je in de Console of onder Bestanden in logs/latest.log. Maak vóór elke ingreep in wereld- of configuratiebestanden een back-up aan onder Back-ups. Wat bij het volgende opslaan wordt overschreven, krijg je alleen terug uit een back-up.

Wereldgegevens konden niet worden opgeslagen

Zo ziet de melding eruit:

Could not save data to raids_end.dat
java.nio.file.NoSuchFileException: ./<Wereld>/DIM1/data/raids_end.dat
Failed to save level ./<Wereld>

Een derde variant luidt Failed to save player data for <Speler>.

Wat er speelt: De server wilde wereldgegevens schrijven, bijvoorbeeld het hoofdbestand van de wereld, aanvullende gegevens zoals raids of de gegevens van een speler. Daarbij ontbrak een bestand of map die hij verwachtte. NoSuchFileException betekent precies dat: bestand niet aanwezig. Alles wat er sinds de laatste geslaagde opslag is gebeurd, kan hierbij verloren gaan. Veelvoorkomende oorzaken zijn volle opslagruimte of een wereldmap die tijdens het draaien is verwijderd, hernoemd of via een upload is vervangen.

Zo los je het op:

  1. Controleer of de opslagruimte van je server vol is. Staat er in het log bovendien No space left on device, ruim dan eerst op (sectie „Geen vrije opslagruimte meer“).
  2. Wijzig wereldmappen alleen bij een gestopte server. Uploaden of verwijderen terwijl de server draait leidt precies tot deze melding.
  3. Start de server opnieuw op en voer in de Console save-all in. Hiermee forceer je een opslag. Blijft de melding uit, dan is het probleem opgelost.
  4. Komt de melding terug of ontbreken bouwwerken, inventarissen of voortgang, zet dan onder Back-ups een stand van vóór de fout terug.

Uitgebreid: Opslagruimte vol: „No space left on device“ oplossen

Wereld komt uit een nieuwere Minecraft-versie

Zo ziet de melding eruit:

java.lang.RuntimeException: Server attempted to load chunk saved with newer version of minecraft! 5023 > 4903

Wat er speelt: Elke chunk, dus elk wereldgedeelte van 16 × 16 blokken, slaat op met welke dataversie hij is geschreven. Het eerste getal is de dataversie van de chunk, het tweede die van je server. Is het eerste groter, dan draaide de wereld voor het laatst op een nieuwere Minecraft-versie dan nu. Deze chunks kunnen niet worden geladen. Doorspelen op de oudere versie is geen oplossing, want een downgrade kan de wereld beschadigen.

Zo los je het op:

  1. Stop de server.
  2. Stel onder Versie weer de Minecraft-versie in waarmee de wereld voor het laatst draaide, of een nieuwere.
  3. Heb je de wereld geüpload, kies dan de versie waarmee hij voor het laatst in singleplayer of op de oude server is gespeeld.
  4. Wil je echt terug naar de oudere versie, zet dan onder Back-ups een back-up van vóór de versiewissel terug en stel pas daarna de oude versie in.

Goed om te weten: De getallen zijn geen versienummers zoals 1.21, maar interne dataversies. Een hoger getal staat altijd voor een nieuwere versie. Meer hierover: Minecraft-versie en modloader veilig wijzigen

Hoofdbestand van de wereld (level.dat) is beschadigd

Zo ziet de melding eruit:

Failed to load world data from ./<Wereld>/level.dat

Wat er speelt: In level.dat staan de basisgegevens van je wereld. Kan de server dit bestand niet lezen, dan valt hij terug op de reservekopie level.dat_old. Is ook die beschadigd, dan sluit de server af en start hij niet meer. Meestal is de server tijdens het opslaan abrupt beëindigd, of is een upload onvolledig gebleven.

Zo los je het op:

  1. Stop de server als hij nog draait.
  2. Maak onder Back-ups een back-up van de huidige stand, ook als die defect is. Zo kun je elke volgende poging ongedaan maken.
  3. Zet onder Back-ups de wereld terug uit een stand van vóór de fout. Wil je de nieuwere voortgang behouden, dan volstaat vaak alleen de level.dat: haal hem uit een gedownloade back-up en upload hem onder Bestanden naar de wereldmap.
  4. Heb je de wereld zelf geüpload, upload hem dan volledig opnieuw en wacht tot de upload echt is afgerond.
  5. Start de server en controleer in de Console of de wereld laadt.

Goed om te weten: Stop de server normaal met stop in de Console in plaats van hem abrupt te beëindigen. Dat is de beste bescherming tegen deze melding. Over het uploaden: Minecraft-wereld uploaden en veilig wisselen

Wereld wordt niet opgeslagen: vergrendelbestand session.lock bezet

Zo ziet de melding eruit:

Couldn't save chunk; already in use by another instance of Minecraft?
Failed to check session lock for world <Wereld>

Wat er speelt: Minecraft maakt in de wereldmap het bestand session.lock aan. Het geeft aan dat er op dat moment een server met deze wereld werkt. Denkt de server dat een ander proces de wereld gebruikt, dan slaat hij geen chunks meer op. Meestal is het bestand na een crash of een upload blijven staan. Wat er sinds de laatste geslaagde opslag is gebouwd, kan bij een herstart verloren gaan.

Zo los je het op:

  1. Stop de server.
  2. Open onder Bestanden de wereldmap die de melding noemt en verwijder daar het bestand session.lock. Heeft je server meerdere wereldmappen, bijvoorbeeld voor de Nether en het End, controleer die dan ook.
  3. Start de server opnieuw.
  4. Voer in de Console save-all in en controleer of de melding uitblijft.

Goed om te weten: Upload je een wereld, dan kun je session.lock gewoon weglaten. De server maakt het bestand bij het starten zelf opnieuw aan.

Geen vrije opslagruimte meer

Zo ziet de melding eruit:

java.io.IOException: No space left on device

Wat er speelt: De opslagruimte van je server is vol. Elke schrijfactie mislukt dan: de wereld wordt niet meer opgeslagen, logs breken af en nieuwe back-ups kunnen niet worden gemaakt. Ook als de server schijnbaar doorloopt, gaan wijzigingen stilletjes verloren.

Zo los je het op:

  1. Stop de server, zodat hij tijdens het opruimen niet verder naar de wereld schrijft.
  2. Verwijder onder Bestanden eerst wat veilig weg kan: oude logbestanden in logs/, gelezen crashrapporten in crash-reports/ en geüploade archieven (.zip, .tar.gz) waarvan je de inhoud al hebt uitgepakt.
  3. Ruim oude back-ups op die je niet meer nodig hebt.
  4. Verwijder geen afzonderlijke regiobestanden van de wereld om ruimte te maken. Daarmee verwijder je delen van je wereld.
  5. Start de server en controleer in de Console of de melding uitblijft.
  6. Is de opslagruimte structureel krap, kies dan onder Instellingen & abonnement → Plan een groter pakket.

Uitgebreid: Opslagruimte vol: „No space left on device“ oplossen

Onveilige chunktoegang tijdens het genereren van de wereld

Zo ziet de melding eruit:

Detected unsafe terrain read during worldgen: reading from chunk [<x>, <z>] while generating chunk [<x>, <z>] (distance: 2, write radius: 1), step: minecraft:features, currently generating: ResourceKey[minecraft:worldgen/placed_feature / minecraft:sculk_patch_deep_dark]

Wat er speelt: Bij het aanmaken van een nieuwe chunk plaatst de server features zoals bomen, ertsen of sculk-vlakken. Elke feature mag daarbij maar in een kleine omtrek lezen. De melding laat zien dat er een verder heeft gegrepen. Achter currently generating staat welke: minecraft: staat voor vanilla, een andere naam meestal voor een worldgen-datapack (een datapack dat de wereldgeneratie wijzigt) of een mod. De server draait gewoon door. Mogelijk zijn lagpieken tijdens het verkennen en zelden onzuivere overgangen bij chunkgrenzen.

Zo los je het op:

  1. Werk Paper of je Paper-fork onder Versie bij naar de nieuwste build van je Minecraft-versie.
  2. Staat achter currently generating de naam van een datapack of mod, werk dat datapack of die mod dan bij onder Mods.
  3. Helpt dat niet, schakel het dan proefsgewijs uit. Maak vooraf onder Back-ups een back-up, want een bestaande wereld kan gevoelig reageren op ontbrekende worldgen-inhoud.
  4. Komt de melding daarna nog steeds massaal voor, open dan een ticket en noem het tijdstip van de melding.

Goed om te weten: Wie de wereld vooraf genereert, haalt dit werk uit het spelverloop: Chunky: Minecraft-wereld vooraf genereren

Whitelist-, OP- of banlijst is beschadigd

Zo ziet de melding eruit:

Unable to read file ops.json, backing it up to ops.json.backup and creating new copy.
com.google.gson.JsonSyntaxException: com.google.gson.stream.MalformedJsonException: … at line 21 column 2 path $

Wat erachter zit: whitelist.json, ops.json, banned-players.json en banned-ips.json zijn lijsten in JSON-formaat, een strikt tekstformaat met haakjes, komma's en aanhalingstekens. Al een ontbrekende komma maakt het bestand onleesbaar, meestal na het handmatig bewerken. Minecraft bewaart het kapotte bestand dan als .backup en maakt een lege lijst aan. De server blijft draaien, maar afhankelijk van het bestand ontbreken OP-rechten, whitelist-vermeldingen of bans.

Zo los je het op:

  1. Stop de server.
  2. Open onder Bestanden het bestand met de extensie .backup, bijvoorbeeld ops.json.backup.
  3. De melding noemt meestal de regel en kolom van de fout. De hele lijst staat tussen rechte haken, elke vermelding tussen accolades, vermeldingen worden gescheiden door een komma, na de laatste staat er geen. Een kale spelersnaam zonder accolades is geen geldige vermelding.
  4. Verwijder het nieuw aangemaakte lege bestand en hernoem het gecorrigeerde .backup-bestand terug, bijvoorbeeld naar ops.json.
  5. Start de server. Als alternatief voeg je de vermeldingen opnieuw toe met een commando: whitelist add <Speler> of op <Speler> in de Console.

Goed om te weten: Beheer je deze lijsten alleen met commando's, dan schrijft Minecraft het formaat zelf. Meer hierover: Whitelist instellen

Wereldinstellingen onleesbaar: server gebruikt standaardwaarden

Zo ziet de melding eruit:

Unable to read or access the world gen settings file! Falling back to the default settings with a random world seed. ./<Wereld>/dimensions/minecraft/overworld/data/minecraft/world_gen_settings.dat

Wat erachter zit: Het bestand world_gen_settings.dat bepaalt hoe de wereld wordt gegenereerd, zoals de seed en het wereldtype. Kon de server het niet lezen, dan start hij verder met standaardwaarden en een willekeurige seed. Eigen instellingen worden dan niet toegepast. Al gegenereerde gebieden worden geladen zoals ze zijn opgeslagen. Nieuwe gebieden ontstaan echter met de standaardwaarden en passen mogelijk niet bij de rest.

Zo los je het op:

  1. Is de wereld nieuw en heb je niets bijzonders ingesteld, dan is de melding meestal niet kritiek.
  2. Heb je een eigen seed of wereldtype ingesteld, sla die waarden dan opnieuw op onder Instellingen en herstart de server.
  3. Hoort het bestand bij een bestaande wereld met bouwwerken, stop dan de server voordat er nieuwe gebieden ontstaan en haal het bestand of de wereld terug uit een back-up onder Back-ups.
  4. Controleer na de herstart in de Console of de melding wegblijft.

Goed om te weten: Met seed in de Console zie je welke seed momenteel actief is. Meer hierover: Wereldseed vinden en instellen

Wereld bevat blokken van een verwijderde mod of datapack

Zo ziet de melding eruit:

Recoverable errors when loading section [2, 11, 5]: (Unknown registry key in ResourceKey[minecraft:root / minecraft:block]: <mod>:<block> -> using default)

Wat erachter zit: Bij het laden van een wereldsectie zijn blokken of objecten opgedoken die de server niet meer kent. Vrijwel altijd is een mod of een datapack verwijderd of vervangen. De naam voor de dubbele punt laat zien waar het blok vandaan komt. Minecraft vervangt deze plekken door lucht en laadt de rest van de wereld normaal. De server blijft draaien, maar op de betreffende plekken ontbreken blokken.

Zo los je het op:

  1. Heb je de mod of het datapack bewust verwijderd, dan is de melding te verwachten. Ze verdwijnt zodra alle betreffende gebieden één keer zijn geladen.
  2. Ontbreken er bouwwerken die je wilt behouden, stop dan meteen de server en maak onder Back-ups een back-up. Bij de volgende keer opslaan zijn de ontbrekende blokken definitief weg.
  3. Installeer de mod onder Mods opnieuw in dezelfde versie, of het datapack in de map datapacks van de wereld, en start de server opnieuw.
  4. Ontbreken er daarna nog steeds blokken, dan zijn de gebieden al opgeslagen. Dan helpt alleen een back-up van vóór het verwijderen.

Goed om te weten: Staat er voor de dubbele punt minecraft:, dan komt het blok meestal uit een nieuwere Minecraft-versie dan die van je server.

Defecte entiteit is verwijderd om een crash te voorkomen

Zo ziet de melding eruit:

Entity threw exception at minecraft:overworld:<x>,<y>,<z>
java.lang.NullPointerException

Wat erachter zit: Een entiteit is alles wat zich in de wereld beweegt of eigen gegevens met zich meedraagt: mobs, dorpelingen, NPC's, gevallen items. Bij de berekening van een tick, een van de 20 rekenstappen per seconde, heeft een van deze entiteiten een fout veroorzaakt. Paper heeft haar verwijderd, zodat de server niet crasht. De server blijft draaien, maar de entiteit op die positie is weg. Meestal heeft een plugin of een mod haar eerder gewijzigd.

Zo los je het op:

  1. Open onder Bestanden logs/latest.log en lees de regels onder de melding. Deze stacktrace is de lijst met programmaonderdelen die tot de fout hebben geleid.
  2. Paper zet achter veel van deze regels de bestandsnaam tussen rechte haken, bijvoorbeeld ~[<Plugin>-<Versie>.jar:?]. Daaraan herken je de betrokken plugin.
  3. Werk deze plugin bij onder Plugins of de mod onder Mods.
  4. Herhaalt de melding zich op dezelfde positie, dan was daar een beschadigde entiteit. Die is nu verwijderd, verdere stappen zijn meestal niet nodig.

Meer over pluginfouten: Plugin geeft fouten tijdens het draaien

POI-gegevens komen niet overeen met de chunk

Zo ziet de melding eruit:

POI data mismatch: never registered at BlockPos{x=<x>, y=<y>, z=<z>}

Wat erachter zit: POI staat voor Point of Interest. Zo onthoudt Minecraft bijzondere blokken zoals bedden, werkplekken van dorpelingen, bijennesten of netherportalen. Deze vermeldingen staan los van de blokken in de map poi van de wereld. Op de genoemde positie vond Minecraft geen passende vermelding. Losse meldingen kunnen optreden bij het laden of na een versiewissel. Komt steeds hetzelfde gebied terug, dan zijn de POI- of chunkgegevens inconsistent.

Zo los je het op:

  1. Maak onder Back-ups een back-up van de wereld.
  2. Werk Paper onder Versie bij naar de nieuwste build van je Minecraft-versie.
  3. Noteer de coördinaten en kijk of dezelfde regio steeds terugkomt.
  4. Alleen dan controleer je de regio met een geschikt wereldhulpmiddel, altijd op een kopie van de wereld. Kom je er niet uit, open dan een ticket en vermeld het tijdstip van de melding.

Goed om te weten: Losse meldingen zonder herhaling kun je laten staan. Over hulpmiddelen en aanpak: Minecraft-chunks ontbreken: schade controleren en redden

Ongebruikelijke teleportatie van een entiteit tussen werelden

Zo ziet de melding eruit:

Illegal Entity Teleport Zombie['Zombie'/<ID>, l='ServerLevel[<Wereld>_nether]', x=<x>, y=<y>, z=<z>, …] to ServerLevel[<Wereld>]:(<x>, <y>, <z>)
java.lang.Throwable: null

Wat erachter zit: Minecraft heeft gemerkt dat een entiteit, hier een zombie, in een onverwachte toestand tussen werelden of chunks is geteleporteerd, bijvoorbeeld via een portaal. De regels met java.lang.Throwable eronder zijn geen crash. Ze laten alleen zien vanuit welk programmaonderdeel de teleportatie kwam. De melding alleen bewijst geen pluginfout, en de server blijft draaien.

Zo los je het op:

  1. Werk Paper onder Versie bij naar de nieuwste build van je Minecraft-versie.
  2. Kijk of de melding terugkomt. Een enkele melding kun je laten staan.
  3. Herhaalt ze zich, lees dan de volledige stacktrace in logs/latest.log. Staat daar een portaal- of teleportplugin, werk die dan bij onder Plugins.
  4. Helpt de update niet, schakel dan de betreffende functie van deze plugin tijdelijk uit in de configuratie en kijk opnieuw.

Een entiteit kon niet worden opgeslagen

Zo ziet de melding eruit:

Entity type entity.minecraft.villager failed to serialize
net.minecraft.ReportedException: Saving entity NBT

Wat erachter zit: Bij het opslaan schrijft de server elke entiteit met zijn gegevens naar de wereldbestanden. NBT is het opslagformaat dat Minecraft hiervoor gebruikt. Bij een entiteit, in het voorbeeld een dorpeling, is dat mislukt, omdat zijn gegevens iets bevatten wat de server niet kan schrijven. Vaak is dat een voorwerp uit een plugin of mod, bijvoorbeeld in een handelsaanbod. De server draait door, maar de entiteit kan na een herstart ontbreken.

Zo los je het op:

  1. Lees in logs/latest.log de regels onder de melding. Een regel met Caused by noemt de eigenlijke oorzaak.
  2. Gaat het om handelaren, controleer dan plugins die handelsaanbiedingen wijzigen, bijvoorbeeld winkel- of handelaarsplugins, en werk ze bij onder Plugins.
  3. Houd Paper onder Versie op de nieuwste build van je Minecraft-versie.
  4. Start de server opnieuw en kijk of de melding terugkomt.

Goed om te weten: Is een belangrijke entiteit verdwenen, dan haalt alleen een back-up hem terug. Daarmee zet je wel de hele wereld terug naar die staat.

Extra gegevens van de wereld onleesbaar: standaardwaarden actief

Zo ziet de melding eruit:

Failed to parse saved data for 'SavedDataType[minecraft:<DataType>]': <Reason>

Wat erachter zit: Naast de chunks slaat een wereld extra gegevens op in eigen bestanden, zoals spelregels, tijden of willekeurige reeksen. Een van deze bestanden past niet bij de serverversie. Meestal is de wereld eerder opgeslagen met een andere Minecraft-versie of een andere selectie mods. De server start toch en gebruikt voor dit onderdeel standaardwaarden. Eigen spelregels kunnen daardoor weer op de standaardwaarde staan.

Zo los je het op:

  1. Vraag gewijzigde spelregels in de Console op met gamerule <Rule>.
  2. Stel afwijkende waarden opnieuw in met gamerule <Rule> <Value>.
  3. Speel een wereld nooit af op een oudere versie dan die waarmee hij voor het laatst is opgeslagen. Stel onder Versie weer de passende versie in.
  4. Wil je de oude staat volledig terug, speel dan onder Back-ups een back-up van vóór de wissel terug.

Goed om te weten: Het gegevenstype in de melding laat zien welk onderdeel is getroffen. Over de spelregels: Minecraft-spelregels uitgelegd

Beschadigde chunkgegevens in een regiobestand

Zo ziet de melding eruit:

Chunk [<x>, <z>] header is truncated: expected <Number> but read <Number>
Ignoring absolute chunk [<x>, <z>] in regionfile …
Failed to parse light data for chunk [<x>, <z>] …

Wat erachter zit: Minecraft slaat de wereld op in regiobestanden met de extensie .mca in de map region. Elk bestand bevat maximaal 32 × 32 chunks. Een deel van zo'n bestand is onvolledig of staat op de verkeerde plek. De server probeert het bestand te repareren of laadt de betreffende chunk opnieuw. Daarbij kan een stuk wereld opnieuw worden gegenereerd, inclusief alles wat daar gebouwd was. De oorzaak is meestal een harde stop tijdens het opslaan.

Zo los je het op:

  1. Noteer de chunkcoördinaten uit de melding. Maal 16 geven ze de blokcoördinaten, waar je in het spel kunt kijken.
  2. Is daar alles aanwezig, dan hoef je niets te doen.
  3. Ontbreekt een stuk wereld, stop dan de server en speel het betreffende regiobestand terug uit een back-up. De naam is r.<x>.<z>.mca, waarbij x en z de chunkcoördinaten gedeeld door 32 zijn, naar beneden afgerond. De regio springt daarmee terug naar de staat van de back-up.
  4. Stop de server voortaan gewoon met stop in plaats van hem hard af te sluiten.

Uitgebreid: Minecraft-chunks ontbreken: schade controleren en redden

Chunk staat op de verkeerde coördinaat

Zo ziet de melding eruit:

Chunk file at <x>,<z> is in the wrong location; relocating.

Wat erachter zit: In een regiobestand staat een chunk onder een andere coördinaat dan Minecraft op die plek verwacht. Minecraft verplaatst hem naar de juiste plek en laadt verder. De melding wijst echter op beschadigde of verkeerd gekopieerde wereldgegevens, bijvoorbeeld als regiobestanden zijn hernoemd of uit een andere wereld zijn gekopieerd.

Zo los je het op:

  1. Stop de server en maak onder Back-ups een back-up van de wereld.
  2. Heb je onlangs handmatig regiobestanden gekopieerd of hernoemd, maak dat dan ongedaan.
  3. Controleer de betreffende regio met een wereldreparatietool, altijd op een kopie en nooit op de enige versie van je wereld.
  4. Komt de melding herhaaldelijk terug, herstel dan onder Back-ups een bekend goede back-up.

Goed om te weten: Een enkele melding na een upload is een waarschuwing, maar nog geen verlies. Bekijk de plek in het spel voordat je iets terugzet.

Uitgebreid: Minecraft-chunks ontbreken: schade controleren en redden

Beschadigde bestandskop van een regiobestand wordt gerepareerd

Zo ziet de melding eruit:

Corrupt regionfile header detected! Attempting to re-calculate header offsets for regionfile <File>
Recalculating regionfile <File>, header gave erroneous offsets

Wat erachter zit: Elk regiobestand begint met een bestandskop. Die is een soort inhoudsopgave die bijhoudt waar in het bestand welke chunk staat. Paper heeft een beschadigde kop gevonden en bouwt hem opnieuw op. Meestal lukt dat zonder verlies en draait de server door. De oorzaak is vaak een harde onderbreking tijdens het schrijven, zoals een crash of een hard afgesloten server.

Zo los je het op:

  1. Meestal hoef je niets te doen.
  2. Wil je zeker zijn, bekijk dan het gebied in het spel. De bestandsnaam r.<x>.<z>.mca verraadt de ligging: x en z maal 512 geven de blokcoördinaten van een hoek van de regio.
  3. Ontbreken daar delen van de wereld, stop dan de server en speel het betreffende regiobestand terug uit een back-up.
  4. Stop de server voortaan gewoon met stop in de Console in plaats van hem hard af te sluiten.

Uitgebreid: Minecraft-chunks ontbreken: schade controleren en redden

Blokgegevens passen niet meer bij het blok in de wereld

Zo ziet de melding eruit:

Failed to create block entity <BlockType> for block BlockPos{x=<x>, y=<y>, z=<z>} at position Block{<Block>}

Wat erachter zit: Sommige blokken hebben extra gegevens, een zogeheten BlockEntity: kisten slaan hun inhoud op, borden hun tekst, ovens hun voortgang. Op de genoemde positie passen deze opgeslagen gegevens niet bij het blok dat daar staat. Dat kan ontstaan na updates, na een wereldbewerking, bijvoorbeeld met WorldEdit, of door inconsistente chunkgegevens. Laat je niet in de war brengen door de volgorde: achter for block staat de positie, achter at position het blok.

Zo los je het op:

  1. Maak onder Back-ups een back-up van de wereld.
  2. Werk Paper onder Versie bij naar de nieuwste build van je Minecraft-versie.
  3. Bekijk de genoemde positie in het spel, maar pas het blok niet blindelings aan.
  4. Herhaalt de melding zich, verwijder dan de ongeldige blokgegevens met een geschikte wereldtool of herstel de regio uit een back-up.

Kom je er niet uit, open dan een ticket en noem het tijdstip van de melding.

Fout bij gelijktijdige wijziging van blokgegevens

Zo ziet de melding eruit:

BlockEntity threw exception at <World>:<x>,<y>,<z>
java.util.ConcurrentModificationException

Wat erachter zit: Blokken met eigen gegevens, zoals trechters, ovens of kisten, heten BlockEntity. Tijdens een tick is een verzameling van dergelijke gegevens gewijzigd terwijl de server er net doorheen liep. Java breekt dat af met een ConcurrentModificationException, letterlijk een fout door gelijktijdige wijziging. De losse melding laat niet met zekerheid zien of het spel zelf, de wereldstatus of een plugin de wijziging heeft veroorzaakt.

Zo los je het op:

  1. Update Paper onder Versie en je plugins onder Plugins.
  2. Kijk of de melding terugkomt.
  3. Herhaalt ze zich, lees dan de volledige stacktrace in logs/latest.log en noteer de genoemde positie.
  4. Pas een daar genoemde pluginklasse, herkenbaar aan de pakketnaam of aan de bestandsnaam van een plugin, maakt de toewijzing mogelijk. Update dan precies die plugin of meld de fout bij de ontwikkelaar.

Goed om te weten: Zonder pluginnaam in de stacktrace moet je niet op verdenking plugins verwijderen.

Item met ongeldige eigenschap, bijvoorbeeld een onbekende betovering

Zo ziet de melding eruit:

[CraftMagicNumbers] Exception modifying ItemStack
… Not a valid resource location: …

Wat erachter zit: Een item uit een pluginconfiguratie, een kit of een menu heeft een eigenschap die deze Minecraft-versie niet kan lezen. Vaak is dat een betovering van een plugin die inmiddels is verwijderd. Een resource location is een naam in het formaat namespace:name, bijvoorbeeld minecraft:sharpness. Het item wordt geladen zonder de foutieve eigenschap. De server blijft draaien, maar het item werkt anders dan bedoeld.

Zo los je het op:

  1. Zoek uit welke plugin het item uitgeeft, bijvoorbeeld een kit-, menu- of shopplugin.
  2. Open onder Bestanden de configuratie ervan in de map plugins/<Plugin>/ en verwijder de genoemde eigenschap of corrigeer de naam ervan.
  3. Of maak het item opnieuw aan, bijvoorbeeld door het in het spel opnieuw te maken en in de plugin opnieuw op te slaan.
  4. Hoort de eigenschap bij een plugin voor eigen betoveringen die je hebt verwijderd, installeer die dan onder Plugins opnieuw.
  5. Start de server opnieuw op en controleer de Console.

Meer hierover: Pluginconfiguratie is foutief

Opgeslagen item bevat een onbekende eigenschap

Zo ziet de melding eruit:

Tried to load invalid item: 'No component with type: '<namespace>:<property>'

Wat erachter zit: Items slaan hun eigenschappen op als datacomponenten, bijvoorbeeld naam, betoveringen of duurzaamheid. Een opgeslagen item, bijvoorbeeld in spelergegevens, kisten of plugingegevens, bevat een component die deze Minecraft-versie niet kent. Typisch is dat de wereld of plugingegevens met een nieuwere versie zijn aangemaakt en daarna op een oudere zijn geladen. Het item kan dan niet correct worden geladen en kan verloren gaan.

Zo los je het op:

  1. Maak vóór verdere wijzigingen onder Back-ups een back-up.
  2. Stel onder Versie weer de Minecraft-versie in waarmee de wereld het laatst is gespeeld.
  3. Maakt een plugin zulke items aan, breng die dan onder Plugins naar een versie die bij je serverversie past.
  4. Start de server opnieuw op en controleer in de Console of de melding wegblijft.

Goed om te weten: Staat minecraft: voor de naam, dan komt de eigenschap uit een nieuwere Minecraft-versie. Een andere naam wijst op een plugin of een mod. Meer hierover: Plugin past niet bij de serverversie

Opgeslagen mod-item mist verplichte velden („No key … in MapLike")

Zo ziet de melding eruit:

Tried to load invalid item: 'No key <Field> in MapLike[<ItemData>]'

Wat erachter zit: Bij het inlezen van een opgeslagen item verwacht de software bepaalde verplichte velden. Minstens één daarvan ontbreekt in de itemgegevens. De melding noemt met „No key" het ontbrekende veld; „MapLike" verwijst naar de ingelezen verzameling gegevensvelden. Het betreffende item kan in dit formaat niet volledig worden geladen.

Zo los je het op:

  1. Maak onder Back-ups een back-up van de huidige stand voordat je mods of opgeslagen gegevens wijzigt.
  2. Lees de volledige melding in de Console of in logs/latest.log onder Bestanden. Zoek naar de itemidentificatie en de bijbehorende mod.
  3. Vergelijk onder Mods de geïnstalleerde combinatie met de stand van vóór het eerste optreden. Bekijk de aanwijzingen van de verantwoordelijke mod over het overnemen van oude itemgegevens.
  4. Test een passende modcombinatie of een herstelactie eerst op een kopie van de wereld. Geef de volledige melding aan de mod-auteur als er geen gedocumenteerde oplossing past.

Goed om te weten: Het ongericht verwijderen van inventarissen of spelergegevens verwijdert ook items die nog bruikbaar zijn.

Staat jouw melding er niet bij?

Lees de volledige melding in logs/latest.log inclusief de regels ervoor: vaak staat daar wat er eerst misging. In de stacktrace verraden pakketnamen, dus de door punten gescheiden mapnamen zoals com.<ontwikkelaar>.<Plugin>, en bestandsnamen zoals <Plugin>.jar welke plugin of welke mod erbij betrokken is. Werk alleen aan wereldbestanden als de server is gestopt en maak vooraf een back-up aan onder Back-ups. Kom je er niet uit, open dan een ticket en geef het tijdstip van de melding door.