Een Minecraft-modpack op een gratis server kan nog bezig zijn met installeren, bij het starten afbreken of al draaien terwijl een vriend niet kan joinen. Deze drie situaties vragen om verschillende vervolgstappen. Begin met de actuele paneelstatus en het log van deze startpoging. Verwijder niet eerst willekeurig mods of de gedeelde wereld.

Deze gids loopt langs de eerste mislukte MCF-Free-start. De gecontroleerde 2 GB RAM en 10 GB opslag zijn een beperkt hostingpakket. Een pack dat in de catalogus zichtbaar is, is dus niet automatisch geschikt voor Free. Een groot pack kan al tijdens het laden meer resources nodig hebben, voordat iemand speelt.

Gecontroleerd: 7 oktober 2026. De handleiding gebruikt geen verzonnen starttijd en geen rangorde van zogenaamd de meest voorkomende fouten. Bepalend zijn jullie actuele poging en de eisen van de gekozen packuitgave.

Eerst herkennen welke stap ontbreekt

Paneeltoestand Wat je vervolgens controleert
Installatie loopt of wacht Installatievoortgang en actuele melding; niet steeds opnieuw installeren
Start loopt, daarna afbreking Volledig nieuw startlog en de eerste concrete foutoorzaak
Server draait, vriend komt er niet in Client-pack, adres en join-fout apart vergelijken
Server draait, spel hapert Belasting tijdens het draaien onderzoeken; dat is een ander probleem dan een mislukte start

Een installatieopdracht in een wachtrij is nog geen mod-crash. Ook een oude foutmelding op het scherm beschrijft niet per se de poging die nu loopt. Vergelijk tijd, startopdracht en status. Als er al een installatie- of herstelproces loopt, wacht dan het resultaat daarvan af.

Vier gescheiden stappen van het serverpakket via het startlog en de draaiende server tot het joinen van een vriend
Vier gescheiden stappen van het serverpakket via het startlog en de draaiende server tot het joinen van een vriend

Het verloop scheidt installatie, start en join. Er worden geen wachttijden toegezegd.

De poging vastleggen voordat je iets verandert

Noteer de packnaam en de exacte packrelease. Voeg de Minecraft-versie, de loader inclusief build, de gekozen runtime en de hoeveelheid RAM en opslag toe. De packrelease is een ander nummer dan de Minecraft-versie. Een pack kan meerdere uitgaven voor dezelfde Minecraft-versie hebben.

Sla het volledige actuele consolelog op als bestand. Als er een crashreport is aangemaakt, sla dat dan ook op. Niet elke afbreking maakt automatisch een bestand aan in de map crash-reports. Een screenshot met alleen de laatste rode regel kan de eigenlijke oorzaak verbergen.

Stop de server voordat je bestanden wijzigt. Voordat je iets aan een bestaande spelstand wijzigt, maak je een back-up van wereld, modlijst, configuratie en noodzakelijke spelergegevens. Bewaar de oorspronkelijke kopie apart. Als je een log aan de support geeft, verwijder dan toegangsgegevens en andere privé-inhoud uit de kopie die je doorgeeft; behoud wel de foutketen en relevante versiegegevens.

De oorzaak uit de foutketen lezen

Lees de eerste concrete fout en de bijbehorende Caused by-onderdelen. Voor Fabric legt de officiële crashreport-handleiding uit hoe rapport en foutketen samenhangen. De laatste vervolgfout is niet altijd de veroorzaker.

Could not execute entrypoint stage 'main' duidt op een fout bij het uitvoeren van een entrypoint. Alleen deze regel bewijst geen client-only-mod. Pas de genoemde extensie, de verdere foutketen en de bijbehorende installatiedocumentatie leveren een onderbouwde volgende stap op.

Een melding over een ontbrekende afhankelijkheid vraagt om de juiste afhankelijkheid in de juiste versie en omgeving. Een melding over een incompatibele Minecraft- of loaderversie vraagt eerst om een versievergelijking. De Fabric-versiegids behandelt deze vergelijking uitgebreider.

Bij UnsupportedClassVersionError komt de Java-klasseversie van een geladen bestand niet overeen met de gebruikte runtime. Dat beschrijft de Java-referentie. Controleer de runtime-eis van de concrete packrelease. Wissel niet tegelijk Java, Minecraft en alle mods naar willekeurige nieuwere uitgaven.

Het bedoelde serverpakket gebruiken

Een client-pack bevat ook extensies voor weergave, bediening of andere clientfuncties. Een serverpakket kan daarom een andere bestandslijst hebben. Kopieer niet de hele mods-map van een vriend naar de server om zogenaamd gelijke lijsten te maken.

Controleer de projectpagina van de gekozen uitgave: is er een apart serverpakket, extra serverinstructies of uitdrukkelijk vereiste wijzigingen? Gebruik die uitgave en de bijbehorende handleiding. De Fabric-installatiedocumentatie maakt onderscheid tussen omgeving en compatibiliteit van mods.

