Crash logs lezen en oplossen

Crash logs lezen en oplossen

Het kan voorkomen dat je Minecraft server crasht. Dat is vervelend, maar geen reden voor paniek. In dit artikel leer je waar je crash logs kunt vinden, hoe je ze leest, welke veelvoorkomende crashes er zijn, en wanneer je ons supportteam moet inschakelen.

Waar vind je de logs?

Je server houdt automatisch logbestanden bij. Deze vind je op twee plekken:

1. De Console (live logs)

Op de Console pagina van je server zie je in realtime de output van je server. Als je server crasht, staan de laatste foutmeldingen hier. Scroll omhoog in het zwarte consolescherm om de fout te zien die de crash veroorzaakte.

Tip: Je kunt zoeken in de console door Ctrl+F (of Cmd+F op Mac) te gebruiken. Er verschijnt een zoekbalk waarmee je door de consoletekst kunt zoeken.

2. De logs map (opgeslagen logs)

Alle serverlogboeken worden opgeslagen in de map logs/. Ga naar de Files tab en open de map logs. Hier vind je:

• latest.log - Het logbestand van de huidige of meest recente serversessie. Dit is het eerste bestand dat je moet checken.
• Datum-bestanden (bijv. 2026-03-05-1.log.gz) - Gecomprimeerde logbestanden van eerdere dagen.

Klik op latest.log om het bestand te openen in de ingebouwde editor van het paneel. Je kunt het bestand ook downloaden als je het liever op je eigen computer bekijkt.

Afbeelding: hier moet afbeelding komen met screenshot van de Files tab met de logs/ map geopend en het latest.log bestand zichtbaar

3. Crash reports

Bij sommige crashes maakt Minecraft een apart crash report aan. Deze vind je in de map crash-reports/ in je hoofdmap. De bestandsnaam bevat de datum en tijd van de crash, bijvoorbeeld crash-2026-03-05_14.30.15-server.txt.

Open dit bestand via de Files tab om de gedetailleerde crash informatie te bekijken.

Hoe lees je een crash report

Een crash report kan er overweldigend uitzien, maar je hoeft niet alles te begrijpen. Focus op deze onderdelen:

De eerste paar regels

De allereerste regels van een crash report bevatten meestal de oorzaak van de crash. Zoek naar regels die beginnen met:

• java.lang.OutOfMemoryError - Je server heeft te weinig geheugen.
• java.lang.NullPointerException - Een programmafout, meestal in een plugin of mod.
• java.lang.NoClassDefFoundError - Een plugin of mod mist een vereist onderdeel.
• java.lang.IllegalStateException - Iets bevindt zich in een ongeldige toestand.

De "Caused by" regels

Zoek naar regels die beginnen met "Caused by:". Deze vertellen je de echte onderliggende oorzaak. Soms staan er meerdere "Caused by" regels. De laatste in de keten is meestal de hoofdoorzaak.

Plugin/mod namen in de stacktrace

In de regels onder de foutmelding (de zogenaamde stacktrace) staan verwijzingen naar specifieke bestanden. Als je daarin de naam van een plugin of mod herkent (bijvoorbeeld at com.example.myplugin.Main.onEnable), dan is dat waarschijnlijk de schuldige.

Afbeelding: hier moet afbeelding komen met screenshot van een voorbeeld crash log in de bestandseditor, met de belangrijkste regels gemarkeerd

Veelvoorkomende crashes en oplossingen

Out of Memory (geheugen vol)

Foutmelding: java.lang.OutOfMemoryError: Java heap space

Oorzaak: Je server probeert meer geheugen te gebruiken dan beschikbaar is.

Oplossingen:

• Verwijder ongebruikte plugins of mods.
• Verklein de view distance in server.properties.
• Beperk het aantal geladen werelden.
• Upgrade naar een hoger plan met meer RAM via de Billing pagina.

Plugin conflict of kapotte plugin

Foutmelding: De fout verwijst naar een specifieke plugin in de stacktrace, bijvoorbeeld Error occurred while enabling PluginNaam.

Oorzaak: Een plugin is niet compatibel met je Minecraft versie, of twee plugins botsen met elkaar.

Oplossingen:

• Update de plugin naar de nieuwste versie.
• Verwijder de plugin tijdelijk om te testen of de server dan wel start.
• Check of de plugin compatibel is met je servertype (Paper, Spigot, etc.) en Minecraft versie.

Corrupte wereld

Foutmelding: Meldingen over Chunk loading error, Region file corruption, of Failed to read chunk.

Oorzaak: Een deel van je wereld is beschadigd, vaak door een eerdere crash of force stop.

Oplossingen:

• Herstel een eerdere backup via de Backups tab.
• Verwijder de beschadigde regio bestanden uit de world/region/ map (de chunks worden opnieuw gegenereerd).

Verkeerde Java versie

Foutmelding: UnsupportedClassVersionError of meldingen over een te oude Java versie.

Oorzaak: Je server draait op een Java versie die niet compatibel is met je Minecraft versie. Minecraft 1.17+ vereist Java 17, Minecraft 1.20.5+ vereist Java 21.

Oplossing: Pas de Java versie aan. Het paneel toont hiervoor een pop-up als het detecteert dat je een verkeerde Java versie gebruikt. Volg de instructies in de pop-up om de juiste versie te selecteren.

Wanneer support contacteren

Neem contact op met het HytaleNode supportteam als:

• Je de oorzaak van de crash niet kunt achterhalen na het lezen van de logs.
• Je server herhaaldelijk crasht zonder duidelijke reden.
• Je een foutmelding ziet die te maken heeft met de server hardware of het netwerk (niet met plugins/mods).
• Je vermoedt dat er een probleem is met de node waarop je server draait.

Maak een ticket aan in het paneel via het Tickets menu. Beschrijf wat er gebeurde, stuur het latest.log bestand mee of kopieer de relevante foutmeldingen. Hoe meer informatie je geeft, hoe sneller we je kunnen helpen.