Datapacks (datapakketten) breiden Minecraft uit met functies, recepten, voortgang of een nieuwe wereldgeneratie, resourcepacks leveren texturen en geluiden. Beide zijn gebonden aan een gegevensformaat dat met bijna elke Minecraft-versie verandert. Past een pack niet bij de versie van je server of is een bestand erin beschadigd, dan schrijft de server een melding naar het log. Meestal slaat hij alleen het betreffende item over, in één geval breekt hij het opstarten af.

Elke sectie hieronder behandelt een van deze meldingen. De volledige melding inclusief de regels eronder vind je in de Console of onder Bestanden in logs/latest.log. Het deel voor de dubbele punt in namen zoals <pack>:<item> heet namespace en verraadt bijna altijd uit welke pack of mod de fout komt. Maak vóór elke ingreep in de wereldmap of in packbestanden een back-up onder Back-ups.

„Failed to load datapacks“: Minecraft breekt het opstarten van de server af

Zo ziet de melding eruit:

Failed to load datapacks, can't proceed with server load. You can either fix your datapacks or reset to vanilla with --safeMode
java.util.concurrent.ExecutionException: java.lang.IllegalStateException: Overworld settings missing

Wat erachter zit: Minecraft breekt het opstarten af, omdat datapacks of de benodigde wereldgeneratiegegevens niet geladen konden worden. De server blijft uit. Meestal past een datapack niet bij de Minecraft-versie of bevat het een beschadigd bestand. Overworld settings missing betekent dat de instellingen voor de hoofdwereld ontbreken of niet gelezen konden worden.

Zo los je het op:

  1. Maak onder Back-ups een back-up aan.
  2. Lees in de Console de fouten vóór deze melding en eronder. Controleer de laatst toegevoegde, bijgewerkte of verwijderde datapacks en mods.
  3. Open onder Bestanden de map datapacks van je wereld. Download het laatst toegevoegde pack als kopie en verwijder het om te testen.
  4. Start opnieuw op. Draait de server weer, gebruik dan een versie van het pack die bij de Minecraft-versie past.
  5. Heeft de wereld het pack nodig voor biomen of dimensies, herstel dan een passende versie of de volledige eerdere staat uit een back-up.

Goed om te weten: Na een softwarewissel kunnen wereldbestanden anders zijn geordend. Bekijk de verhuisinstructies van de betreffende software; daarbij helpt Minecraft-versie en modloader veilig wijzigen.

„Failed to load function“: datapackfunctie kan niet worden geladen

Zo ziet de melding eruit:

Failed to load function <Pack>:<Pad>
java.lang.IllegalArgumentException: Whilst parsing command on line <Rule>: Incorrect argument for command at position <Positie>: …
java.lang.IllegalArgumentException: Whilst parsing command on line <Rule>: Can't find element '<Pack>:<Item>' in registry 'minecraft:item_modifier' …

Wat erachter zit: Datapacks sturen processen aan via functies: tekstbestanden met de extensie .mcfunction die commando's bevatten. Een commando is onbekend, verwacht andere argumenten of verwijst naar een ontbrekend gegevensitem, bijvoorbeeld een itemwijziging (item_modifier). Meestal past de pack niet bij de Minecraft-versie. De functie valt uit; de server blijft draaien, maar afhankelijke packfuncties werken niet.

Zo los je het op:

  1. Lees onder „Failed to load function“ de foutregel: line noemt de regel, position de plek daarin. „Can't find element“ noemt het ontbrekende item.
  2. Vervang de pack in de map datapacks van je wereld door de versie voor jouw Minecraft-versie. Controleer bij ontbrekende items ook de extra packs die de pack nodig heeft.
  3. Corrigeer bij eigen packs de genoemde regel in data/<Pack>/function/<Pad>.mcfunction; in oudere packs heet de map functions.
  4. Herstart of voer in de Console reload in. Op Paper en Spigot gebruik je minecraft:reload, zodat alleen datapacks opnieuw worden geladen.

