🎯 Facing Errors: A Minecraft Server Troubleshooting Guide 🎯

Let's admit it: errors can be quite frustrating. In this article, we'll assist you in understanding and resolving errors that occur on your Minecraft server.

In this guide, we'll categorize the most common errors into startup, minor, and connection errors. You can identify your specific error based on when it occurs and what game type you're using.

⬆️ Startup Errors ⬆️

General - Java + Bedrock

General Startup Errors	How to Fix It
EULA Error	When initiating your server for the first time, you'll need to accept the Minecraft EULA (End User License Agreement). If you encounter this error and crash during startup, displaying You need to agree to the EULA in order to run the server. Go to eula.txt for more info., simply accept the Minecraft EULA when prompted, or manually set eula to true in the eula.txt file.
Permission Denied	If you encounter an error like /entrypoint.sh: line 12: ./bedrock_server: Permission denied, navigate to the indicated file, adjust the permissions to 755 by right-clicking or selecting the three dots next to the file, accessing permissions, and making the necessary changes.
Failed to Bind Port	This error typically manifests as **** FAILED TO BIND PORT! The exception was: java.net.BindException: Address already in use Perhaps a server is already running on that port? To resolve this, change your server port as it's likely being used by another server. If you have a dedicated IP, consider reaching out via live chat for assistance.
Unable to Read World Format	If you receive an error indicating the server's inability to load the world file, it suggests either corruption or incompatibility with your gametype. Ensure compatibility by generating a new world, converting the existing world format, or importing a compatible, uncorrupted world.

Java Startup Errors

Java Startup Errors	How to Fix It
Unable to Access server.jar File	This error often occurs when the server.jar file is missing, named incorrectly, or corrupted. Rename the file to server.jar if necessary, or upload/re-upload it manually. If corrupted, consider reinstalling the server.
Java Version Error	If prompted to use a specific Java version (e.g., Minecraft 1.17 requires running the server with Java 16 or above.), adjust the Java version accordingly. Forge users may encounter compatibility issues, indicated by console errors. To address this, select the appropriate Java version in the control panel's startup section.
Crash: Out of Memory	Server freezes, kick players, and unresponsive console indicate exceeding RAM limits. Allocate sufficient RAM, optimize memory usage, and restart the server periodically.
Crashing Mods/Plugins	Unspecified startup errors likely originate from problematic mods/plugins. Identify and update/delete the problematic mods/plugins to rectify the issue.

Bedrock Startup Errors

Bedrock Startup Errors	How to Fix It
Failed to Open Curl Lib from Binary	Modify the ipv6 in server.properties to resolve this error, ensuring it differs from ipv4.
Pocketmine Errors	Ensure the correct PHP version alignment for Pocketmine versions to avoid startup errors.
Nukkit Errors	Choose the server language upon startup (e.g., eng for English) to prevent misinterpretation as server failure.
Bedrock Server Permission Denied Issue	Adjust permissions for the bedrock_server file to 755, allowing successful server booting.

Proxy Errors

Ensure the following configurations are in place for a properly functioning proxy:
We'll expand this section with more errors soon

``bukkit.yml connection-throttle to -1
spigot.yml bungeecord to true
server.properties online-mode to false
IP forwarding to true on bungee

Restart all related servers afterward

Here's a refined version:

🤏 Minor Errors 🤏

Error	How to Fix It
Plugin/Mod Errors	If you encounter an error that doesn't halt the server's startup, it's likely due to a mod or plugin issue. Such plugins/mods might be disabled or functioning improperly. Check their configurations for any anomalies (instructions are usually available on the download site). Outdated or poorly developed plugins/mods can also cause issues. Review the settings, update to the latest version if available, or consider removing them if they consistently fail to work.
Timings URLs Not Created	Ensure that your paper.yml file has a history and interval set to the recommended values and that the timings URL is configured to the default one: https://timings.aikar.co/
Missing Required Core Mod or Plugin (Java)	This error suggests that a mod/plugin requires another core mod/plugin that is not present. To resolve this, either remove the dependent mod/plugin or install the required one (the console or download site typically indicates which one is needed).
Server Overload: "Can't Keep Up"	When this error occurs, it indicates a drop in TPS (ticks per second), resulting in lag. Identify the source of the lag by referring to our server optimization article.
Incompatible Protocol Version (PMMP)	An incompatible protocol version error signifies that a plugin is outdated. Ensure you download plugins from Poggit and select the appropriate version for your server on the plugin page.
Failed Loading Error

