Een Minecraft-crashrapport lezen

Een Minecraft-crashrapport ziet er intimiderend uit, maar volgt elke keer dezelfde structuur. Zodra je weet welke regels er echt toe doen, vind je de oorzaak meestal in minder dan een minuut. Deze gids laat zien waar het rapport staat, hoe je de stacktrace ontcijfert en hoe je er een oplossing van maakt.

Waar je het crashrapport vindt

Minecraft schrijft een crashrapport telkens als het spel of de server onverwacht stopt. Kijk hier:

  • crash-reports/
    Een bestand met tijdstempel zoals crash-2026-06-08_14.23.51-server.txt. Dit is het speciale, gedetailleerde rapport.
  • logs/latest.log
    Het volledige actieve log. Als er geen crashrapport is (het proces stopte gewoon), staat de fout hier onderaan.
  • logs/debug.log
    Een veel uitgebreider log, handig wanneer latest.log niet gedetailleerd genoeg is.

Op een server staan deze mappen in de serverroot; op een client staan ze in de map instance/.minecraft. Open altijd het nieuwste bestand op tijdstempel.

De anatomie van een crashrapport

Elk rapport heeft dezelfde onderdelen, van boven naar beneden:

  • Kop & beschrijving
    Een Description-regel van één regel die samenvat wat er misging, plus het tijdstip. Dit is je eerste aanwijzing.
  • De stacktrace
    Het uitzonderingstype, daarna een lijst met coderegels die laten zien waar het gebeurde, vaak gevolgd door een of meer Caused by: -blokken.
  • Betrokken wereld / details
    Bij wereld- of entity-crashes: de coördinaten, de dimensie en de betrokken entity/het blok.
  • Systeemdetails
    Minecraft-versie, Java-versie, toegewezen geheugen, de mod-loader en de volledige modlijst. Goud waard voor de diagnose.

Hoe je het echt leest, stap voor stap

  1. Lees de Description-regel. Het is een samenvatting in gewone taal, bijv. „Exception ticking entity” of „Unexpected error”. Dat vertelt je al de categorie.
  2. Vind het uitzonderingstype bovenaan de stacktrace (bijv. java.lang.OutOfMemoryError, NullPointerException, NoClassDefFoundError). Het type benoemt het probleem vaak meteen.
  3. Ga naar de laatste „Caused by:”. Wanneer er meerdere geketend zijn, is de diepste meestal de echte oorzaak, niet de eerste.
  4. Zoek naar een mod- of pluginnaam in het pakketpad (bijv. com.somemod.Thing). Dat wijst rechtstreeks naar de boosdoener. Een puur net.minecraft.* -trace wijst juist naar vanilla-/wereldgegevens.
  5. Controleer de systeemdetails. Bevestig dat de Java-versie overeenkomt met je Minecraft-versie, kijk hoeveel geheugen werd toegewezen en doorzoek de modlijst op duplicaten of verouderde items.
  6. Koppel het symptoom aan een bekende oplossing. Gebruik de gevonden oorzaak om naar de bijbehorende oplossing te gaan (zie de voorbeelden hieronder).

Wat veelvoorkomende traces je vertellen

  • OutOfMemoryError: Java heap space
    Niet genoeg geheugen. Zie Out of Memory.
  • Exception ticking entity
    Eén beschadigde entity. Zie Ticking Entity.
  • A single server tick took 60.00 seconds
    De server bevroor. Zie Watchdog Crash.
  • NoClassDefFoundError / ClassNotFoundException
    Een ontbrekende bibliotheek. Zie NoClassDefFoundError.
  • Exit code -1 with no crash report
    Lees in plaats daarvan latest.log. Zie Error Code -1.

Blader ze allemaal door op de pagina Veelvoorkomende problemen .

Geen crashrapport? Lees latest.log

Soms stopt het proces gewoon (vaak met exitcode 1 of -1) zonder een crashrapport te schrijven. In dat geval staat de echte fout onderaan logs/latest.log. Scroll vanaf het einde omhoog naar de eerste ERROR-, FATAL- of Exception-regel: daar ging het mis. Om het logformaat zelf te begrijpen, zie Minecraft-logs begrijpen.

Veelgestelde vragen

In de map crash-reports/ in de hoofdmap van je server of in de map instance/.minecraft, met de datum en tijd van de crash in de naam. Open het nieuwste bestand.

Het crashrapport is een gerichte momentopname die wordt geschreven wanneer het spel stopt. latest.log is het volledige actieve log. Is er geen crashrapport, dan staat de fout onderaan latest.log.

Kijk naar de packagenamen in de stacktrace en de diepste "Caused by:"-regel. Een niet-vanilla package (niet net.minecraft) noemt meestal de verantwoordelijke mod; bevestig dit via de modlijst in System Details.

Ja, plak of upload het crashrapport in MCDoctor.ai en het legt de oorzaak en de oplossing in begrijpelijke taal uit.