Forge, NeoForge en Fabric zijn modloaders: ze laden bij het opstarten alle mods uit de map mods/ en controleren of ze bij elkaar en bij de Minecraft-versie passen. Gaat daarbij iets mis, dan komt er een melding in het serverlog. Elk onderstaand onderdeel behandelt precies één van deze meldingen. Eerst komen fouten die het opstarten verhinderen, daarna waarschuwingen waarbij de server gewoon blijft draaien.

De volledige melding vind je in de Console of onder Bestanden in logs/latest.log, crashrapporten staan in de map crash-reports/. Onder veel meldingen staat een stacktrace: een lijst met programmaplekken die laat zien waar de fout is ontstaan. Pakket- en mapnamen daarin verraden vaak de betrokken mod. Maak vóór elke ingreep in wereld- of configuratiebestanden onder Back-ups een back-up aan.

Incompatibele mods verhinderen het opstarten („Incompatible mods found“)

Zo ziet de melding eruit:

Incompatible mods found!
net.fabricmc.loader.impl.FormattedException: Some of your mods are incompatible with the game or each other!
     - Install <Mod>, version <Version> or later.

Wat er speelt: De mod-loader controleert vóór het opstarten alle mods en heeft ontbrekende of niet passende afhankelijkheden gevonden. Een afhankelijkheid is een andere mod die een mod nodig heeft om te werken, vaak een bibliotheek. De server start daardoor niet op. Direct onder de melding staat wat er ontbreekt of problemen geeft.

Zo los je het op:

  1. Lees in de Console of in logs/latest.log de regels onder A potential solution has been determined.
  2. Install <Mod>, version <Version> or later betekent: deze mod ontbreekt of is te oud. Installeer hem onder Mods in minstens deze versie, passend bij de Minecraft-versie en de loader.
  3. Replace 'Minecraft' (minecraft) <Version> with any <Version> version betekent: een mod is gebouwd voor een andere Minecraft-versie. Haal de uitvoering voor jouw versie op of verwijder de mod. De serverversie onder Versie wijzig je alleen als alle mods daarbij passen, en alleen na een back-up.
  4. Staat er in een regel 'OpenJDK 64-Bit Server VM' (java), dan vraagt een mod om een andere Java-versie. Meestal helpt ook hier de uitvoering van de mod voor jouw Minecraft-versie.

Goed om te weten: Werk de hele lijst af en start pas daarna opnieuw op, dat scheelt opstartpogingen. Uitgebreid: Minecraft-mods en modpacks goed instellen.

