Minecraft-logs begrijpen

Minecraft-logs zijn je beste bron van waarheid als er iets misgaat. Ze leggen op volgorde vast wat het spel of de server deed, tot het moment van de storing. Deze gids legt uit welke logbestanden belangrijk zijn, hoe je een logregel leest en waar je op moet letten.

De logbestanden die ertoe doen

Alles staat in de map logs/ (serverroot, of instance/.minecraft op een client):

  • latest.log
    Het volledige log van de huidige sessie. Dit is het bestand dat je als eerste opent; de fout staat hier bijna altijd.
  • debug.log
    Een veel uitgebreidere versie van dezelfde sessie. Gebruik het wanneer latest.log niet genoeg zegt.
  • Gearchiveerde logs
    Oudere sessies zijn ingepakt als 2026-06-08-1.log.gz. Pak het uit om een eerdere sessie te lezen.
  • crash-reports/
    Een aparte map met een gericht rapport dat alleen wordt geschreven wanneer het spel crasht. Zie Een Minecraft-crashrapport lezen.

Hoe je een logregel leest

Elke regel volgt hetzelfde formaat:

[14:23:51] [Server thread/ERROR]: Encountered an unexpected exception
  • [14:23:51]
    De tijdstempel: wanneer de gebeurtenis plaatsvond.
  • [Server thread/ERROR]
    De thread die het logde, en het niveau.
  • Het bericht
    Wat er werkelijk gebeurde, vaak gevolgd door een stacktrace als het een fout is.

Het logniveau toont de ernst in één oogopslag: INFO (normaal), WARN (er is iets mis maar niet fataal), ERROR (een echte storing), en FATAL (de server gaat uit).

Threads: wie er aan het woord is

  • Server thread / main
    De centrale spel-loop. Fouten hier beïnvloeden meestal direct de gameplay (en kunnen de server laten crashen).
  • Worker / IO threads
    Achtergrondwerk zoals chunk-I/O. Handig voor schijf- en wereldopslagproblemen.
  • Mod/plugin threads
    Genoemd naar een mod of plugin: een snelle hint over wat verantwoordelijk is.

Waar je op moet letten

  1. Scroll naar de eerste ERROR/FATAL- of Exception-regel; latere fouten zijn vaak slechts gevolgen ervan.
  2. Lees de opstartsectie op mislukte mods/plugins, de verkeerde Java-versie of een niet-geaccepteerde EULA.
  3. Let op herhaalde WARN-spam zoals „Can't keep up!” (prestaties, zie Can't Keep Up) of „moved too quickly”.
  4. Noteer de laatste regels voor een bevriezing of afsluiting: ze laten zien wat de server deed toen hij uitviel.
  5. Vergelijk elke fout met de Veelvoorkomende problemen lijst voor de exacte oplossing.

Serverlogs vs. clientlogs

Ze delen hetzelfde formaat maar staan op verschillende plekken. Een serverlog registreert wereldopslag, spelersverbindingen en het laden van plugins/mods; een clientlog registreert rendering, resource packs en je eigen verbinding. Vergelijk bij een verbindingsprobleem beide: de oorzaak kan aan slechts één kant liggen.

Logs veilig delen

Logs kunnen het IP van je server en soms tokens bevatten, dus plak ze niet openbaar zonder er eerst naar te kijken. Gebruik een paste-dienst (zoals mclo.gs) om te delen, of upload het bestand rechtstreeks naar MCDoctor.ai, dat het log leest en je de oorzaak en oplossing uitlegt, zonder handmatig graafwerk.

Veelgestelde vragen

In de map logs/ in de hoofdmap van je server of in de map instance/.minecraft. De huidige sessie is latest.log; oudere sessies zijn gecomprimeerde .log.gz-bestanden.

Ze dekken dezelfde sessie, maar debug.log is veel uitgebreider. Begin met latest.log en schakel alleen over naar debug.log als je meer detail nodig hebt.

WARN betekent dat er iets mis is maar niet fataal; ERROR is een echte storing; FATAL betekent dat de server afsluit. Richt je op de eerste ERROR/FATAL-regel.

Ja, upload latest.log of een crashrapport en MCDoctor.ai analyseert het en geeft de waarschijnlijke oorzaak en aanbevolen oplossing.