Goed om te weten: Optionele modfuncties hebben de bijbehorende mod nodig. Negeer zulke fouten alleen als de auteur van de pack deze extra functies uitdrukkelijk als optioneel beschrijft.

„Couldn't load … pack metadata“: packmetadata past niet bij de Minecraft-versie

Zo ziet de melding eruit:

Couldn't load file/<Pack>.zip pack metadata: Pack declares support for version newer than <Getal>, but is missing mandatory fields min_format and max_format
Couldn't load file/<Pack>.zip pack metadata: Multi-version packs cannot support minimum version of less than <Getal>, since this will leave versions in range unable to load pack.

Wat erachter zit: Het bestand pack.mcmeta beschrijft het formaat en het ondersteunde versiebereik van een datapack of resourcepack. Ontbreken verplichte velden of is het opgegeven bereik ongeldig, dan laadt de server de pack niet. De server blijft zonder deze pack draaien. Ook een te ver teruggaand versiebereik kan de melding veroorzaken.

Zo los je het op:

  1. De bestandsnaam achter file/ noemt de pack. Controleer onder Versie je Minecraft-versie.
  2. Download de passende packversie en vervang het betreffende bestand onder Bestanden. Datapacks staan in de map datapacks van je wereld; resourcepacks vervang je op hun huidige locatie. Herstart daarna.
  3. Stem bij eigen packs de metadata af op de eisen van je doelversie: oudere formaten gebruiken pack_format, nieuwere min_format en max_format. Voor packs die meerdere versies ondersteunen kunnen ook de oudere velden nodig zijn.
  4. Controleer of het opgegeven versiebereik geldig is en of de melding na de herstart verdwenen is.

Goed om te weten: Gewijzigde formaatgegevens passen commando's of andere packinhoud niet automatisch aan.

„Couldn't load tag“: datapack verwijst naar ontbrekende items

Zo ziet de melding eruit:

Couldn't load tag minecraft:load as it is missing following references: <Pack>:<Functie> (from file/<Pack>.zip)
Couldn't load tag <Naamruimte>:<Tag> as it is missing following references: <Mod>:<Item> (from <Mod>.jar)
Couldn't load tag <Naamruimte>:<Tag> as it is missing following references: #<Mod>:<Tag> (from mod/<Mod>)

Wat erachter zit: Een tag is een benoemde lijst. minecraft:load en minecraft:tick bevatten functies; andere tags groeperen bijvoorbeeld blokken of items. Een benodigd item kon niet worden geladen, doordat een functie fouten bevat of een pack of mod ontbreekt. Ook een andere tag kan ontbreken: dat herken je aan de #. De betreffende tag is dan niet beschikbaar; bij functietags vallen de bijbehorende processen uit.

Zo los je het op:

  1. Los eerst de meldingen „Failed to load function“ van dezelfde pack op.
  2. Controleer de herkomst tussen haakjes. Hoort het ontbrekende item bij een andere pack of mod, installeer dan de passende versie daarvan.
  3. Ontbreken items met minecraft: ervoor, controleer dan ook of de pack bij jouw Minecraft-versie past.
  4. Herstart na wijzigingen aan mods. Datapacks kun je in de Console met reload opnieuw laden; op Paper en Spigot gebruik je minecraft:reload.

Goed om te weten: .jar of mod/ als herkomst wijst op een mod: Modfouten op Forge-, NeoForge- en Fabric-servers.

„Couldn’t parse data file …“: datapackbestand heeft een onjuist formaat

Zo ziet de melding eruit:

Couldn't parse data file '<Pack>:<Entry>' from '<Pack>:recipe/<File>.json': DataResult.Error['Unknown registry key …']
Couldn't parse data file '<Pack>:<Entry>' from '<Pack>:recipe/<File>.json': DataResult.Error['List is too short: 0, expected range [1-9]']
Couldn't parse data file '<Pack>:<Entry>' from '<Pack>:recipe/<File>.json': DataResult.Error['Not a string: {"item":"minecraft:tnt"}; List must have contents']

