How to join a Hytale server: IP address, share code or server list
Want to play Hytale in multiplayer? This guide explains how to join a Hytale server, whether to play with your friends or to find a community. It covers the game's three methods: a share code, a direct connection with the Hytale IP address, and the server list.
Before you connect, check three things.
Hytale is installed and up to date. Download the official launcher from hytale.com. The game and server versions must be compatible.
Your Hytale account is verified and signed in through the official launcher.
Your internet connection is stable. Hytale talks over UDP, using the QUIC protocol.
Some community servers ask for an extra step, such as signing up on their website, accepting rules or being on a whitelist. Check before you join.
Join a friend with a share code
This is the most direct way to play with friends. The host runs the game from their own copy and generates a unique share code.
Host side
Start a game, on a new or existing world.
Press Escape to open the menu.
Click Share to generate a connection code.
Click Copy to Clipboard and send the code to your friends.
Player side
In the Hytale main menu, click Servers.
Select Join via Code.
Paste the share code you received.
If the host set a password, enter it.
Click Connect.
The share code contains the host's public IP address. Only give it to people you trust. The game sets up the host's router on its own, using UPnP.
Connect with an IP address
If you know a server's address, you can connect to it directly.
Launch Hytale and click Servers in the main menu.
Click Direct Connect at the bottom right of the screen.
Enter the server address followed by the port, for example
play.myserver.com:5520.Click Connect.
Hytale's default port is
5520, over UDP. If the server uses that port, you can try without it. Otherwise, the administrator will give it to you.
Add the server to your favorites
To avoid typing the address every time, save the server.
In the Servers menu, click Add Server.
Give the server a name and enter its address as
address:port.Click Add Server to save it.
The server now shows in your Favorites. Double-click it to connect.
Use a domain name
An administrator can point a domain name to their server. Hytale does not support SRV records yet, so you add the port after the domain, for example play.myserver.com:5520, unless the server uses the default port. The guide Configure a domain on Hytale server explains the setup.
Use the server list
Hytale has a built-in server browser in the main menu. It lets you find public servers and filter them by game mode, player count or ping.
In the main menu, click Servers.
Browse the list of available servers.
Filter by what you like, for example PvP, Survival or RP.
Select a server and click Connect.
The official list keeps changing with Hytale updates. Community sites such as hytale.game/serveurs also list servers.
Find your OuiHeberg server address
Is your Hytale server at OuiHeberg? Its address is shown in two places.
In the client area at dash.ouiheberg.com, open the server page under My services. The Connection address line gives the address, port included. It looks like
gmXX-dcXX.ouiheberg.com:port, or else the IP address followed by the port.In OuiPanel, the Global View shows the Main address and the Alternative address. The "Connection information" card in the Console gives the same details, under Encrypted IP and IP Alias.
This is the address you give your players.

Fix connection problems
| Problem | Possible cause | Fix |
|---|---|---|
| Connection refused | The server is offline or restarting | Wait a few minutes and try again |
| Timeout, no response | Wrong IP address or port | Check the address and port (5520 over UDP by default) |
| Incompatible version | The game and the server are not on the same version | Update Hytale from the launcher |
| Password required | The server is protected | Ask the administrator for the password |
| UPnP failed (share code) | The router does not support UPnP | Forward UDP port 5520 by hand on the host's router |
| Whitelist on | Access is restricted | Ask the server team for access |
Do I need to install mods to join a modded server?
No. Hytale loads the server's mods when you connect. In principle, there is nothing to set up on your side.
Need help?
Open a ticket from Tickets › Open a Ticket, or from the Contact support tile at the bottom of your server's page in the client area. You can also ask your question on the OuiHeberg Discord.
Hytale server hosting from $3.46/month, with CurseForge mods installed from the panel and DDoS protection included.
View plans →