🎮 Game Error Codes What it means & how to fix it

Eco Can't Connect to a Server? Here's the Fix

When Eco can't connect — the server list is empty, you time out, or the web dashboard won't open — it's usually the game and web ports not both being forwarded, or a same-machine port clash. Eco needs one UDP and one TCP port; get both open.

Exact details for Eco

Ports to forward
UDP 3000 (game) + TCP 3001 (web/query)
Config file
Network.eco — set game and web ports here
Protocol split
3000 is UDP (gameplay), 3001 is TCP (web dashboard / server info)
Common cause of 'won't start'
Client + server on one PC — must use a different port pair than 3000/3001

Error codes

Can't reach server / connection failed The client never establishes a game session

Cause: UDP 3000 not forwarded to the host.

Fix:
  1. Forward UDP 3000 (game) to the server machine.
  2. Set the ports in Network.eco to match what you forwarded.
  3. Allow EcoServer through Windows Firewall (Private + Public).
  4. Join directly by public IP:3000 if the browser can't find it.
Server not listed / no info shown The server runs but shows no name or player count

Cause: TCP 3001 (web/query) not forwarded.

Fix:
  1. Forward TCP 3001 (web interface / query) alongside UDP 3000.
  2. Open http://<publicIP>:3001 to confirm the web dashboard responds.
  3. Check the server is set to public in Network.eco.
  4. Confirm no firewall rule is stripping the query port.
Won't start / port already in use The server fails to bind its ports

Cause: Client and server on the same PC clash on 3000/3001.

Fix:
  1. If running the client on the same machine, set the server to two DIFFERENT ports in Network.eco (not 3000/3001).
  2. Forward the new pair you chose.
  3. Make sure nothing else is bound to those ports.
  4. Restart the server after editing Network.eco.

Fixes that work for most Eco errors

  1. Forward UDP 3000 (game) and TCP 3001 (web/query).
  2. Set both in Network.eco to match forwarded ports.
  3. On a shared machine, use a different port pair for the server.
  4. Check the web dashboard at http://<publicIP>:3001.
  5. Allow EcoServer through Windows Firewall (Private + Public).
  6. Join by public IP:3000 if the list is empty.

FAQ

What ports does an Eco server need?

Two: UDP 3000 for the game and TCP 3001 for the web interface and queries. Forward both — if only 3000 is open the server connects but shows no name or player info.

Why does my Eco server fail to start on one PC?

If you run the client and server on the same machine, they clash on 3000/3001. Set the server to a different port pair in Network.eco and forward those instead.

Why is my Eco server's web dashboard unreachable?

TCP 3001 isn't forwarded or is firewalled. Open port 3001 (TCP) and confirm http://<publicIP>:3001 responds from outside your network.

Other games