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: https://shockbyte.com/billing/submitticket.php

Mitchell Smith

Managing Director @ Shockbyte

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

Related Articles

How to Analyze a Timings v2 Report

Pre-requisites: You can create a timings report by following our guide. Once you have the...

Set PluginClassLoader as parallel capable

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

Unable to Place Command Blocks

Sometimes, Minecraft servers don't generate their files properly when you start your server for...

Understanding Java Error Exit Codes

In some cases, your server may crash without any explanation or crash report. Often in these...

Connection refused: no further information

Note: This tutorial applies to Windows users only. The...