Wat erachter zit: Datapacks beschrijven onder andere recepten en voortgang in JSON, een tekstformaat voor gestructureerde gegevens. Ook mods leveren zulke bestanden mee. Het bestand is geldig JSON, maar bevat velden die niet kloppen, lege lijsten of verwijzingen naar onbekende items, bijvoorbeeld een recept-serializer die het receptformaat verwerkt. Minecraft slaat het betreffende item over; het recept ontbreekt, maar de server blijft draaien.

Zo los je het op:

  1. Lees achter from om welk bestand het gaat; DataResult.Error[…] noemt de fout.
  2. Komt het uit een datapack, vervang dit dan onder Bestanden in de map datapacks van je wereld door de versie voor jouw Minecraft-versie.
  3. Komt het uit een mod, controleer dan de versie en de benodigde afhankelijkheden; werk bij een Modpack het hele pakket bij.
  4. Pas bij eigen packs het bestand aan het formaat van jouw Minecraft-versie aan. De Minecraft-wiki beschrijft de bestandsformaten.
  5. Start de server opnieuw op en controleer de melding.

Goed om te weten: Not a string betekent hier: op deze plek wordt tekst verwacht in plaats van een object.

„Couldn't parse data file“: gegevens uit pack of mod zijn onleesbaar

Zo ziet de melding eruit:

Couldn't read tag list <Naamruimte>:<Tag> from <Bestand> in data pack mod/<Mod>
Couldn't parse data file '<Naamruimte>:<Item>' from '<Bestand>.json': … Failed to parse either …
java.lang.IllegalStateException: Failed to parse <Naamruimte>:<Item> from pack file/<Pack>.zip

Wat erachter zit: Minecraft kan een gegevensitem niet inlezen. „Failed to parse either“ betekent dat de inhoud bij geen van de verwachte notaties past; First en Second noemen de betreffende fouten. Meestal past een mod of datapack niet bij de Minecraft-versie of is de pack beschadigd. Ook recepten, buittabellen en vorderingen kunnen getroffen zijn. Het item valt uit; bij taglijsten kan een hele groep leeg blijven. Daardoor kunnen recepten of wereldgeneratie verstoord raken.

Zo los je het op:

  1. Zoek in de volledige fout naar de bron: mod/<Mod> of een .jar wijst op een mod, file/<Pack>.zip op een datapack. De naamruimte is een extra aanwijzing.
  2. Controleer onder Mods of in de map datapacks van je wereld of de versies bij jouw Minecraft-versie passen. Unknown registry key noemt een ontbrekend gegevensitem; controleer de benodigde extra packs.
  3. Maak een back-up van de huidige staat, stop de server en werk de laatst toegevoegde mod of pack bij.
  4. Begon de fout na een nieuwe datapack, haal die dan als test weg en herstart.

Goed om te weten: Voor modfouten helpt Modfouten op Forge-, NeoForge- en Fabric-servers.

„Couldn’t load advancements“: voortgang ontbreekt of is ongeldig

Zo ziet de melding eruit:

Couldn't load advancements: [<pack>:<progress>, <pack>:<progress>]

Wat erachter zit: Advancements zijn de voortgangen die spelers in het spel vrijspelen. Minecraft kon de genoemde items bij het laden van de datapacks niet herleiden, bijvoorbeeld omdat ze verwijzen naar iets dat in deze versie niet bestaat. Veel datapacks en mods gebruiken advancements ook onzichtbaar als trigger, bijvoorbeeld om te herkennen dat een speler een structuur heeft gevonden. Zulke functies vallen dan uit, terwijl de server blijft draaien.

