How to Troubleshoot Connection Issues on Your Minecraft Server

Connection issues are one of the most common problems players experience when trying to join a Minecraft server. This guide covers the most frequent connection errors and how to resolve them using the Wabbanode Control Panel and client-side fixes.

Step 1: Check if Your Server is Running

Before troubleshooting anything else, confirm your server is online:

1. Navigate to the Wabbanode Control Panel and select your Minecraft server.
2. Check the server status indicator. It should show ONLINE.
3. If the server is Offline or Stopped, click Start to bring it online.
4. Wait for the console to display "Server Ready" before attempting to connect.

Step 2: Verify the Server IP and Port

Make sure players are using the correct server address:

1. In the Wabbanode Control Panel, your server IP and port are displayed in Server Address field.
2. Players should enter the address in the format ip:port (e.g., play.example.com:25565) when adding the server in their Minecraft client.
3. If you have set up a custom domain or subdomain, ensure the DNS records are correctly pointing to your server's IP. See our guide on How to Add a Subdomain/Domain to Your Minecraft Server.

Step 3: Check the Console for Errors

The server console often reveals the cause of connection failures:

1. Open the Console in the Wabbanode Control Panel.
2. Look for error messages around the time a player tries to connect. Common errors include:
   • "Disconnected: Failed to verify username": See our dedicated guide on How to Fix "Failed to Verify Username".
   • "You are not whitelisted on this server": The server has a whitelist enabled. See How to Enable and Configure a Whitelist.
   • "You are banned from this server": The player has been banned. See How to Ban and Unban Players.
   • "Outdated client/server": The player's Minecraft version does not match the server version. Both must be on the same version.

Common Connection Errors

"Can't Connect to Server" / "Connection Refused"

This means the player's client cannot reach the server at all.

Server-side checks:

• Confirm the server is running and has fully started (check the console for "Done")
• Verify the correct IP and port are being used
• Check that Enable Status is set to true in Settings so the server appears as online in the server list

Client-side fixes:

• Restart the Minecraft client completely
• Double-check the server address for typos
• Try connecting with the IP address directly instead of a domain name

"Connection Timed Out"

The client is trying to reach the server but receiving no response.

Server-side checks:

• Ensure the server is running and not stuck during startup
• Check the console for any crash loops or errors
• If the server recently crashed, restart it from the panel

Client-side fixes:

• Check your internet connection
• Try restarting your router
• Disable any VPN that may be interfering with the connection
• On Windows, open Command Prompt and run ipconfig /flushdns to clear your DNS cache

"Outdated Client" or "Outdated Server"

The player and server are running different Minecraft versions.

• "Outdated client" means the player needs to update their Minecraft to match the server version
• "Outdated server" means the server is running an older version than the player's client

Players can switch their Minecraft version by editing their profile in the Minecraft Launcher under Installations.

"io.netty.channel.AbstractChannel$AnnotatedConnectException"

This Java networking error typically means the server cannot be reached.

• Verify the server IP and port are correct
• Ensure the server is online and not in a crash loop
• Try again in a few minutes, this can be caused by temporary network issues

Troubleshooting

• Only some players can't connect. The issue is likely client-side. Have affected players restart their client, check their internet connection, and verify they are using the correct server address and Minecraft version.
• No one can connect. Check if the server is running. If it is, look at the console for errors. If the server was recently reinstalled or its IP changed, update the address given to players.
• Players could connect before but not now. Check if the server crashed and is stuck. Look at the console for repeated error messages. Restart the server from the panel if needed.
• Connection works sometimes but drops. This may indicate the server is running out of RAM or experiencing TPS drops. Check our guide on How to Reduce Entity Lag on Your Minecraft Server and consider upgrading your server plan.
• Custom domain not working. Ensure your DNS records are properly configured and have had time to propagate (up to 48 hours). See our guide on How to Add a Subdomain/Domain to Your Minecraft Server.