Hi Hytaler,
short answer: since the Update 8 pre-release (part 5, Nov 19) a Hytale server can be reached by hostname alone. You add a DNS SRV record called
Right now this is pre-release only. Players need a client that has part 5 or newer, so for most people it starts working when Update 8 goes live. You can set the record up today though, it doesn't hurt anything.
From the official notes:
If you run on 5520 anyway, a normal A record is enough. Players type the hostname and the client uses 5520.
You need two things in your DNS:
In zone file style:
The players then type
Want it on your main domain (
Linux / Mac:
Windows:
If that shows your port and host, the DNS part is done. If not, wait for the TTL or check the name for the double domain problem above.
The server side doesn't change at all. It still listens on its port, you still forward that port as UDP in your firewall and router.
Part 5 also changed some things that help when players can't connect:
What the notes don't say: how the client handles several SRV records with different priority or weight. So for now I'd stick to one SRV record per name.
If you set it up and it works (or doesn't), post your result below. And if you still need a start script or firewall rules, the server setup generator does that for you
- BitaceS
short answer: since the Update 8 pre-release (part 5, Nov 19) a Hytale server can be reached by hostname alone. You add a DNS SRV record called
_hytale._udp and the client finds your port on its own. Players type play.example.com, not play.example.com:24000.Right now this is pre-release only. Players need a client that has part 5 or newer, so for most people it starts working when Update 8 goes live. You can set the record up today though, it doesn't hurt anything.
From the official notes:
Hytale patch notes said:Servers can now be reached by hostname alone through a_hytale._udpSRV record. When a player enters an address without a port, the client follows that record, so a server can use a custom port without players typing it.
When you need it
- Your server does not run on the default port UDP 5520. For example you have two servers on one box, or your host gave you a random port.
- You want a clean address for your Discord, your server list entry or your website.
If you run on 5520 anyway, a normal A record is enough. Players type the hostname and the client uses 5520.
The record
You need two things in your DNS:
- An A record (and AAAA if you have IPv6) for a hostname that points to the server's IP, for example
node1.example.com → 203.0.113.10 - The SRV record that says "Hytale for this name runs on that host, on that port"
| Field | Value | Note |
|---|---|---|
| Name | _hytale._udp.play | full name: _hytale._udp.play.example.com |
| Priority | 0 | |
| Weight | 5 | |
| Port | 24000 | your real server port |
| Target | node1.example.com | a hostname with an A record, not an IP |
| TTL | 3600 | lower it while you test |
In zone file style:
Code:
node1.example.com. IN A 203.0.113.10
_hytale._udp.play.example.com. IN SRV 0 5 24000 node1.example.com.
The players then type
play.example.com. Notice that play.example.com itself doesn't need an A record for this. The client asks for the SRV record of the name they typed.Want it on your main domain (
example.com without play.)? Then the SRV name is just _hytale._udp (the root of your zone).Things that go wrong a lot
- Target is an IP. SRV targets have to be hostnames. Make an A record and point to that.
- Target is a CNAME. Also not allowed by the DNS standard. Point to a name with a real A/AAAA record.
_tcpinstead of_udp. Hytale runs QUIC over UDP, so it's_udp. Same reason you forward UDP and not TCP, see can't connect.- Your DNS panel adds the domain twice. Many panels want only
_hytale._udp.playin the name field and add.example.comthemselves. If you type the full name you end up with_hytale._udp.play.example.com.example.com. Check with the command below. - Port in the address. If a player types
play.example.com:24000, the client uses that port directly. The SRV record is only used when there is no port in the address. - Proxy on. If your DNS provider has a proxy or "orange cloud" option, the A record of the target has to be DNS only. A web proxy doesn't forward game traffic.
Check it
Linux / Mac:
Code:
dig +short SRV _hytale._udp.play.example.com
# 0 5 24000 node1.example.com.
dig +short A node1.example.com
# 203.0.113.10
Windows:
Code:
nslookup -type=SRV _hytale._udp.play.example.com
If that shows your port and host, the DNS part is done. If not, wait for the TTL or check the name for the double domain problem above.
The server side doesn't change at all. It still listens on its port, you still forward that port as UDP in your firewall and router.
Other connect fixes in the same part
Part 5 also changed some things that help when players can't connect:
- If a server's first address doesn't respond, the client tries the next one after about 5 seconds instead of 20
- If looking up the address takes too long, the error now says so, instead of "server could not be found"
- Fixed connecting to servers that transfer players to (or fall back to) a port above 32767
What the notes don't say: how the client handles several SRV records with different priority or weight. So for now I'd stick to one SRV record per name.
If you set it up and it works (or doesn't), post your result below. And if you still need a start script or firewall rules, the server setup generator does that for you
- BitaceS