Troubleshooting every Minecraft server issue

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.

  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.
  2. 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. To learn how to access your server directory, and the /logs folder, check out our tutorial "How to Access Your Server Directory".
  3. If your server crashed, check your console to see if any crash reports were generated - if so, check the latest crash report as this will be able to tell you exactly what went wrong.
  4. 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.
  5. If you're running mods on your server, repeat step 4 for your mods directory.
  6. Stop your server and temporarily rename all of your world files, then start your server again. If this resolves the issue, you will know that your world data is causing the issue.

If option 4, 5, or 6 does resolve the issue, then you will know it is caused by either a plugin or a world corruption or 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 you require any further assistance, please contact our support at:

Mitchell Smith

Managing Director @ Shockbyte

  • minecraft, troubleshooting, server error, world corruption, plugin, software, console, log, crash, crash report
  • 14 Users Found This Useful
Was this answer helpful?

Related Articles

BlackSpigot Error

If you're receiving the error "Please contact BlackSpigotMC. 0x0" and your server isn't starting,...

Set PluginClassLoader as parallel capable

If you're receiving the error "Set PluginClassLoader as parallel capable" and your server isn't...

My Minecraft server won't start

If your server isn't starting, it could be caused by a variety of issues. The steps below should...

MalformedJSONException: Resolving JSON Parsing Errors

An invalid .json configuration file can cause your server to crash or plugins/mods to...

How to Fix Errors in YAML (.YML) Config Files

We have a video tutorial on fixing YAML (.yml) configuration errors:   When...