CAFORADocs
Troubleshooting

Cannot Connect to Server

Fix connection issues when you cannot join your Cafora Minecraft server.

Illustrated procedure

Screenshots show the current application with demonstration data. Use your own service details; click an image to inspect it at full size.

Check the console

Open Essentials → Console. Check the current state, startup output and errors before making changes. Wait for Done or your software’s ready message before joining.

Check the console
Check the console2026-11-11 · Current application interface · demonstration data · Open full-size image

Locate the file log

Under Files, double-click logs and locate latest.log. Check modification times. Preserve the relevant file before a restart replaces or rotates it.

Locate the file log
Locate the file log2026-11-11 · Current application interface · demonstration data · Open full-size image

Read the complete error context

Open the log in the editor and inspect the earliest relevant error and surrounding lines. Remove tokens, passwords and private player details before sharing. Do not diagnose from the last line alone.

Read the complete error context
Read the complete error context2026-11-11 · Current application interface · demonstration data · Open full-size image

Describe the request to support

Open a support ticket with the service or invoice ID and the requested action. For connection issues include time, error and MTR evidence. Never include passwords, tokens or card details.

Describe the request to support
Describe the request to support2026-11-11 · Public page · no private account data · Open full-size image

Server-Side Checks

Is the Server Online?

  • Check server status in the Pterodactyl Panel
  • Look at the console for running status
  • Try restarting the server

Correct Address?

Minecraft Version Match

  • Your client version must match or be compatible with the server version
  • Check ViaVersion/ViaBackwards if using older clients with newer servers

Client-Side Checks

Common Error Messages

ErrorMeaningSolution
Connection RefusedServer not accepting connectionsCheck if server is online
Connection Timed OutNetwork cannot reach serverCheck address, firewall, DNS
Unknown HostAddress cannot be resolvedVerify the server address
Invalid SessionMinecraft authentication issueRestart your Minecraft launcher
Outdated Client/ServerVersion mismatchUpdate client or server

Firewall Issues

  • Your local firewall may be blocking Minecraft
  • Try a different network (mobile hotspot) to isolate the issue
  • Check if your ISP blocks gaming ports

Origin IP Is Not the Entry Address

Connecting directly to the origin IP will always fail — Minecraft ports on the origin IP are dropped by design. Always connect with the server hostname. See Server IP.

Advanced Checks

See the Connectivity Troubleshooting page for detailed network diagnostics.


Service information · Backups · Support

On this page