Zo los je het op:

  1. De naamruimte voor de dubbele punt helpt om het verantwoordelijke datapack of de mod te vinden. Controleer hiervoor de geïnstalleerde inhoud en de regels vóór de melding.
  2. Werk dit pack of deze mod bij naar de versie voor jouw Minecraft-versie. Heb je het niet nodig, verwijder het dan na een back-up onder Back-ups.
  3. Start de server na wijzigingen aan mods opnieuw op. Bij wijzigingen aan alleen datapacks werkt ook reload in de Console, op Paper en Spigot minecraft:reload.
  4. Staat de melding daarna nog steeds, lees dan de regels ervoor in logs/latest.log. Daar noemt de server vaak welk deel van een item niet klopt.

Goed om te weten: Ook als de naamruimte minecraft is, kan een datapack de afzender zijn. Packs mogen eigen items onder deze naam aanmaken.

Datapack-predicate heeft het verkeerde formaat

Zo ziet de melding eruit:

Couldn't parse element predicates:<pack>:<name> - Not a json array: {"condition":"minecraft:any_of","terms":[…]}

Wat erachter zit: Een predicate is een opgeslagen voorwaarde die een datapack controleert, bijvoorbeeld of een speler een bepaalde score heeft. Commando's en loottables maken er gebruik van. Jouw Minecraft-versie verwacht op deze plek een lijst tussen rechte haken [ … ], maar het pack levert één enkel object tussen accolades { … }. Minecraft laadt de predicate daarom niet. Alles in het pack wat hiervan afhangt, werkt verkeerd of helemaal niet. De server zelf blijft draaien.

Zo los je het op:

  1. De naam achter predicates: toont het pack en de predicate.
  2. Download de versie van het datapack voor jouw Minecraft-versie en vervang de oude in de map datapacks van je wereld.
  3. Bij eigen packs open je data/<pack>/predicate/<name>.json (in oudere packs heet de map predicates) en breng je het bestand naar het actuele formaat, zoals de Minecraft-wiki beschrijft.
  4. Start opnieuw op of laad de datapacks opnieuw.

Meldingstekst voor het server-resourcepack is verkeerd opgemaakt

Zo ziet de melding eruit:

Failed to parse resource pack prompt '<Hint>'
com.google.gson.JsonSyntaxException: com.google.gson.stream.MalformedJsonException: Use JsonReader.setStrictness(Strictness.LENIENT) to accept malformed JSON at line 1 column 1 path $

Wat erachter zit: Met resource-pack-prompt in server.properties bepaal je de tekst die spelers zien wanneer de server hun een resourcepack aanbiedt. Minecraft verwacht daar een tekstcomponent in JSON-formaat, geen gewone zin. Kan de server de waarde niet lezen, dan laat hij de melding weg. De server draait normaal verder, alleen je eigen meldingstekst verschijnt niet.

Zo los je het op:

  1. Open onder Bestanden het bestand server.properties in de hoofdmap van de server.
  2. Schrijf de waarde als JSON-tekst, bijvoorbeeld resource-pack-prompt={"text":"<Hint>"}.
  3. Heb je geen eigen melding nodig, laat de waarde achter het gelijkheidsteken dan leeg.
  4. Sla het bestand op en start de server opnieuw op.

Goed om te weten: De overige waarden van het bestand worden uitgelegd in Minecraft server.properties configureren.

Het bestand pack.mcmeta van een pack is foutief

Zo ziet de melding eruit:

Couldn't load file/<Pack>.zip pack metadata: com.google.gson.stream.MalformedJsonException: <Details>

Wat erachter zit: pack.mcmeta is het identiteitsbestand van elk pack en staat in de bovenste map ervan. Hier is het geen geldige JSON: er ontbreekt bijvoorbeeld een komma, een aanhalingsteken of een haakje. Minecraft kan het pack daarom niet plaatsen en laadt het niet. De server draait zonder het pack verder.

