Minecraft is one of the most popular games in the world and has many players facing one of many errors when they try to play the game. The list below provides the solutions and workarounds to some of the most common error codes players run into.

Minecraft Error Codes List (and How to Fix Them)

This is a comprehensive list, so we’ll try to keep the solutions and workarounds concise. No one wants to run into more problems when they’re trying to fix one already!

Multiplayer Errors

These are issues you will only face when you’re online or trying to connect to a server.

Connection refused: connect

  • Possible Causes The IP:Port you entered is invalid. The server itself is inaccessible. Possible Solutions Confirm you’ve entered the correct server address and try again.

Creeper

  • Possible Causes A network issue is interfering with the login process. Possible Solutions Run general troubleshooting on your internet connection.

Crossbow

  • Possible Causes Something interfered with the client during login. Possible Solutions Completely close down the game and force-close it if possible. Restart it and let it sit for a few minutes to make sure it loads correctly.

Drowned

  • Possible Causes This means there is an unknown error occurred. Possible Solutions There is no direct solution for this. Minecraft recommends closing the client and launcher and restarting it.

End of stream

  • Possible Causes The server is not sending information to the client. Possible Solutions Restart Minecraft or the server. Confirm both the server and the client have good internet connection.

Failed to login: Bad Login

  • Possible Causes You’ve attempted to log in too quickly after your previous attempt. Possible Solutions Confirm that you are running the same version of Minecraft as the server. Check your network connection. Wait a few minutes before trying to log in again.

Failed to login: invalid IP

  • Possible Causes The Mojang servers cannot validate your IP address. Possible Solutions Try again later when validation services have returned to normal. Check your internet connection to make sure there are no dropped packets.

Failed to login: the authentication servers are currently down for maintenance

  • Possible Causes The Minecraft server could not contact the authentication server for the user logging in. Possible Solutions Try again later when the authentication servers return to normal. Check your firewall to make sure the servers are not blocked. Set the server.properties to online-mode=false. This disables authentication for the server.

Ghast

  • Possible Causes Credentials between your Xbox Live account and Microsoft/Mojang account are incorrect or don’t match. Possible Solutions On Windows devices, sign out of Xbox Live and sign back in. On Switch, go to Settings, then Profile, and select Clear Account Credentials.

Glowstone

  • Possible Causes This means that one of the services failed to properly authenticate the account, but there is no specific source known. Possible Solutions Wait for the login server to be operating properly again. Restart your client/launcher.

Haybale

  • Possible Causes There is an issue with the authorization process for your Xbox. Possible Solutions Make sure the Xbox app is updated and force and update, if possible. Log out, restart the app, and log back in.

Internal Exception: io.netty.handler.timeout.ReadTimeoutException

  • Possible Causes The game our your computer can’t process the data from the server fast enough, forcing you to fall out of sync with the server. Possible Solutions Check your internet connection to make sure there are no dropped packets. Make sure your computer is fast enough to run the game. It takes more processing power to play it on a server than in single player.

java.io.IOException: Server returned HTTP response code: 503

  • Possible Causes The server cannot authenticate your account because minecraft.net is down. Possible Solutions Try again later when the Minecraft authentication servers have returned to normal.

java.net.SocketException: Connection reset

  • Possible Causes The server has shut down or using an excessive amount of processing power. The user’s internet connection forced them to disconnect from the server. Possible Solutions Wait a few minutes and try to reconnect to the server. Confirm the server connection is normal.

Marketplace Errors (L-, D-, S- or P-)

  • Possible Causes These are issues related directly to the Marketplace itself. Possible Solutions There is nothing you an do directly except wait for the server to resolve the issue and try again later.

  • Possible Causes Your Minecraft client is using an older version than the client the server is using. Possible Solutions Update your Minecraft client to the version the server is using.

Outdated client!

Outdated server!

  • Possible Causes Your Minecraft client is using a newer version than the client the server is using. Possible Solutions In the Minecraft Launcher, change your Minecraft version to the one being used by the server.

Piglin

  • Possible Causes There are too many users trying to log in from your device. Possible Solutions Force the game to close and restart it.

Pufferfish

  • Possible Causes There is an unknown issue with the client during login. Possible Solutions Force the game to close, restart your device, and attempt to log back in to Minecraft.

This server responded with an invalid server key.

  • Possible Causes An attempt to validate a modified server has returned with an incorrect value. Possible Solutions Attempt to log in again.

Took too long to log in.

  • Possible Causes The server cannot authenticate who you are because minecraft.net wasn’t responding Possible Solutions Confirm your internet connection works properly, and that there is no loss of connection. Wait a few minutes and try again.

User Not Premium

  • Possible Causes Your Minecraft client does not pass the minecraft.net authentication. Possible Solutions Confirm your client is a paid version of the game, rather than a hacked or modified client.

You are not whitelisted on this server

  • Possible Causes You are not on the list of people who may connect to the server. Possible Solutions Contact the server owner/administrator and request to be added to the list of people who may connect to the server.

Crashes