Sorteer een mod niet uit op basis van alleen zijn naam. Sommige projecten bieden optionele serverfuncties, hoewel het gebruik op de client bekender is. Als de concrete uitgave duidelijk alleen voor de client wordt aangeboden of ongeschikt is voor de server, stop dan eerst de server en maak een back-up van wereld, modlijst en configuratie. Verplaats het bestand daarna volgens de packhandleiding naar een aparte map buiten mods; verwijder het in eerste instantie niet. Houd een lijst bij van de gewijzigde bestanden.

Een schone test met het bedoelde serverpakket is vaak veelzeggender dan talloze losse wijzigingen aan de beschadigde opzet. Voor een bestaande wereld heeft ook deze test een aparte kopie en passende wereld- en modversies nodig.

Resources afstemmen op een daadwerkelijke bevinding

Lees de eisen van de packrelease. Vergelijk ze met het beschikbare Free-pakket, de vrije schijfruimte en de omgeving die daadwerkelijk draait. Het geboekte RAM, de Java-heap-instelling en de geheugenbehoefte van het hele proces zijn verschillende grootheden.

Een expliciete OutOfMemoryError-melding is een belangrijke geheugenbevinding. Een losse exitcode 137 of het woord Killed bewijst daarentegen nog niet waarom het proces is beëindigd. Controleer aanvullende resource- en systeemmeldingen of laat de support de concrete poging beoordelen.

Als de aangetoonde packeis boven Free uitkomt, kies dan een kleiner passend pack of controleer het benodigde extra pakket. De gids voor de tariefkeuze begint bij precies deze grens. Een groter pakket verhelpt noch een ontbrekende afhankelijkheid, noch automatisch een verkeerde runtime.

Een navolgbare tweede poging doen

Wijzig alleen de aangetoonde oorzaak en start daarna gecontroleerd opnieuw. Vergelijk het nieuwe log met de veiliggestelde eerste poging. Een andere foutmelding kan betekenen dat de eerste fout is verholpen en er een volgende zichtbaar is geworden.

Als afzonderlijke mods geïsoleerd onderzocht moeten worden, gebruik dan een aparte testopzet met een kopie en een overbodige testwereld. Start jullie enige originele wereld niet met verwijderde content-mods, want hun blokken of data kunnen ontbreken of worden gewijzigd. Hoofdmod, bibliotheken en verplichte uitbreidingen horen bij de vergelijking bij elkaar. Als een deelverzameling start, weet je voorlopig alleen dat deze combinatie onder de testomstandigheden werkt; het verwijderde deel kan een eigen fout bevatten. Het halveren van de bestandslijst garandeert geen vast aantal herstarts: onderling afhankelijke mods en meerdere fouten kunnen de methode vertekenen.

Bij wereld-, registry- of generatorfouten stop je de poging voordat je nog meer versies probeert. Een onleesbare wereld is niet automatisch definitief beschadigd; ook een ontbrekende of gewijzigde mod kan meespelen. Lees bij Unable to read or access ... het exacte bestandspad en de eerdere meldingen: het bestand kan ontbreken, onleesbaar zijn, verkeerde rechten of ongeldige data hebben. Stuur bij wereld- of opslagbestandsfouten, onduidelijke identiteitskoppeling of herhaalde afbrekingen de support het volledige relevante logfragment, de modlijst, de versies en de laatste wijziging. Herstel geen wereldbestanden op goed geluk en verwijder geen spelersvoortgang voor diagnose. Verwijder de wereld niet als diagnosemaatregel.

Na een stabiele start volgt de eerste modpack-join met een passende client-instantie; een gestart proces bewijst nog geen geslaagde client-join. Laat twee vrienden met een identieke packuitgave joinen en controleer of de bestaande wereld- en spelersdata behouden zijn. Pas dan is het probleem opgelost. Voor een draaiende maar trage server is spark voor lag-analyse de volgende, aparte stap.

FAQ

Bewijst een entrypoint-fout een client-only-mod?

Nee. Het toont een mislukt entrypoint. Lees de betrokken extensie, de foutketen en de servereisen ervan voordat je een bestand verwijdert.

Moet de modlijst op client en server identiek zijn?

Niet volledig. Client-only- en server-only-componenten kunnen verschillen. De versies die nodig zijn voor de verbinding en de spelinhoud moeten bij het pack passen.

Kan ik elk aangeboden pack met Free starten?

Zichtbaarheid in de catalogus is geen Free-toezegging. Toets de eisen van de concrete uitgave aan 2 GB RAM en 10 GB opslag en aan de werkelijk vrije ruimte.

Betekent exitcode 137 altijd te weinig RAM?

De code alleen levert deze oorzaak niet eenduidig op. Controleer aanvullende meldingen en resourcebevindingen van de betreffende poging.

Moet ik bij een wereldfout een nieuwe wereld aanmaken?

Maak eerst een back-up van de bestaande stand en bewaar die. Controleer ontbrekende mods, registry, generator en versies in een kopie. Een nieuwe wereld is geen bewijs dat de oude niet te redden is.

Welke gegevens helpen de support?

Packnaam en release, Minecraft en loader, runtime, resources, tijdstip, paneelstatus en het volledige nieuwe log. Voeg de laatste wijziging en een eventueel crashreport toe, zonder privé-toegangsgegevens.