Zo los je het op:

  1. Het eenvoudigst download je het pack opnieuw van de officiële pagina en vervang je het bestand in de map datapacks van je wereld.
  2. Bij eigen packs open je pack.mcmeta. Staat het pack als ZIP-archief, download het dan, corrigeer het bestand op je computer en upload het archief opnieuw.
  3. Controleer de inhoud met een JSON-validator, dus een website of editor die syntaxfouten markeert, en corrigeer de gemarkeerde plek. De melding noemt vaak regel en kolom.
  4. Start de server opnieuw op.

Goed om te weten: Typische fouten zijn een komma na het laatste item, typografische in plaats van rechte aanhalingstekens en een ontbrekend sluithaakje.

Recept noemt een item dat niet bestaat

Zo ziet de melding eruit:

Expected item to be an item, was unknown string '<mod>:<item>'

Wat erachter zit: Een recept noemt een item dat op de server niet bestaat. Bijna altijd ontbreekt de mod die dit item meebrengt, of staat hij in een versie waarin het item anders heet. Alleen het betreffende recept wordt overgeslagen. De server start normaal, maar dit ene recept kan in het spel niet worden gemaakt.

Zo los je het op:

  1. Lees de naam tussen aanhalingstekens. Vóór de dubbele punt staat de verantwoordelijke mod: bij horsepower:flour is dat de mod „horsepower".
  2. Controleer onder Mods of deze mod is geïnstalleerd.
  3. Is hij geïnstalleerd, vergelijk dan zijn versie met die welke je modpack voorschrijft en pas die aan.
  4. Start de server opnieuw op en controleer of de melding wegblijft.

Goed om te weten: Ontbreekt de mod met opzet, bijvoorbeeld omdat je hem uit het modpack hebt verwijderd, dan kun je de melding negeren. Dan ontbreekt alleen dit recept. Hoe mods en modpack bij elkaar passen, laat Minecraft-mods en modpacks goed inrichten zien.

Recept gebruikt een onbekend verwerkingstype

Zo ziet de melding eruit:

com.google.gson.JsonSyntaxException: Unknown recipe '<mod>:<recipe-type>'

Wat erachter zit: Veel mods brengen eigen receptsoorten mee, bijvoorbeeld voor een molen of pers. Hier gebruikt een recept zo'n verwerkingstype dat de server niet kent. De mod die het definieert ontbreekt of is te oud. Het recept wordt overgeslagen, de server blijft draaien.

Zo los je het op:

  1. De naam vóór de dubbele punt noemt de verantwoordelijke mod.
  2. Installeer hem onder Mods of breng hem naar een versie die bij je modpack past.
  3. Komt het recept uit een datapack dat je zelf hebt toegevoegd, verwijder het recept dan daar of haal het hele pack uit de map datapacks van je wereld.
  4. Start de server opnieuw op.

Goed om te weten: Ontbreekt een mod helemaal, dan verschijnt de melding vaak talloze keren achter elkaar met dezelfde naam vóór de dubbele punt. Dan volstaat het om die ene mod te installeren. Ontbreekt hij met opzet, dan ontbreken alleen de recepten die zijn verwerkingstype gebruiken.

Leeg JSON-bestand in mod- of datapack-gegevens

Zo ziet de melding eruit:

com.google.gson.JsonParseException: java.io.EOFException: End of input at line 1 column 1 path $

Wat erachter zit: Bij het laden van de spelgegevens, dus recepten, loottabellen, tags en dergelijke, heeft Minecraft een leeg JSON-bestand gevonden. „End of input at line 1 column 1" betekent: het bestand eindigt voordat het eerste teken komt. Vaak komt het uit een mod, een datapack of een onvolledige of beschadigde upload. De betreffende vermelding wordt overgeslagen, de server blijft gewoon draaien.

Zo los je het op:

  1. Lees in de Console of in logs/latest.log de regels direct ervoor en erna. Daar staat meestal welk bestand of welke mod het betreft.
  2. Staat het bestand in een eigen datapack, vervang het dan door een volledige versie of verwijder het.
  3. Hoort het bij een mod of gedownload datapack, download het dan opnieuw en upload het nogmaals. Let erop dat de upload volledig doorloopt.
  4. Start de server opnieuw op.

