Hytale: Can't connect to server

Check these in order and retry with one player after each fix. Keep the world files intact while troubleshooting.

1. Match the patchline and finish startup

Update the Hytale client. On berrybyte, stop the server, enable Auto Update under Settings → Game Settings, confirm Patchline, then start.

Both sides must use a compatible protocol on the same patchline. Wait for the download and world loading to finish. See update your server.

2. Complete Hytale Link

If Console prints No server tokens configured, players cannot join. Press Authenticate in the dashboard, approve the current device code, and wait for Authentication successful.

Follow authentication if the code expires or the alert returns after a restart.

3. Copy the full address

Use Overview → Server address, including its port. Open Servers → Direct Connect and paste it.

Join via Code is for friend-hosted worlds. A dedicated server does not need a public Discovery listing to accept address-based joins.

4. Check UDP access

Hytale uses QUIC over UDP. A self-hosted server must allow and forward the UDP port in --bind; the official default is 5520. TCP forwarding does not open that game path.

On berrybyte, use the allocated port shown in Overview.

5. Check password and whitelist

The owner should stop the server and read Password in the root config.json through Files. Send the exact string privately. See settings.

If a whitelist is enabled, check that the joining account is approved. Keep access controls enabled while fixing the actual account or password.

6. Check mods and the startup log

A matching game build does not make every plugin compatible. Check Console for the first mod error and compare that mod's supported build. Use the mod guide.

Still blocked? Open a support ticket with the server linked, error text, patchline, and latest startup log.