How to join your Hytale server

Join your Hytale server from the Servers menu with the address and port from your address card, like orbit.play.wilderack.com:34117. Hytale can’t find the port by itself, so always type the whole thing.

Your address and port

Your address is on the address card on Overview, with a copy button and a QR code.

• It looks like orbit.play.wilderack.com:34117. The part after the colon is the port.
• The port is picked for your server. It is not Hytale’s default port, 5520, so don’t type 5520 unless you have a Dedicated IP.
• The How to join card on Overview shows these same steps for your server.

Why the port? Most games can look up a port from a DNS record called SRV. Hytale doesn’t support SRV records yet, and Hypixel says it is still looking at it. So every Hytale address needs its port.

Join from Windows, Mac or Linux

Hytale is a PC game. Players on Windows, Mac and Linux all join the same way.

1. Copy the address from the address card. Send it to your friends in Discord too.
2. Open Hytale and choose Servers on the main menu.
3. Add the server: Add Server saves it in your list, and Direct Connect joins once without saving.
4. Paste the address with the port, like orbit.play.wilderack.com:34117. If you save it, give it a name like “Orbit”.
5. Connect. If the server has a password, type it when the game asks.

Button names can shift a little between Hytale updates. If you can’t see them, look for the option to add or connect to a server on the Servers screen.

There is no console or phone version of Hytale right now, so there’s nothing to set up for crossplay.

Find it in Server Discovery

Since Update 5, Hytale has a Server Discovery page where players browse community servers. Your server doesn’t appear there on its own:

• You list it on your Hytale account under Server Profiles, and Hypixel reviews it by hand.
• The server must be signed in with your own Hytale account and stay awake, because it checks in with Hytale every two minutes.
• Server Discovery isn’t available on parent-managed Hytale accounts. Players with those accounts join by address instead.

The sign-in guide has the full steps. Most groups of friends never need a listing: sharing the address works fine.

Passwords and whitelists

Server password. Set one in Settings, or set Password in config.json. Restart the server to turn it on. Players type the password when they join.

Whitelist. A whitelist lets in only the players you name. Use these in the Console:

Add yourself and your operators before you turn the whitelist on, or you can lock yourself out. Since Update 6, the whitelist works through a permission called hytale.server.join. The commands give and take that permission for you. An old whitelist.json file is renamed to whitelist.json.migrated and no longer used.

Joining a sleeping server

Your server naps when nobody is playing. Joining wakes it, usually in a couple of seconds.

• If the game gives up on the first try, wait a few seconds and connect again.
• The wake link play.wilderack.com/w/orbit wakes the server from any browser. Opening it before a session means the server is ready when your friends join.
• A sleeping server doesn’t show in Server Discovery. Set it to stay awake under Settings > Sleep if you list it publicly.

Can’t connect?

Check these first:

1. Did you type the port? Without it, the game tries 5520 and can’t reach your server.
2. Is the server stopped? A server you stopped by hand doesn’t wake on join. Press Start on Overview.
3. Did Hytale update? The game and server must be on the same version. Your server updates on its own unless you pinned a version in Settings > Game version.
4. Are you on school or work Wi-Fi? Some networks block the kind of traffic Hytale uses. Try a phone hotspot.

Still stuck? See the game can’t reach the server, joining is slow or the world never loads and the rest of the common errors page.