Goed om te weten: Bij veel of grote bestanden is een SFTP-programma vaak handiger dan de upload in de browser: Serverbestanden in het paneel bewerken en via SFTP verbinden.

Resourcepack-archief heeft een ongeldige opbouw

Zo ziet de melding eruit:

<Pack> does not contain a valid pack_manifest.json or manifest.json
The resource pack <Pack> is invalid and failed to load

Wat erachter zit: Het resourcepack kon niet worden geladen. Meestal gaat het om Bedrock-packs: die hebben een bestand manifest.json of pack_manifest.json nodig dat het pack beschrijft. De meest voorkomende oorzaak is een extra maplaag, waarbij in het archief eerst een map staat en het bestand pas daarin. Ook een beschadigd archief of een niet passend packformaat leidt tot deze melding. Het pack ontbreekt dan, de server blijft draaien.

Zo los je het op:

  1. Lees de detailmelding in de regels rond deze melding; daarin staat de precieze reden.
  2. Open het archief op je computer. manifest.json of pack_manifest.json moet direct op het hoogste niveau staan, niet in een submap.
  3. Staat het bestand in een submap, pak dan de inhoud van die map opnieuw in als ZIP-archief en upload het opnieuw.
  4. Is het archief beschadigd, download het pack dan opnieuw. Een Java-resourcepack met pack.mcmeta in plaats van een manifest past hier niet; het moet opnieuw in het Bedrock-formaat worden gemaakt.
  5. Start de server opnieuw op.

Goed om te weten: Meer Bedrock-meldingen worden uitgelegd in Bedrock-server en Geyser: meldingen in het log.

Jigsaw-blok noemt een onbekend vervangend blok

Zo ziet de melding eruit:

Failed to parse jigsaw replacement state '<Block>' at BlockPos{x=<x>, y=<y>, z=<z>}

Wat erachter zit: Jigsaw-blokken zijn technische blokken waarmee structuren uit losse delen worden samengesteld. Elk jigsaw-blok bepaalt door welk blok het na het samenvoegen wordt vervangen. Hier is dat vervangende blok onbekend, meestal door een typfout zoals minecrat: in plaats van minecraft:. Bij het genereren blijft het blok op die plek leeg. De server blijft draaien, de structuur heeft alleen een gat.

Zo los je het op:

  1. Noteer de positie uit BlockPos{…}: x, y en z.
  2. Ga met OP-rechten in de creatieve modus daarheen, bijvoorbeeld met /tp <x> <y> <z>.
  3. Open het jigsaw-blok met een rechtsklik en corrigeer de naam in het veld voor het vervangende blok (in de Engelse client „Turns into").
  4. Komt de structuur uit een datapack of mod, dan zit de fout in het structuurbestand daarvan. Dan helpt een gecorrigeerde versie van het pack of de mod; meld de fout bij de auteur.

Goed om te weten: De melding is onschadelijk voor de werking. Ze betreft alleen het uiterlijk van de structuur op die ene plek. Hoe je OP-rechten geeft, staat in OP-rechten en commando's op de Minecraft-server.

Staat jouw melding er niet bij?

Lees de hele melding in de Console of in logs/latest.log, ook de regels er direct voor; vaak staat daar welke pack er net werd geladen. De namespace voor de dubbele punt en gegevens zoals file/<Pack>.zip of mod/<mod> wijzen de afzender aan. Volgt er een stacktrace, dus ingesprongen regels met at …, dan verraden de map- en pakketnamen daarin de betrokken mod of de plugin. Maak vóór wijzigingen aan wereld- of packbestanden een back-up onder Back-ups. Kom je er niet uit, open dan een ticket en vermeld het tijdstip van de melding.