How to join a Hytale server
Join a Hytale dedicated server from Servers → Direct Connect using host:port. Self-hosted servers default to UDP 5520; berrybyte's allocated port can differ. Expiring Join via Code share codes are for friend-hosted worlds, not dedicated servers.
A dedicated Hytale server is joined with its host:port, not with a share
code. Where that address comes from depends on who hosts the server.
Find the server address
Open Overview
Log in to the dashboard and open the Hytale server's Overview page.
Copy Server address
Server address is the allocated host:port. Click it or press Copy. Do not
assume the port is 5520 — berrybyte assigns the UDP port the server actually
uses.
On another host, the panel or welcome mail should show a host:port. For a self-hosted
server, use that machine's public IP with the UDP port from --bind. The
Hytale Server Manual
defaults that bind to 0.0.0.0:5520 if you did not change it.
Direct Connect, not Join via Code
Dedicated servers use Servers → Direct Connect. Paste host:port (for
example 203.0.113.10:5520, or whatever port your host allocated). You can
save or favorite that address so you do not retype it later.
Join via Code is a different path. Hypixel's Joining Friends guide is for friend-hosted worlds: the host opens the world to others and gets an expiring share code. Those codes are not issued by a dedicated server, and they stop working when they expire.
Launch Hytale and sign in
Start the game and finish client login before you open Servers.
Open Servers → Direct Connect
From the main menu, open Servers, then Direct Connect. If your build also offers a
save or favorite action on that screen, you can store the same host:port after you
confirm it works.
Paste host:port
Enter the full address in one field, including the port. Current berrybyte join copy refers to this as the connection address; match whatever label your client build shows.
Connect
Press Connect. Enter a password if the server asks for one. If a whitelist is on, your account must already be listed.
Skip Join via Code when someone sent you an IP or hostname. That control is for share
codes from friend-hosted worlds, not for a dedicated host:port.
Protocol and ports
Hytale uses QUIC over UDP. The official self-host default is port 5520. A hosted allocation can be a different UDP port, which is why Overview's full address matters.
Forwarding or allowing TCP on 5520 does not fix a join. The path that has to be open is UDP on the port the server bound. berrybyte opens that allocated UDP port for you.
Connection problems
The server is offline or still starting
Direct Connect cannot reach a server that is stopped. On berrybyte, check Overview and press Start if needed. Wait until the console has finished booting before you retry.
The server is not authenticated
Until Hytale Link succeeds, the dedicated server will not accept players. Complete Authenticate your Hytale server, then copy the address again.
Wrong address or port
Retype errors are common, especially if you assumed 5520. Copy Server address from
Overview (or your host panel) as a single host:port. A missing or stale port looks like
an unreachable server.
UDP or firewall block
QUIC is UDP-only. On a self-hosted box, allow and forward UDP on the bind port. TCP forwarding will not help. Symmetric NAT on a home host can still fail even when the rule looks right; the official manual calls that out.
Version or protocol mismatch
Client and server must share the exact protocol version. Update the Hytale client and the server to the same release patchline. A hash mismatch rejects the connection even when the address is correct.
Password or whitelist
A password prompt means the server is reachable but closed. If nothing happens or you are rejected without a password field, you may be missing from the whitelist. See Enable a Hytale whitelist and the server's password settings.
I cannot find it in Discovery or Join via Code
Expected for a private dedicated server. Friends join with Direct Connect. Public listing is optional and separate — see List a Hytale server on Server Discovery.
Related guides
Order or self-host a dedicated server, then grab the allocated address.
Authenticate the serverLink the server to a Hytale account so clients are allowed in.
Enable the whitelistLimit joins to approved accounts after the address is working.
Server DiscoveryOptional public listing. Private servers skip this and use Direct Connect.
Still stuck after the address, auth, and UDP checks? Open a support ticket with the server linked so staff can see its status. More Hytale pages live in the Hytale guides hub.
Frequently asked questions
What is my Hytale server IP and port?
Use the full host:port from the host panel. On berrybyte that is Server address on Overview. Do not assume port 5520; a hosted allocation can use a different UDP port.
Why doesn't Join via Code work on my dedicated server?
Join via Code is only for expiring share codes from friend-hosted worlds. Dedicated servers do not produce those codes. Use Servers, then Direct Connect, and paste host:port. You can save or favorite that address for later.
What port does Hytale use, and why doesn't TCP forwarding help?
Hytale speaks QUIC over UDP. The official self-host default is 5520. Opening or forwarding TCP on that number does not create a working game path. Allow UDP on the port the server actually bound.
Why do I get a version or protocol mismatch joining Hytale?
The client and dedicated server must be on the exact same protocol version. Update the game client and the server to the same release patchline, then try the address again.
I have the address. Why am I still blocked?
The server may be offline, still unauthenticated, using a different port than you typed, or enforcing a password or whitelist. Copy the address again, confirm Hytale Link finished, and check those access controls.