NeoForge breekt het opstarten af („Couldn't find Minecraft server thread“)

Zo ziet de melding eruit:

net.neoforged.fml.startup.FatalStartupException: Couldn't find Minecraft server thread. Startup likely failed.
    at net.neoforged.fml.startup.Server.main(Server.java:23)

Wat er speelt: Deze melding is een gevolg, niet de oorzaak. Een eerdere fout van een mod of van de loader heeft het opstarten beëindigd voordat NeoForge de eigenlijke Minecraft-server kon aanmaken. De server start daarom niet op. De regel zelf noemt geen mod, het spoor ligt hoger in het log.

Zo los je het op:

  1. Open onder Bestanden het bestand logs/latest.log. Is er een crashrapport, bekijk dan ook het nieuwste bestand in crash-reports/.
  2. Ga vanaf deze melding omhoog tot de eerste regel met Exception, ERROR of Caused by. De eerste is doorslaggevend, latere fouten zijn meestal gevolgen daarvan.
  3. Zoek daar de naam van de mod. Die staat in de melding zelf, als bestandsnaam met .jar of als pakketnaam in de stacktrace eronder.
  4. Werk deze mod bij of verwijder hem onder Mods. Vraagt hij om een andere NeoForge-versie, stel dan onder Versie een passende in.
  5. Start de server opnieuw op en controleer of de melding verdwenen is.

Goed om te weten: Zie je hoger een melding uit een ander onderdeel van dit artikel, los dan eerst die op. De regel hier verdwijnt dan vanzelf.

Fabric-mod crasht bij het opstarten („Could not execute entrypoint stage“)

Zo ziet de melding eruit:

Failed to start the minecraft server
java.lang.RuntimeException: Could not execute entrypoint stage 'main' due to errors, provided by '<mod-id>' at '<Class>'!

Wat er speelt: Een entrypoint is het punt waarop Fabric het programma van een mod start. De mod achter provided by is al in deze vroege fase gecrasht, daarom komt de server niet volledig op. De precieze reden staat in de regels met Caused by: eronder, vaak een ontbrekende afhankelijkheid of een niet passende versie.

Zo los je het op:

  1. Lees in de Console of in logs/latest.log de naam achter provided by, bijvoorbeeld geyser-fabric.
  2. Bekijk de Caused by:-regels eronder. Ze laten zien of er iets ontbreekt of niet bij elkaar past.
  3. Werk de mod en zijn afhankelijkheden bij onder Mods, passend bij jouw Minecraft- en Fabric-versie. Veel Fabric-mods hebben daarnaast de Fabric API nodig.
  4. Kwam de fout direct na een installatie, verwijder dan de mod om te testen en start opnieuw op. Start de server dan wel, dan ligt het aan deze mod.

Goed om te weten: Hoe Fabric Loader, Fabric API en mods bij elkaar passen, leggen we uit in Fabric Loader en Fabric API: versiefouten gericht oplossen.

Fabric-mod heeft een ongeldige mixin-configuratie

Zo ziet de melding eruit:

Error parsing or using Mixin config <mod-id>.mixins.json for mod <mod-id>

Wat er speelt: Mixin is een techniek waarmee mods bij het opstarten gericht plekken in het Minecraft-programma aanpassen. Welke plekken dat zijn, staat in een mixin-configuratie binnen het modbestand. Fabric kan deze configuratie van de genoemde mod niet lezen of toepassen, en het opstarten van de server wordt afgebroken. Meestal past het modbestand niet precies bij jouw Minecraft- of Fabric Loader-versie.

Zo los je het op:

  1. Lees in de Console of in logs/latest.log de modnaam achter for mod.
  2. Kijk onder Versie welke Minecraft-versie jouw server gebruikt.
  3. Vervang de mod onder Mods door de uitvoering die voor precies deze Minecraft-versie en voor Fabric wordt aangeboden. Zorg dat het oude bestand uit mods/ verdwijnt.
  4. Start de server opnieuw op.

Goed om te weten: Ook kleine versiesprongen tellen: een mod voor een andere subversie van Minecraft kan precies deze fout veroorzaken, ook al is de hoofdversie gelijk.

Forge breekt het laden van de mods af (LoaderException)

Zo ziet de melding eruit:

net.minecraftforge.fml.common.LoaderException: <Reason>

Wat er speelt: Forge kon een mod niet laden en heeft het opstarten afgebroken. Typische oorzaken zijn een mod die niet bij de Minecraft- of Forge-versie past, een ontbrekende afhankelijkheid of een ongeldige waarde in een modconfiguratie. In deze toestand start de server niet op. Deze vorm van de melding komt vooral voor bij oudere Forge-versies, zoals veel klassieke modpacks die gebruiken.

Zo los je het op:

  1. Lees in de Console of in logs/latest.log de regels direct onder de melding. Daar staan meestal de modnaam en de concrete reden.
  2. Heb je net een mod toegevoegd, verwijder die dan onder Mods of vervang hem door de versie voor jouw Minecraft- en Forge-versie.
  3. Kwam de fout direct na een wijziging in een bestand in de map config/, maak die wijziging dan ongedaan.
  4. Start de server opnieuw op.

Goed om te weten: Noemen de regels een ontbrekende mod, dan helpt ook Plugin of mod heeft een ontbrekende uitbreiding nodig.

Server start niet op: fout bij het laden van de mods

Zo ziet de melding eruit:

Failed to start the minecraft server
Missing or unsupported mandatory dependencies:
    Mod ID: '<mod-id>', Requested by: '<Mod>', Expected range: '[<Version>,)', Actual version: '[MISSING]'

Wat er speelt: De server breekt het opstarten af omdat een mod ontbreekt, in de verkeerde versie aanwezig is of bij het laden crasht. Zolang de fout bestaat, is de server niet bereikbaar. De regels onder de melding noemen de mod en de gevraagde versie.

Zo los je het op:

  1. Lees in de Console of in logs/latest.log de regels onder de melding. Mod ID is de benodigde mod, Requested by de mod die erom vraagt, Expected range de vereiste versie.
  2. Actual version: '[MISSING]' betekent: niet geïnstalleerd. Staat er een versienummer, dan is de aanwezige uitvoering te oud of te nieuw.
  3. Installeer de afhankelijkheid onder Mods in de gevraagde versie of verwijder de mod die erom vraagt.
  4. Heeft de regel betrekking op forge, neoforge of minecraft, dan past de loader- of spelversie niet. Stel die passend in onder Versie of Software / loader wijzigen.
  5. Start de server opnieuw op.

Goed om te weten: [<Version>,) betekent „deze versie of nieuwer“. Staat er alleen Exception in thread "main" java.lang.reflect.InvocationTargetException, zoek dan eronder naar Caused by:. Meer hierover: Serversoftware en versie wijzigen in het paneel.

Forge: mod- of configuratiebestand (.toml) is onleesbaar

Zo ziet de melding eruit:

com.electronwill.nightconfig.core.io.ParsingException: Failed to parse data from Reader

Wat hierachter zit: TOML is een eenvoudig tekstformaat voor instellingen (name = wert). Forge leest bij het starten de beschrijving van elke mod (mods.toml in het modbestand) en alle .toml-configuratiebestanden in de tekencodering UTF-8. Is een bestand anders gecodeerd, bijvoorbeeld met umlauts of Chinese tekens uit een Windows-editor, of is het bij het uploaden beschadigd, dan stopt Forge voordat de wereld laadt. De server gaat dan een paar seconden na het starten weer uit. Vaak is de laatst toegevoegde mod de oorzaak, vooral eentje die alleen bedoeld is voor de game-client.

Zo los je het op:

  1. Maak onder Back-ups een back-up aan.
  2. Verwijder onder Mods de laatst toegevoegde mod en start opnieuw op. Start de server, dan was dat de oorzaak. Installeer dan een serverversie van deze mod of een andere versie.
  3. Start hij nog steeds niet, open dan onder Bestanden het laatst bewerkte .toml-bestand in de map config/. Sla het opnieuw op zonder speciale tekens (UTF-8) of verwijder het. Forge maakt het bij de volgende start opnieuw aan met standaardwaarden, je wijzigingen daarin zijn dan weg.
  4. Kom je er niet uit, open dan een ticket en vermeld het tijdstip van de melding en de naam van de laatst geïnstalleerde mod.

Goed om te weten: Hoe je bestanden in het paneel opent en opslaat, lees je in Serverbestanden in het paneel bewerken en via SFTP verbinden.

Recept kon niet worden geladen ("Parsing error loading recipe")

Zo ziet de melding eruit:

Parsing error loading recipe <mod>:<rezept>: com.google.gson.JsonSyntaxException: Unknown item '<other-mod>:<item>'

Wat hierachter zit: Een recept verwijst naar een voorwerp of receptsoort die in de huidige modpack niet bestaat. Dat gebeurt vaak na een modupdate of als een uitbreiding ontbreekt die het recept vereist. De server start gewoon verder, alleen dit ene recept ontbreekt in het spel. In grote modpacks komen zulke regels vaak voor, omdat veel mods recepten voor partnermods meebrengen die helemaal niet geïnstalleerd zijn.

Zo los je het op:

  1. Lees de regel van links naar rechts: achter loading recipe staat vóór de dubbele punt de mod die het recept meebrengt. Achter Unknown item staat het ontbrekende voorwerp, het deel vóór de dubbele punt is de mod waartoe het behoort.
  2. Heb je het voorwerp of het recept in het spel nodig, controleer dan onder Mods of de bijbehorende mod ontbreekt of verouderd is.
  3. Installeer of update de mod passend bij je Minecraft- en loaderversie en start opnieuw op.
  4. Heb je het recept niet nodig, dan kun je de melding negeren.

Goed om te weten: Is de reden No key id in …, dan is het recept geschreven voor een ouder receptformaat. Meestal helpt een versie van de mod voor jouw Minecraft-versie.

Cobblemon: spelergegevens beschadigd

Zo ziet de melding eruit:

.old File cobblemonplayerdata for [<UUID>] is corrupt or missing. Data is lost
.old File pokedex for [<UUID>] is corrupt or missing. Data is lost

Wat hierachter zit: Cobblemon slaat voor elke speler eigen bestanden op, bijvoorbeeld voor Pokédex, team en spawngegevens. Eén daarvan is beschadigd, meestal na een crash tijdens het opslaan, en ook de reservekopie met de extensie .old is onbruikbaar of ontbreekt. De Cobblemon-gegevens van deze speler zijn verloren, Cobblemon maakt ze opnieuw aan. De server zelf blijft draaien.

Zo los je het op:

  1. Zoek uit wie het treft: Het bestand usercache.json in de hoofdmap koppelt de UUID uit de melding aan een spelersnaam.
  2. Zijn de gegevens belangrijk, stop dan de server en herstel onder Back-ups een back-up van vóór het incident. De gegevens staan in world/pokemon resp. world/cobblemonplayerdata (world is de standaardnaam van de wereldmap).
  3. Houd er rekening mee: Een volledige back-up zet de complete wereld terug naar die staat, ook alles wat andere spelers sindsdien hebben gebouwd.
  4. Maak voortaan regelmatig back-ups, vooral vóór updates.

Goed om te weten: Komen zulke meldingen vaker voor, dan crasht de server waarschijnlijk vaker. Zoek dan onder Servergezondheid en in crash-reports/ naar de oorzaak. Handleiding: Een serverback-up maken en terugzetten.

Gegevensbestand van een mod bevat foutieve JSON

Zo ziet de melding eruit:

Couldn't parse data file <mod>:<name> from <mod>:recipes/<name>.json
com.google.gson.JsonParseException: com.google.gson.stream.MalformedJsonException: Unterminated object at line 9 column 40

Wat hierachter zit: JSON is een tekstformaat voor gegevens met accolades, aanhalingstekens en komma's. Een mod of datapack levert een recept-, gegevens- of configuratiebestand waarin een teken ontbreekt of te veel is. Minecraft slaat deze inhoud over, de rest van de server blijft draaien.

Zo los je het op:

  1. Lees de eerste regel: Het deel vóór de dubbele punt achter from noemt de mod of het datapack, daarachter volgt het pad van het bestand.
  2. Komt het bestand uit een mod, update die mod dan onder Mods.
  3. Heb je het bestand zelf bewerkt, bijvoorbeeld in een eigen datapack onder world/datapacks/, open het dan onder Bestanden. line en column geven regel en kolom van de fout aan.
  4. Typisch zijn een ontbrekende komma of een niet gesloten haakje. Vind je de fout niet, zet dan het originele bestand opnieuw terug.
  5. Start de server opnieuw op.

Goed om te weten: Unterminated object betekent dat op deze plek een komma of een sluitende accolade werd verwacht. Meer over datapacks: Datapack- en resourcepackfouten.

Forge-mod bevat een foutief taalbestand

Zo ziet de melding eruit:

Skipped language file: <mod-id>:lang/en_us.json
com.google.gson.JsonSyntaxException: com.google.gson.stream.MalformedJsonException: Use JsonReader.setLenient(true) to accept malformed JSON at line 4 column 3 path $

Wat hierachter zit: Taalbestanden bevatten de teksten van een mod, bijvoorbeeld namen van voorwerpen. Forge kon een van deze JSON-bestanden in het modbestand (.jar) niet lezen en heeft het overgeslagen. In de stacktrace eronder verschijnt daarbij LanguageHook, het deel van Forge dat taalbestanden laadt. De server blijft draaien, alleen de teksten uit dit bestand ontbreken op de server.

Zo los je het op:

  1. Lees de mod-ID vóór de dubbele punt achter Skipped language file:. Ontbreekt deze regel, neem dan de eerste mod die in de omgeving van de melding wordt genoemd.
  2. Update deze mod onder Mods of vervang hem door een build voor dezelfde Minecraft- en Forge-versie. Een build is een kant-en-klaar gemaakte versie van de mod.
  3. Start de server opnieuw op en controleer of de regel verdwenen is.

Goed om te weten: De tip Use JsonReader.setLenient(true) is gericht aan modontwikkelaars, je kunt hiermee niets instellen. Het bestand zit in het modbestand, het zelf repareren loont de moeite niet.

Mixin van een mod mislukt ("Mixin apply for mod … failed")

Zo ziet de melding eruit:

Mixin apply for mod <mod-id> failed <mod-id>.mixins.json:<Class> from mod <mod-id> -> <Target-Class>:
org.spongepowered.asm.mixin.injection.throwables.InvalidInjectionException Critical injection failure: @Inject annotation on <Method> could not find any targets

Wat hierachter zit: Via mixins wijzigen mods bij het starten bepaalde plekken in het Minecraft-programma. De genoemde mod zoekt zo'n plek, maar vindt die niet. Meestal past de mod niet bij de Minecraft-versie, of een andere mod heeft de plek al gewijzigd. De betreffende functie van de mod werkt dan mogelijk niet goed.

Zo los je het op:

  1. Lees de naam achter from mod. Dat is de mod waarvan de wijziging mislukt.
  2. Controleer op de pagina van de mod of er een versie is voor jouw modpack- resp. Minecraft-versie, en update de mod onder Mods.
  3. Heb je kort daarvoor een andere mod toegevoegd die vergelijkbare onderdelen wijzigt, bijvoorbeeld een performance-mod, verwijder die dan om te testen en start opnieuw op.
  4. Blijft de fout, verwijder dan de mod of meld de fout bij de auteur met de volledige regel uit logs/latest.log.

Goed om te weten: Aanduidingen zoals class_1799 of m_77607_ zijn interne namen van Minecraft-klassen en -methoden. Voor jou telt alleen de modnaam.

Mixin kan niet worden toegepast: mods zijn niet compatibel met elkaar

Zo ziet de melding eruit:

org.spongepowered.asm.mixin.injection.throwables.InvalidInjectionException: @At("INVOKE") on <Target> with priority 1000 cannot inject into <Target>
Mixin apply failed <mod-id>.mixins.json:<Class> -> <Target-Class>

Wat erachter zit: Een mod wil via een mixin, dus via een gerichte ingreep in het Minecraft-programma, een plek aanpassen. In deze mod- of Minecraft-versie vindt de mod de verwachte plek echter niet, vaak omdat een tweede mod daar al iets heeft aangepast. De betrokken mods zijn in deze versies niet compatibel met elkaar.

Zo los je het op:

  1. Verzamel de betrokken mods: de naam van het mixin-bestand (<mod-id>.mixins.json) verraadt de eerste. Staat er in de regel merged by, dan volgt daarachter het mixin-bestand van de tweede.
  2. Maak een back-up en werk de genoemde mods samen bij onder Mods, passend bij je Minecraft- en loaderversie.
  3. Helpt dat niet, zet er dan één van de twee terug naar een versie die met de andere werkt. De pagina's van de mods noemen vaak bekende incompatibiliteiten.
  4. Start de server opnieuw op en controleer in de Console of de melding verdwenen is.

Forge-modlauncher komt bij het opstarten in conflict (ConcurrentModificationException)

Zo ziet de melding eruit:

Exception in thread "Thread-0" java.util.ConcurrentModificationException
    at MC-BOOTSTRAP/cpw.mods.modlauncher@<Version>/cpw.mods.modlauncher.LaunchPluginHandler…

Wat erachter zit: De modlauncher is het onderdeel van Forge dat de mods laadt en Minecraft-klassen vóór de start aanpast. Meerdere mod-transformers, dus bouwstenen voor dit soort aanpassingen, hebben tegelijkertijd dezelfde interne lijst gewijzigd, en Java breekt dat af. Dat wijst op incompatibele coremods, dus mods die diep in de loader ingrijpen, of op een fout in de loader zelf.

Zo los je het op:

  1. Maak onder Back-ups een back-up.
  2. Werk Forge en alle coremods bij. Controleer bij een kant-en-klaar modpack eerst onder Modpack of er een nieuwere versie is, in plaats van Forge afzonderlijk om te zetten.
  3. Verwijder als test de laatst toegevoegde performance- of mixin-mods onder Mods en start opnieuw op.
  4. Start de server weer netjes op, voeg de mods dan één voor één opnieuw toe tot je de veroorzaker kent.

Goed om te weten: Omdat het om gelijktijdige toegang gaat, treedt de fout niet bij elke start op. Start de server bij de tweede poging wel op, dan is de oorzaak toch niet verholpen.

Schemabestand van een mod heeft ongeldige metadata

Zo ziet de melding eruit:

Couldn't deserialize schema file at <mod-id>:schemas/<name>.json because the json file has invalid schema metadata.

Wat erachter zit: Sommige mods beschrijven inhoud in eigen JSON-bestanden, zogenaamde schemabestanden. Zo'n bestand van de genoemde mod past niet bij het formaat dat de mod of de bijbehorende bibliotheek verwacht en wordt overgeslagen. De server draait gewoon door, alleen de inhoud van dit bestand ontbreekt. Vaak passen de mod en de bibliotheekmod niet bij elkaar.

Zo los je het op:

  1. Lees de mod-ID voor de dubbele punt achter schema file at.
  2. Kijk in de stacktrace eronder welke andere mod erbij betrokken is. Vaak is dat een bibliotheek die de mod nodig heeft.
  3. Breng beide onder Mods op versies die bij elkaar passen. De pagina van de mod noemt welke versie van de bibliotheek hij verwacht.
  4. Staat het foutieve bestand in een datapack of in een map die je zelf hebt aangemaakt, dan kun je het in plaats daarvan verwijderen. Maak vooraf een back-up.
  5. Start de server opnieuw op.

YUNG's Better End Island: ontbrekende wereldstatus

Zo ziet de melding eruit:

key missing: bei_ExtraDragonFight in {BorderCenterX:0.0d,BorderCenterZ:0.0d,…}

Wat erachter zit: De mod YUNG's Better End Island maakt in de wereldgegevens een eigen item aan voor het drakengevecht. Dit item kan de mod nu niet vinden. Hij gebruikt dan een standaardstatus en schrijft het item bij de volgende keer opslaan opnieuw weg. De overige wereldgegevens blijven behouden, de server draait gewoon door.

Zo los je het op:

  1. Controleer in het spel of het End-eiland en het drakengevecht normaal werken. Zo ja, dan volstaat een nette herstart: stop de server normaal en start hem weer, niet geforceerd afsluiten.
  2. Klopt de gevechtsstatus niet, werk dan de mod en YUNG's API onder Mods bij naar versies die bij elkaar passen.
  3. Maak onder Back-ups een back-up van de wereld.
  4. Gebruik pas daarna de officiële opdracht /end_island reset. Lees vooraf op de pagina van de mod wat die opdracht terugzet.

Goed om te weten: Verschijnt de melding één keer en daarna niet meer, dan heeft de mod het item opnieuw weggeschreven. Zie ook Een serverback-up maken en herstellen.

Blokeigenschappen van een mod zijn onleesbaar

Zo ziet de melding eruit:

Error while loading physics block properties entry: DataResult.Error['Not a JSON object: [{"selector":"<mod>:<block>","properties":{…}}]

Wat erachter zit: Een mod wilde voor bepaalde blokken eigenschappen inlezen, hier voor zijn fysica, maar het item heeft niet de verwachte vorm. Not a JSON object met daarachter een vierkant haakje betekent: de mod verwacht een item tussen accolades, maar vindt een lijst. Meestal komt de opgave uit een configuratie die voor een andere modversie is geschreven. De betreffende blokken gedragen zich dan als gewone blokken, de server draait gewoon door.

Zo los je het op:

  1. Bepaal de mod: verantwoordelijk is de mod die de fysica-eigenschappen inleest, niet de mods waarvan de blokken in de lijst staan.
  2. Breng deze mod onder Mods op een versie die bij je modpack past.
  3. Heb je de configuratie zelf aangepast, maak dan een back-up, herstel de standaardinstelling en neem je wijzigingen daarna één voor één over.
  4. Start de server opnieuw op en controleer of de melding verdwenen is.

Recept verwijst naar een onbekend receptttype

Zo ziet de melding eruit:

Parsing error loading recipe <mod>:<rezept>: com.google.gson.JsonSyntaxException: Invalid or unsupported recipe type '<mod-id>:<recipe-type>'

Wat erachter zit: Een receptttype bepaalt hoe iets wordt gemaakt, bijvoorbeeld aan de werkbank of in een machine van een mod. Dit recept gebruikt een type dat geen enkele geladen mod kent: de mod ontbreekt of kent het type in zijn huidige versie niet meer. Minecraft slaat het recept over, de server draait gewoon door.

Zo los je het op:

  1. Lees de mod-ID voor de dubbele punt in recipe type '…'. Dat is de mod die het type zou moeten leveren.
  2. Ontbreekt deze mod en heb je het recept nodig, installeer hem dan onder Mods.
  3. Is hij geïnstalleerd, breng hem en de mod of het datapack met het recept dan op versies die bij elkaar passen.
  4. Komt het recept uit een eigen datapack onder world/datapacks/, dan kun je het daar verwijderen. Start daarna opnieuw op.

Goed om te weten: Mis je in het spel niets, dan hindert het overgeslagen recept de werking niet.

Fabric-mod verwijst naar een onbekende tag

Zo ziet de melding eruit:

Unknown tag: net.minecraft.class_<Number>@<Identifier>

Wat erachter zit: Een tag is een benoemde groep van blokken, voorwerpen of andere inhoud, bijvoorbeeld "alle houtstammen". Mods gebruiken tags om inhoud van andere mods te herkennen. Een mod verwacht hier een tag die deze Minecraft- of modversie niet heeft aangemaakt. De betreffende inhoud kan in het spel ontbreken.

Zo los je het op:

  1. De regel zelf noemt geen mod, class_<Number> is een interne naam uit Minecraft. Bekijk in logs/latest.log de regels rond de melding. De eerste regel met een modnaam noemt de veroorzaker.
  2. Werk deze mod en de Fabric API bij onder Mods naar versies die passen bij je Minecraft-versie en bij elkaar.
  3. Start de server opnieuw op en controleer of de melding verdwenen is.

Goed om te weten: Hoe de versies bij elkaar passen, zie je in Fabric Loader en Fabric API: versiefouten gericht oplossen.

Mixin-begeleidende plugin van een mod kan niet worden geladen

Zo ziet de melding eruit:

Error loading companion plugin class [<Class>] for mixin config [<mod-id>.mixins.json]

Wat erachter zit: Veel mods sturen hun mixins, dus hun ingrepen in het Minecraft-programma, aan via een begeleidende klasse. Die bepaalt welke wijzigingen worden toegepast. Deze klasse kon niet worden geladen, meestal omdat de mod niet past bij andere mods of bij jouw versie. Delen van de mod werken dan mogelijk niet.

Zo los je het op:

  1. Lees de modnaam af aan het mixin-bestand (<mod-id>.mixins.json). Ook de pakketnaam van de klasse tussen de rechte haken bevat meestal de naam van de mod.
  2. Werk de mod onder Mods bij zodat hij past bij je Modpack-versie.
  3. Blijft de melding komen, verwijder de mod dan om te testen of meld de fout aan de auteur met de volledige melding uit logs/latest.log.
  4. Start de server opnieuw op.

Goed om te weten: Mis je na het starten een functie van deze mod, dan is deze melding de meest waarschijnlijke verklaring.

Archief (.zip, .rar, .7z) in de mods-map

Zo ziet de melding eruit:

Error for file:///home/container/mods/<File>.zip: java.nio.file.ProviderNotFoundException

Wat erachter zit: In de map mods/ staat een ingepakt archief, bijvoorbeeld een back-up van de map of een gedownload pakket. Mods proberen elk bestand daar als mod te lezen en melden een fout voor het archief. /home/container/ is hierbij de hoofdmap van je server, zoals Bestanden die toont.

Zo los je het op:

  1. Open onder Bestanden de map mods/.
  2. Verplaats het bestand uit de melding uit de map, bijvoorbeeld naar de hoofdmap. Heb je het niet nodig, dan kun je het verwijderen.
  3. Wilde je een heel modpack installeren, gebruik daarvoor dan het gedeelte Modpack.
  4. Start de server opnieuw op.

Goed om te weten: In mods/ horen alleen modbestanden (.jar). Kopieën van de map maak je beter via Back-ups. Basiskennis: Minecraft-mods en -plugins installeren.

Verwijzing naar een onbekend entity-type

Zo ziet de melding eruit:

Error: <mod-id>:<name> is not a valid entity ID!
Invalid or unknown entity type '<mod-id>:<name>'

Wat erachter zit: Entity is de verzamelnaam voor mobs, dieren en andere beweegbare objecten in de wereld. Een configuratie, een datapack of een commando noemt een entity-type, bijvoorbeeld ars_nouveau:wilden_hunter, dat op deze server niet bestaat. De bijbehorende mod ontbreekt of heeft de naam gewijzigd. De invoer wordt genegeerd, de server blijft draaien.

Zo los je het op:

  1. Lees het deel voor de dubbele punt: het noemt de mod waartoe de entity behoort.
  2. Ontbreekt deze mod en moet de entity in het spel voorkomen, installeer de mod dan onder Mods.
  3. Heb je de mod bewust verwijderd of heet de entity inmiddels anders, zoek de naam dan in de configuraties onder config/, in datapacks onder world/datapacks/ of in functies (.mcfunction-bestanden).
  4. Maak een back-up, corrigeer of verwijder de invoer en start opnieuw op.

Mod is beschadigd of past niet bij de versie

Zo ziet de melding eruit:

java.lang.VerifyError: <Details>
EntrypointException: Exception while loading entries for entrypoint '<Name>'
The mixin '<Class>' is missing an @Mixin annotation

Wat erachter zit: Een mod laat zich niet goed laden. Zijn programma is foutief, gebouwd voor een andere Minecraft- of loaderversie of verdraagt zich niet met een andere mod. Achter deze melding zitten meerdere foutbeelden, zoals een VerifyError (Java weigert een geladen programmadeel) of een mislukt entrypoint, het startpunt van een Fabric-mod. Het betreffende deel ontbreekt, in het ergste geval start de server niet.

Zo los je het op:

  1. Zoek de mod: die staat in de melding zelf of als pakket- of mapnaam in de stacktrace eronder.
  2. Controleer of alle mods bij dezelfde Minecraft-versie en dezelfde loader horen. Een Fabric-mod draait niet zomaar op Forge of NeoForge en andersom.
  3. Werk de mod bij onder Mods of verwijder hem om te testen en start opnieuw op.
  4. Start de server zonder de mod, zoek dan een passende uitvoering of zie af van de mod.

Goed om te weten: Book … has use_resource_pack set to false betreft handboeken die via de mod Patchouli lopen: de mod met het boek past niet bij de geïnstalleerde Patchouli-versie. Uitgebreid: Minecraft-mods en modpacks goed instellen.

Recept met te veel vloeistofingrediënten

Zo ziet de melding eruit:

Recipe has more fluid inputs (<Count>) than supported (<Count>).

Wat erachter zit: Een recept uit een datapack of een modintegratie vraagt meer vloeistoffen als ingrediënt dan de machine in deze modversie kan verwerken. Het recept wordt overgeslagen, de server blijft draaien. Meestal is het geschreven voor een andere versie van de mod met de machine.

Zo los je het op:

  1. Bekijk in logs/latest.log de regels rond de melding. Staat daar een recept-ID in het formaat <mod>:<name>, dan toont het deel voor de dubbele punt waar het recept vandaan komt.
  2. Breng de mod met de machine en de mod of het datapack met het recept onder Mods op bij elkaar passende versies.
  3. Komt het recept uit een eigen datapack, verwijder het daar dan of pas het aan.
  4. Start de server opnieuw op.

Goed om te weten: Heb je het recept niet nodig, dan heeft de melding geen invloed op de server.

Slice and Dice: recept met te veel vloeistoffen

Zo ziet de melding eruit:

java.lang.IllegalArgumentException: too many fluid ingredients

Wat erachter zit: De mod Slice and Dice zet kookrecepten van andere mods, bijvoorbeeld van Farmer's Delight, automatisch om in Create-recepten. Minstens één zo'n recept bevat meer vloeistoffen dan de omzetting ondersteunt. Daardoor kunnen sommige omgezette recepten ontbreken. De server blijft gewoon draaien.

Zo los je het op:

  1. Controleer onder Mods welke versies van Slice and Dice, Create en de betrokken kook-mods geïnstalleerd zijn.
  2. Zorg dat ze op onderling passende, actuele versies staan. Op de pagina van Slice and Dice staat met welke versies de mod compatibel is.
  3. Start de server opnieuw en controleer of de melding verdwenen is.

Goed om te weten: Als je hierdoor geen benodigde recepten mist, kun je de melding negeren.

Better Caves kan vloeistofgebieden in grotten niet goed genereren

Zo ziet de melding eruit:

Failed to fetch the AquiferContext.
This is a mod compatibility issue. Please report it to the Better Caves GitHub issue tracker!

Wat erachter zit: YUNG's Better Caves heeft voor ondergrondse water- en lavagebieden extra data uit de wereldgeneratie nodig. Deze data heet AquiferContext en ontbreekt op de opgevraagde plek. De mod meldt een compatibiliteitsfout; nieuw gegenereerde vloeistofgebieden kunnen er daardoor verkeerd uitzien. De server blijft doordraaien.

Zo los je het op:

  1. Maak onder Back-ups een back-up van de wereld voordat je de samenstelling van de mods wijzigt.
  2. Controleer onder Mods of Better Caves en de benodigde bibliotheken bij je Minecraft-versie en je loader passen. Controleer ook de compatibiliteit van andere wereldgenerator-mods.
  3. Test een gecorrigeerde samenstelling eerst op een kopie van de wereld en genereer daar nieuwe gebieden.
  4. Blijft de melding verschijnen, stuur dan de volledige logs/latest.log en je modlijst naar de auteur van Better Caves. Vermeld daarbij of er vooraf gegenereerd is.

Goed om te weten: Een wijziging van de mods genereert reeds opgeslagen gebieden niet automatisch opnieuw.

Curios: ongeldige operatie in een slotdefinitie

Zo ziet de melding eruit:

Parsing error loading curio slot <Mod>:<Slot>
java.lang.IllegalArgumentException: set is not a valid operation!

Wat erachter zit: Curios beheert extra uitrustingsplekken, zogenaamde slots. Een mod of datapack levert hiervoor een definitie met een operatie die jouw Curios-versie niet begrijpt. In het voorbeeld wordt „set” geweigerd. De betreffende definitie wordt niet correct geladen; de bijbehorende uitrustingsplekken kunnen daardoor ontbreken of verkeerd ingesteld zijn.

Zo los je het op:

  1. Lees in de Console of onder Bestanden in logs/latest.log de volledige aanduiding achter „curio slot”.
  2. Controleer welke mod of welk datapack deze definitie levert. Vergelijk de ondersteunde Curios-versie daarvan met de geïnstalleerde uitgave onder Mods.
  3. Installeer op elkaar afgestemde uitgaven. Heb je de definitie zelf bewerkt, corrigeer dan de operatie volgens de documentatie van jouw Curios-versie.
  4. Start de server opnieuw op en controleer of de melding verdwijnt en de betreffende uitrustingsplekken weer werken.

Goed om te weten: Maak een back-up van je eigen wijzigingen voordat je mods of datapacks vervangt.

Staat jouw melding er niet bij?

Lees de hele melding in logs/latest.log, ook de regels ervoor: de eerste fout is meestal de oorzaak, latere zijn vaak alleen gevolgen. De betrokken mod herken je aan de map- en pakketnamen in de stacktrace of aan een bestandsnaam met .jar. Controleer of de mod bij jouw Minecraft- en loaderversie past, en maak vóór elke wijziging een back-up aan. Fouten die pas tijdens het spelen optreden, worden behandeld in Plugin of mod geeft fouten tijdens het draaien. Kom je er niet uit, open dan een ticket en vermeld het tijdstip van de melding.