NEW 📢 Save up to 30% on your first month, limited time offer!

Minecraft server problems and fixes

MinecraftUpdated Oct 5, 20268 min read

Almost every Minecraft server problem shows up as a line in the Console. Start there, then find your problem below. In the Console, click Errors to show only error lines, and read the last few lines before the server stopped. See How to use the console and run commands.

If you changed something just before the problem began, undo that first. It is the cause far more often than anything else.

The server will not start or stops straight away

What you seeCauseFix
The server stops right after starting and the Console mentions the EULAMojang's End User License Agreement was not accepted. The Minecraft Wiki says the server shuts down at once without it. The panel normally accepts it for you at setup.Open Files, then eula.txt. If it says eula=false, read Mojang's terms, change it to eula=true and save. If it keeps coming back, open a ticket.
UnsupportedClassVersionErrorA server, plugin or mod needs a newer Java than your server runs. The Paper documentation names this error as the sign of an outdated Java.Install an older build of the plugin or mod (change the Minecraft version filter in the Modding tab, or upload an older jar by hand), or move to a Java that fits. Settings, then Launch Details shows the Java image your server uses and lets you choose another. The panel's own install message names the Java a plugin or mod needs.
Failed to bind to portThe server was told to use a port or address it cannot have. The Minecraft Wiki says to leave server-ip empty.Do not change the server port or address in the files. The panel sets them, and it normally empties server-ip for you at every start. If you changed them, open server.properties in Files, empty the server-ip line (the Server Properties (Java) page does not offer it) and restart. If it still fails, open a ticket.
The Console shows an error naming a setting or a fileA setting the game rejects, or a file with a typoPut the last value back. See How to change your server settings
The server starts, then stops after loading, or stops with no error while players are onIt may have reached your plan's memory limitCheck Usage, then RAM, on Overview. See How much RAM does a Minecraft server need
Server attempted to load chunk saved with newer version of minecraft!The world was last saved by a newer Minecraft than the server runs. The Paper documentation says worlds cannot be downgraded.Put the server on that version or a newer one, or restore a backup from before the upgrade. See How to change your Minecraft version or server type
A single server tick took 60.00 secondsThe server froze, and its watchdog stopped it. The Minecraft Wiki describes this message.Look at the lines before it for the plugin, mod or farm that froze it. Do not switch the Watchdog limit off to hide it. See How to reduce lag on your Minecraft server

For the general checklist, including Kill for a server stuck on Starting, see How to fix a server that will not start.

Players cannot join

What the player seesFix
Connection timed out, or cannot reach the serverThe server must be Online. Copy the whole Server Address, with the port. See How to join your Minecraft server
Outdated client, or outdated serverThe game and the server versions differ. The same article explains both messages.
You are not white-listed, or you are bannedSee How to set up a whitelist and ban players
Invalid session, or failed to verify usernameThe player restarts the game and the launcher, and signs in again
The server is fullYour plan sets the player slots. See How to rename your server and change player slots
Missing or incompatible modsThe player needs the same loader, version and mods. See How to install mods on Forge, Fabric and NeoForge
A Bedrock player cannot join a Java serverSee How to let Bedrock players join your Java server with Geyser

Plugins and mods

What you seeCauseFix
A plugin is missing from the plugins list, or the Console shows an error with its nameIt is built for another Minecraft version, or another kind of server, or needs another pluginRead its page for the versions it supports, update it, and install anything it needs. See How to install plugins on Paper, Spigot and Purpur
Ambiguous plugin name with two file namesTwo versions of the same plugin are in pluginsDelete the older file in Files, then restart
A mod says it requires another mod, often Fabric APIA library mod is missingInstall what the message names, for the same loader and version
A mod does nothing, or the server crashes at startThe mod is for another loader or version, or it is a client-only modRemove the newest mod and restart, then read the mod's page. See How to install mods on Forge, Fabric and NeoForge
A modpack will not startThe pack needs more memory, or it is not made for serversSee How to install a modpack on your Minecraft server
The plugin or mod installer says it cannot be installedThe panel checked and found the file cannot run on your server, for the loader, a library or the Java versionFollow the message, change the Minecraft version filter in the Modding tab to find a build that fits, or upload a suitable jar by hand

Worlds

What you seeFix
A new empty world appears after a restartWorld name does not match the folder, or you changed it. Put it back. See How to upload your own Minecraft world
The Nether or the End is emptyThe dimension folders are in the wrong place for your server type. Same article.
Your builds disappearedRestore your backup. See How to back up, restore and reset your Minecraft world
Seed, difficulty or game mode "did nothing"Some settings only apply to a new world. See How to change the MOTD, icon, difficulty, game mode and seed

Commands

What you seeFix
Unknown or incomplete commandCheck the spelling and your Minecraft version, and that you are an operator at a high enough level. A plugin command needs its plugin. See How to op yourself and manage permissions
A command works in the game but not in the Console, or the reverseConsole commands have no slash. See Minecraft commands for server owners
A setting you changed with a command went back after a restartSome commands only last until the next restart. Set it in Settings instead.

Lag and crashes

  • Can't keep up! Is the server overloaded? means a tick ran long. See How to reduce lag on your Minecraft server.
  • java.lang.OutOfMemoryError means Java ran out of memory. Remove mods or lower View distance, and check Usage.
  • Crash reports are written to a crash-reports folder in Files. The top of the report names the cause. Include it in a ticket.

When to open a ticket

Open a ticket if the fix above does not work, or if you are not sure whether a step is safe. Include:

  • the server the ticket is about, chosen under Which server? in the ticket form
  • what you changed just before the problem began
  • the last 50 to 100 lines of the Console, or tick the option to attach the log
  • for a crash, the newest file in crash-reports

Never put a password or your forwarding secret in a ticket. See How to open a support ticket and What to include in a ticket for each kind of problem.

CREATE YOUR GAME SERVER
READY TO GET STARTED?

Save up to 30% on your new game server.
Premium performance, instant activation, and unbeatable reliability all at a better price.

OUR LATEST BLOGS