How to Read a Minecraft Server Crash Report (and Fix It)

A Minecraft server crash looks scary, but the crash report tells you almost everything you need. Here's how to read it, find the line that matters, and fix the common causes.

Where to look

Two files hold the answer: logs/latest.log (everything the server printed) and crash-reports/ (a dated file written when it hard-crashes). Open the newest one and read from the top of the stack trace.

Find the cause line

Skip past the ASCII art and find the line starting with Caused by: or the first at ... that names a mod or plugin package. That package name usually is your culprit.

Caused by: java.lang.NullPointerException
    at com.someauthor.coolmod.EntityHandler.tick(EntityHandler.java:142)

Common cause 1: out of memory

java.lang.OutOfMemoryError means the server ran out of RAM — common on modpacks. Allocate more memory in your start flags, but never give Java all the system RAM:

java -Xms4G -Xmx6G -jar server.jar nogui

Common cause 2: a bad mod/plugin

If the trace names a mod, update it to match your Minecraft + loader version, or remove it to confirm. Mismatched versions (a 1.20 mod on a 1.21 server) are the most common crash on modded servers.

Common cause 3: corrupted chunk or world

A crash tied to a specific location (ServerLevel / chunk coordinates in the trace) usually means a corrupted chunk. Restore from a backup, or use a tool like MCA Selector to delete the bad chunk.

The clean checklist

1. Open the newest crash-reports/ file or latest.log.
2. Find the Caused by: line and the first mod/plugin package.
3. Out of memory? Raise -Xmx (but leave RAM for the OS).
4. Named mod/plugin? Update it to match your version, or remove it.
5. Chunk/world error? Restore a backup or remove the bad chunk.

The crash report already names the guilty mod. Read the first "Caused by" line before changing anything else.

Minecraft is a trademark of Mojang Synergies AB / Microsoft. ESAGAMES is an independent hosting provider, not affiliated with or endorsed by Mojang or Microsoft.