These issues can happen either in Single Player or Multiplayer and usually result in the game shutting down.

  • The IP:Port you entered is invalid. The server itself is inaccessible.

  • Confirm you’ve entered the correct server address and try again.

  • A network issue is interfering with the login process.

  • Run general troubleshooting on your internet connection.

  • Something interfered with the client during login.

  • Completely close down the game and force-close it if possible. Restart it and let it sit for a few minutes to make sure it loads correctly.

  • This means there is an unknown error occurred.

  • There is no direct solution for this. Minecraft recommends closing the client and launcher and restarting it.

  • The server is not sending information to the client.

  • Restart Minecraft or the server. Confirm both the server and the client have good internet connection.

  • You’ve attempted to log in too quickly after your previous attempt.

  • Confirm that you are running the same version of Minecraft as the server. Check your network connection. Wait a few minutes before trying to log in again.

  • The Mojang servers cannot validate your IP address.

  • Try again later when validation services have returned to normal. Check your internet connection to make sure there are no dropped packets.

  • The Minecraft server could not contact the authentication server for the user logging in.

  • Try again later when the authentication servers return to normal. Check your firewall to make sure the servers are not blocked. Set the server.properties to online-mode=false. This disables authentication for the server.

  • Credentials between your Xbox Live account and Microsoft/Mojang account are incorrect or don’t match.

  • On Windows devices, sign out of Xbox Live and sign back in. On Switch, go to Settings, then Profile, and select Clear Account Credentials.

  • This means that one of the services failed to properly authenticate the account, but there is no specific source known.

  • Wait for the login server to be operating properly again. Restart your client/launcher.

  • There is an issue with the authorization process for your Xbox.

  • Make sure the Xbox app is updated and force and update, if possible. Log out, restart the app, and log back in.

  • The game our your computer can’t process the data from the server fast enough, forcing you to fall out of sync with the server.

  • Check your internet connection to make sure there are no dropped packets. Make sure your computer is fast enough to run the game. It takes more processing power to play it on a server than in single player.

  • The server cannot authenticate your account because minecraft.net is down.

  • Try again later when the Minecraft authentication servers have returned to normal.

  • The server has shut down or using an excessive amount of processing power. The user’s internet connection forced them to disconnect from the server.

  • Wait a few minutes and try to reconnect to the server. Confirm the server connection is normal.

  • These are issues related directly to the Marketplace itself.

  • There is nothing you an do directly except wait for the server to resolve the issue and try again later.

  • Your Minecraft client is using an older version than the client the server is using.

  • Update your Minecraft client to the version the server is using.

  • Your Minecraft client is using a newer version than the client the server is using.

  • In the Minecraft Launcher, change your Minecraft version to the one being used by the server.

  • There are too many users trying to log in from your device.

  • Force the game to close and restart it.

  • There is an unknown issue with the client during login.

  • Force the game to close, restart your device, and attempt to log back in to Minecraft.

  • An attempt to validate a modified server has returned with an incorrect value.

  • Attempt to log in again.

  • The server cannot authenticate who you are because minecraft.net wasn’t responding

  • Confirm your internet connection works properly, and that there is no loss of connection. Wait a few minutes and try again.

  • Your Minecraft client does not pass the minecraft.net authentication.

  • Confirm your client is a paid version of the game, rather than a hacked or modified client.

  • You are not on the list of people who may connect to the server.

  • Contact the server owner/administrator and request to be added to the list of people who may connect to the server.

Failed to check session lock, aborting

  • Possible Causes An active lock on part of the world that a third party editor has left locked. Possible Solutions Delete session.lock in the world save folder.

java.lang.NullPointerException

  • Possible Causes This is a catch-all crash response. There are many error logs that could cause this. The game client crashed on startup. Possible Solutions Find the Java crash log (look for a file on your desktop that looks similar to: hs_err_pid). Check for the exact error code there. If you’re unable to determine the problem and it persists, rename the .minecraft directory to something else. Start Minecraft again and start a new game. This will create a new .minecraft directory. If necessary, move the saved worlds to the new .minecraft/saves folder.

Runtime Errors

These are errors with the game understanding the code while the game is running. These may be caused by changes made to the code or issues with the way your game/world is saved.

  • An active lock on part of the world that a third party editor has left locked.

  • Delete session.lock in the world save folder.

  • This is a catch-all crash response. There are many error logs that could cause this. The game client crashed on startup.

  • Find the Java crash log (look for a file on your desktop that looks similar to: hs_err_pid). Check for the exact error code there. If you’re unable to determine the problem and it persists, rename the .minecraft directory to something else. Start Minecraft again and start a new game. This will create a new .minecraft directory. If necessary, move the saved worlds to the new .minecraft/saves folder.

com.google.gson.JsonSyntaxException

  • Possible Causes Your world may be corrupted. There is invalid JSON/NBT formatting in your save files; tag names are defined as a “variable” instead of a string. Possible Solutions Restore your save to a previous backup and remove any mods that you didn’t have before this issue.

java.lang.OutOfMemoryError

  • Possible Causes Your game has run out of memory. Possible Solutions Increase the amount of memory that is allocated to java. Free up memory by closing down any other unused programs. Reduce the number of mods that use excessive amounts of computer memory.

RuntimeException: No OpenGL context found in the current thread.

  • Possible Causes Your graphics card or driver cannot run Minecraft. Possible Solutions Make sure your graphics driver is up-to-date. On Linux systems, install a package that contains the xrandr utility. Upgrade your graphics card to something more powerful.

These are the most common error codes that players face. If you have one that isn’t listed above, be sure to let us know in the comments below!

  • Your world may be corrupted. There is invalid JSON/NBT formatting in your save files; tag names are defined as a “variable” instead of a string.

  • Restore your save to a previous backup and remove any mods that you didn’t have before this issue.

  • Your game has run out of memory.

  • Increase the amount of memory that is allocated to java. Free up memory by closing down any other unused programs. Reduce the number of mods that use excessive amounts of computer memory.

  • Your graphics card or driver cannot run Minecraft.

  • Make sure your graphics driver is up-to-date. On Linux systems, install a package that contains the xrandr utility. Upgrade your graphics card to something more powerful.

Want to improve the look of your Minecraft game? Use our guides on How to Install OptiFine and How to Install BSL Shaders!