This error, such as Failed loading /home/container/bin/php7/lib/php/extensions/no-debug-zts-20190902/opcache.so: /home/container/bin/php7/lib/php/extensions/no-debug-zts-20190902/opcache.so: cannot open shared object file: No such file or directory, can be disregarded as it does not impact server functionality.

🌐 Connection Errors 🌐

Error	How to Fix It
Outdated Server	Update your server, downgrade your Minecraft client, or install a multi-version support plugin like ViaVersion.
Outdated Client	Downgrade your server, update your Minecraft client, or add a multi-version support plugin like ViaBackwards (requires ViaVersion).
Invalid IP	Ensure you enter a valid IP address (comprising numbers and dots) in the server address field.
Banned by an Operator	Contact a server administrator to lift the ban. Use /pardon or /unban if you have console access, or /pardon-ip or unban-ip if your IP is banned.
Server Whitelisted	Add your in-game name to the whitelist using whitelist add in the console. Alternatively, disable whitelist in server.properties by setting whitelist to false and restarting the server.
Bad Login	Avoid logging in too quickly and ensure compatibility between your Minecraft version and the server. Check your internet connection as it may also contribute to this error.
Authentication Servers Down for Maintenance	Wait if the authentication servers are indeed offline. If not, ensure your firewall isn't blocking the connection or consider changing online-mode to false in server.properties.
Failed to Verify Username/Invalid Session	Log out and log back into Minecraft. For non-premium versions, set online-mode to false in server.properties and restart the server.
Connection Refused (If It's You)	Verify the IP and port, ensure your antivirus or firewall isn't blocking the connection, and check for network issues.
Connection Refused (If It's Not Just You)	Examine the server console for errors and ensure compatibility with the chosen gametype.
Timeout Errors	Consider upgrading your hardware, closing other programs, or improving bandwidth if you encounter io.netty.handler.timeout.ReadTimeoutException.
SocketException: Connection Reset	Check your internet connection and server console for errors.
Server Returned HTTP Response Code: 503	This occurs when Minecraft.net is down. Monitor Minecraft news for updates.
NullPointerException	Locate the Java crash log (e.g., hs_err_pid...txt on your desktop) to identify the issue.
Unable to Connect to World (Bedrock)	Verify the IP, port, and server's gametype compatibility. Check for console errors affecting the connection.
Authentication Error (Bedrock)	Reload Minecraft, log out, and log back in using your Microsoft account. Wait if authentication servers are offline.
Failed to Open Curl Lib from Binary (Vanilla Bedrock)	Rename or delete conflicting server files, such as server.properties, or adjust the port settings.
Internal Server Error (PMMP)	Identify the problematic plugin causing the error by examining the console and plugin configuration. Ensure plugin compatibility and functionality.
Cannot Join Pocketmine Server

Repair your server's configuration or replace it with a downloaded one. Alternatively, adjust the max-mtu-size in pocketmine.yml to 1450.

Not Finding Your Error? Try Understanding the Cause by Reading Logs or Crash Report.

💥 Understanding a Crash Report 💥

In the file manager, you might discover crash reports within a folder labeled crash reports. Inside, various reports are categorized by date. Locate the report from the day of the crash. Within this log, you'll uncover the sequence of errors leading up to the crash, along with system specifications. Familiarize yourself with the meanings of the following letters for this section: 'U' = Unloaded, 'L' = Loaded, 'C' = Constructed, 'H' = Pre-initialized, 'I' = Initialized, 'J' = Post-initialized, 'A' = Available, 'D' = Disabled, 'E' = Errored.

Here's an example:

| State | ID         | Version      | Source                           | Signature |
|:----- |:---------- |:------------ |:-------------------------------- |:--------- |
| L     | minecraft  | 1.12.2       | minecraft.jar                    | None      |
| L     | mcp        | 9.42         | minecraft.jar                    | None      |
| L     | FML        | 8.0.99.99    | forge1122.jar                    | None      |
| L     | forge      | 14.23.5.2847 | forge1122.jar                    | None      |

🤔 Other Errors 🤔

If none of the fixes have resolved your issue, consider reinstalling (remember to create a backup first).

For unique joining issues, refer to the Minecraft help forum or reach out to Minecraft support.
If you're still unable to resolve your error, initiate a live chat for assistance 👍.

Updated on: 30/05/2024