/> />

Troubleshooting Every Minecraft Server Issue

Server Errors & Troubleshooting

·

Nov 2, 2024

Minecraft server errors are almost always caused by software - meaning: the plugins, mods or worlds on your server. This guide explains how to troubleshoot any issue and find the cause of your problem every time.

Troubleshooting a Minecraft Server

Step 1:

Check your console for any errors

This is always the first step if something goes wrong. Errors in your console will be able to tell you what's wrong.

You can also refer to your error logs located in the /logs folder in your server's directory for full logs of the past and present.

click console then click errors to see if there are any errors present
Step 2:

If your server crashed, check to see if any crash reports were generated

If your server has crashed recently, it is likely that it will generate a crash report. If you are unsure of how to, feel free to read our guide on how to locate and read crash reports.

Step 3:

Temporarily rename your plugins directory and restart your server

This will load your server with no plugins, so if this resolves the issue, you will know a plugin is causing the problem. If this is the case, you can usually rule out world corruption from being a potential cause, which is great to know.

If you're running mods on your server, generate a backup before you try this same method out with the mods folder.

rename your plugins folder, then restart the server
Step 4:

Temporarily rename all your world folders and restart your server

Generate a backup of your server, then rename each world directory before restarting your server. If the server was not starting, but starts without problem after changing the world folder name, this would indicate world data corruption is at play. Feel free to refer to our guide on the topic here if your world is experiencing corruption.

If option 3 or 4 does resolve the issue, then you will know it is caused by either a plugin, world corruption, or an invalid block/chunk.

If it's caused by a plugin, you can disable individual plugins one by one (by renaming the .jar at the end to something like .jar.disabled) until you find the specific plugin causing the issue. If the issue is world or chunk related, you should check out our article on fixing world corruption here.

For more assistance with troubleshooting your server, feel free to check out our other troubleshooting articles here, or contact our 24/7 support team for additional help.


Zach's Avatar
Zach Lowery

Game Experience Engineer