Experiencing a java.lang.Error: ServerHangWatchdog crash on your Minecraft server? No worries, we can get this sorted out together! This error simply indicates that a single server tick has taken an excessively long time to process (far exceeding the expected 0.05 seconds), causing the server to become unresponsive and intentionally crash itself to prevent corruption.
This usually happens when the server is overwhelmed by incredibly heavy tasks, such as generating massive amounts of new chunks or loading complex, unoptimized mods. Let us walk through how to stop the crashes and fix the underlying lag.
Step 1: Disable the Watchdog Crash
The first step is to disable the mechanism that forces the server to crash when it lags. This will not magically fix the lag itself, but it will stop the server from completely shutting down, buying you time to troubleshoot the root cause.
- Log into your MintServers dashboard and access your Game Panel.
- Click the Stop button. Always stop your server before making configuration changes to prevent data corruption!
- On the left-hand sidebar, click on the Files tab and locate your
server.propertiesfile. Click to open it in the editor. - Search for the
max-tick-time=setting. (By default, this is usually set to 60000). - Change the value to exactly
-1. (It should look likemax-tick-time=-1). Setting this to -1 completely disables the watchdog's crash functionality. - Click Save Content and Start your server back up!
Disabling the watchdog prevents the immediate crash, but your server will still experience heavy lag spikes until you address the root cause of the performance issues!
Step 2: Troubleshoot the Underlying Server Load
Now that the server is staying online, we need to figure out what is making it work so hard. Here are the most common culprits and how to resolve them:
- Resource Limitations: Your server might simply be hitting the limits of its allocated CPU or RAM. Consider upgrading to the Unlimited MAX plan for demanding servers, or increase your processing power by adding a +100%, +200%, or +300% CPU addon directly from your billing dashboard.
- Heavy World Generation: Generating new terrain is highly resource-intensive. We highly recommend using a tool like Chunky to pre-generate your world border so the server does not have to render new land on the fly while players are exploring.
- High View Distance: A massive view distance forces the server to process hundreds of extra chunks per player. Try lowering the
view-distancesetting in yourserver.propertiesfile to reduce the processing load. - Unoptimized Mods or Plugins: Temporarily disable your newest or largest mods/plugins one by one to see if the load decreases. Make sure all add-ons are fully updated, and ensure you are running performance-enhancing mods like Lithium (for Fabric) or running optimized server software like Paper.
- Too Many Entities: A massive concentration of mobs, dropped items, or entities in a single area will quickly choke the server tick rate. Use clearing commands to remove stray items and consider using plugins/mods to strictly control mob spawning caps.
🛠️ Still Experiencing Freezes?
If you have tried optimizing your world, reducing view distances, and isolating your mods but the server is still grinding to a halt, no worries! Just open a support ticket and our team will gladly jump in, review your server logs and diagnostic tools, and help you pinpoint the exact cause of the problem.