MINECRAFT · PERFORMANCE
How to Fix Minecraft Connection Timed Out
This doc helps you tell a server problem from a network problem when a player gets connection timed out.
QUICK ANSWER
Check Console first. If the server's online and TPS is healthy, it's a client or network issue, not your server.
Fact
An io.netty timeout error means the packet either never reached the server or the server didn't reply in time, checking Console at that exact timestamp tells you which one it was.
Fact
A high router MTU can silently break the connection handshake, dropping it to 1400 fixes this in some cases even when everything else looks fine.
Before you start
- Console access needed.
- Diagnosing doesn't need a restart, only applying a fix might.
Steps
Check the server first
- 1Open Console.
- 2Make sure the server is online, not crashed or mid restart.
- 3Run
tps, should be near 20.0. - 4Scan the log for
io.nettyortimeoutaround when it failed.
If it's online and TPS checks out, move to the client side checks.
Server side causes
- Crashed. Look at the Console log, then restart.
- TPS tanked. Server's technically up but too slow to reply in time, covered in fixing server lag.
- Whitelist blocking the player. Check
whitelist.jsonunder Files.
Client side causes
- Address typed wrong. Should match the panel's IP and port exactly.
- Firewall or antivirus on their end blocking the launcher.
- ISP routing problem. Have them try mobile data or a VPN to rule it out.
- MTU too high. Dropping router MTU to 1400 sometimes clears this up.
Reading the error
Seeing io.netty.channel.ConnectException or just Connection timed out means the packet either never got there or the server didn't answer in time. If Console shows nothing at that moment, it never arrived, that's a network or firewall issue, not your server.
Verify
Get them to reconnect using the address straight from the panel. Connects, you're done. Console logs a join attempt but they still time out, it's on their side.
If it doesn't work
- Just one player affected, server's fine. Their connection or ISP.
- Everyone drops at once. Server issue, check TPS and Console right away.
- Only happens during peak hours. TPS dropping under load, see fixing server lag.
- Address seems right but still fails. Have them copy it straight from the panel, mistyped ports happen a lot.
How do I know if it's my server or the player's network?
Check Console and run /tps. If the server's online and TPS is near 20, the issue is on their end, not yours.
Only one player keeps timing out, what's going on?
That's almost always their connection or ISP, not the server. Have them test on a different network like mobile data to confirm.
