Waarom crasht mijn Minecraft server? Oorzaken en oplossingen

Stap 1: Controleer de log-bestanden

Log-bestanden zijn altijd je eerste stap. Zonder logs is het vrijwel onmogelijk om de oorzaak van een crash te achterhalen. De relevante bestanden staan op de volgende locaties:

Bestand	Locatie	Inhoud
Huidige sessie	`logs/latest.log`	Alles van de huidige of laatste run
Crashrapport	`crash-reports/crash-YYYY-MM-DD_HH.MM.SS-server.txt`	Gedetailleerde crash dump
Oude logs	`logs/YYYY-MM-DD-N.log.gz`	Gearchiveerde logs (te openen met bijv. 7-Zip)

Wat zoeken in een crashrapport?

Een crashrapport ziet er globaal zo uit:

---- Minecraft Crash Report ----
// <automatisch gegenereerde grap>

Time: <tijdstip>
Description: <HIER staat WAT er crashte>

java.lang.OutOfMemoryError: Java heap space
    at ...
    at ...

-- System Details --
Minecraft Version: 1.20.1
Java Version: 17
Memory: X MB / Y MB

Let bij het lezen van een crashrapport altijd op deze drie onderdelen:

De regel achter Description: — dit beschrijft wat er crashte
De eerste regel die begint met java.*Error of java.*Exception — dit is de foutmelding
De regel Memory: onder System Details — dit toont het geheugengebruik op het moment van de crash

De meest voorkomende oorzaken

Te weinig RAM

Dit is de meest voorkomende oorzaak van Minecraft server crashes.

Herkenbaar aan:

java.lang.OutOfMemoryError: Java heap space in het crashrapport
De server wordt trager en crasht daarna
De crash treedt op bij veel spelers of bij het laden van chunks

Wat er gebeurt: De JVM heeft niet genoeg geheugen toegewezen gekregen om de server stabiel te draaien.

Oplossing: Pas de startparameters aan zodat de server meer geheugen mag gebruiken:

java -Xms2G -Xmx4G -jar server.jar nogui

-Xms staat voor het minimale geheugen bij opstart
-Xmx staat voor het maximale geheugen dat de server mag gebruiken

Controleer hoeveel RAM jouw hostingplan beschikbaar stelt voordat je deze waarden verhoogt.

Corrupte chunks

Herkenbaar aan:

java.lang.NullPointerException gerelateerd aan chunk-loading
De server crasht steeds op dezelfde locatie in de wereld
De crash herhaalt zich na elke herstart

Wat er gebeurt: Een of meerdere chunk-bestanden zijn beschadigd, bijvoorbeeld door een onverwachte afsluiting van de server.

Oplossing:

Stap 1. Noteer de coördinaten die worden vermeld in het crashrapport.

Stap 2. Gebruik MCEdit of Amulet Editor om de corrupte chunk te verwijderen.

Stap 3. Als alternatief kun je het betreffende .mca regio-bestand verwijderen uit de map world/region/.

Maak altijd een volledige backup voordat je regio-bestanden verwijdert of aanpast.

Plugin- of mod-conflict

Herkenbaar aan:

De crash treedt op direct na het opstarten
De stacktrace verwijst naar een plugin- of modnaam
De crash begon na het installeren of updaten van een plugin of mod

Waar kijken: Zoek in het crashrapport naar het gedeelte -- Plugins -- voor een lijst van geladen plugins. In de stacktrace zie je de naam van de verantwoordelijke plugin op regels als:

at com.pluginnaam.Klasse.methode(Klasse.java:42)

Oplossing:

Stap 1. Verwijder plugins één voor één uit de map plugins/.

Stap 2. Herstart de server na elke verwijdering.

Stap 3. Herhaal dit totdat de crash stopt. De laatste plugin die je verwijderde is de boosdoener.

Verkeerde Java-versie

Herkenbaar aan:

UnsupportedClassVersionError in de logs
De server start niet op of crasht direct bij het opstarten

Elke versie van Minecraft vereist een specifieke versie van Java:

Minecraft versie	Vereiste Java versie
1.16 en ouder	Java 8
1.17	Java 16
1.18 t/m 1.20	Java 17
1.21 en nieuwer	Java 21

Controleer je geïnstalleerde Java-versie met het volgende commando:

java -version

Beschadigde server JAR of wereld

Herkenbaar aan:

ZipException of IOException in de logs
De server crasht direct bij het opstarten

Wat er gebeurt: Het server.jar-bestand of een wereld-bestand is beschadigd, bijvoorbeeld door een mislukte download of een schijfprobleem.

Oplossing: Download het server.jar opnieuw via de officiële bron voor jouw servertype:

Vanilla: minecraft.net
Paper: papermc.io
Fabric: fabricmc.net

Herstel de wereld vanuit een bestaande backup als het wereld-bestand beschadigd is.

Watchdog-crash (TPS te laag)

Herkenbaar aan:

Het woord Watchdog in de crash description
De melding A single server tick took 60.00 seconds
De server was merkbaar traag vóór de crash

Wat er gebeurt: De server kon een tick niet op tijd voltooien. Dit wordt veroorzaakt door te veel entiteiten (dieren, monsters of items op de grond), te zware redstone-systemen, of te veel spelers verspreid over verschillende gebieden tegelijk.

Oplossing:

Stap 1. Beperk mob-spawning via bukkit.yml met de instelling spawn-limits.

Stap 2. Gebruik Spark om te profileren welk onderdeel de TPS vertraagt.

Stap 3. Pas max-tick-time aan in server.properties indien nodig. Let op: het uitschakelen van deze instelling kan crashes maskeren in plaats van oplossen.

Stappenplan bij een crash

Gebruik dit stappenplan om snel de oorzaak van een crash te achterhalen:

Stap 1. Open de map crash-reports/ en zoek het nieuwste bestand.

Stap 2. Lees de regel achter Description: en de eerste foutmelding in de stacktrace.

Stap 3. Controleer of een plugin- of modnaam wordt vermeld in de stacktrace.

Stap 4. Bekijk het geheugengebruik onderaan het rapport onder System Details.

Stap 5. Vergelijk de vermelde Java-versie met de vereiste versie voor jouw Minecraft-versie.

Stap 6. Zoek de exacte foutmelding op via Google, gecombineerd met jouw servertype (Paper, Fabric, enzovoort).

Handige tools

Tool	Gebruik
Spark	Server performance profiling
Amulet Editor	Chunk-reparatie en wereldbewerking
mclo.gs	Minecraft logs delen met automatische foutmarkering
Pastebin	Logs delen voor hulp van de community

mclo.gs is specifiek gebouwd voor Minecraft logs en markeert fouten en waarschuwingen automatisch. Dit maakt het eenvoudig om logs te delen wanneer je hulp vraagt in de community.

Hulp nodig? Neem contact op via support.etheron.nl