Crashlogs van je gameserver begrijpen

Een gameserver crasht soms onverwacht. De crashlog vertelt je precies wat er misging. Door deze log te lezen kun je het probleem vaak zelf oplossen, of geef je ons supportteam de informatie die nodig is om snel te helpen.

Waar vind je de crashlog?

De locatie van de crashlog verschilt per game:

• Minecraft (Paper/Spigot): in de map crash-reports/ of onderaan in logs/latest.log.
• FiveM: in de serverconsole en in de map cache/ of het logbestand dat je in server.cfg hebt ingesteld.
• Andere games: meestal in een map als logs/, Saved/Logs/ of direct in de console-uitvoer.

In het HostValues gamepanel kun je de console-uitvoer direct bekijken in het tabblad Console. Scroll omhoog om de foutmelding te vinden vlak voor het moment dat de server stopte.

Wat staat er in een crashlog?

Een crashlog bevat doorgaans de volgende onderdelen:

1. De foutmelding (exception): de eerste regel na "Exception" of "Error" beschrijft het probleem. Dit is het belangrijkste stuk.
2. De stacktrace: een reeks regels die beginnen met "at" en laten zien welke code de fout veroorzaakte. Hier kun je vaak de naam van een plugin, mod of het spel zelf herkennen.
3. Systeeminformatie: Java-versie, serverversie, besturingssysteem en geheugengebruik.

Veelvoorkomende fouten herkennen

• OutOfMemoryError: de server heeft te weinig RAM. Upgrade je pakket of optimaliseer je instellingen.
• UnsupportedClassVersionError: verkeerde Java-versie. Controleer welke Java bij je Minecraft-versie hoort.
• PluginException of een pluginnaam in de stacktrace: een plugin veroorzaakt de crash. Verwijder of update de plugin.
• IOException bij een wereldbestand: mogelijke schijfcorruptie of een beschadigd chunkbestand.
• Connection refused of BindException: de poort is al in gebruik of niet correct geconfigureerd.

Wat moet je doen na een crash?

1. Kopieer de volledige foutmelding en stacktrace.
2. Zoek de foutmelding op in een zoekmachine. Veel problemen zijn al eerder opgelost door de community.
3. Controleer of het probleem is veroorzaakt door een recente wijziging: een nieuwe plugin, een update of een configuratieaanpassing.
4. Kom je er niet uit, open dan een supportticket en plak de relevante regels uit de crashlog erbij. Hoe meer context je meestuurt, hoe sneller wij kunnen helpen.

Hoe onderscheid ik een servercrash van een clientcrash?

Een servercrash stopt het hele serverproces. Alle spelers verliezen de verbinding tegelijk. Een clientcrash treft alleen de individuele speler. Staat de server nog online na het probleem, dan gaat het om een clientcrash.

Kan ik crashlogs automatisch laten opslaan?

Ja. De meeste gameservers bewaren crashlogs automatisch in een logmap. Op een VPS kun je de console-uitvoer naar een bestand schrijven door een logparameter mee te geven bij het starten, bijvoorbeeld --log of -logfile output.log.

Mijn server crasht steeds opnieuw na het starten. Wat nu?

Controleer de log op de foutmelding. Verwijder als test de laatst toegevoegde plugin of mod. Controleer ook of je Java-versie en serverversie bij elkaar passen. Helpt niets, hernoem dan tijdelijk de map plugins of mods om te testen of de server zonder die bestanden wel opstart.