List a Hytale server on Server Discovery (in-game server list)
List a Hytale server on the in-game Server Discovery list. Create a listing in Account Manager → Server Profiles, wait for Accepted, then run the link command from the card in Console. Servers offline over two minutes are hidden. Private servers can use Direct Connect.
To list a Hytale server on Server Discovery, create a listing in the Hytale
Account Manager under Server Profiles, wait until the card shows
Accepted, then paste the card's link command (/discovery link) into your
server's Console. The server needs to be
authenticated and stay online. If it
stops sending heartbeats for more than two minutes, the listing is hidden until
it's back.
Players browse name, description, type, audience, and region, then open a profile before they join. Discovery is optional. A private server can skip it and use Direct Connect.
A whitelist or password stays on when
the listing goes public. Commands can change between updates, and Chapter 1
(October 12) may change some, so if the link command isn't recognized, run
/help in Console and recheck after you
update your server.
List your server
Authenticate the dedicated server
Discovery doesn't replace /auth login device. On berrybyte, use the
Authenticate / Hytale Link flow in
How to authenticate a Hytale server.
Create the server card
In Server Profiles (on Hypixel's site, not the berrybyte dashboard), choose Create server. Write an accurate name and description. Set type (Survival, Adventure/RPG, Creative, PvP, Minigames, Roleplay, Social, Sandbox, or Other), audience (Everyone, Teen, or Mature), and the regions you serve.
Verify the domain (optional)
TXT verification proves you control the host on the card. You can list by IP and skip it, but you won't get the verification mark. Listings in Pending verification for over 30 days are removed.
Wait for moderation
Statuses are Pending verification, Under review, Accepted, Denied, and Paused. Denied cards include a reason. Fix the listing against the Server Operator Policies and resubmit.
Link the listing
After Accepted, the card shows the discovery token and the link command. Copy the command exactly and paste it into Console on the running server.
Keep the server online
The server pings the discovery service about every two minutes. If heartbeats stop for more than two minutes, the listing is hidden until the server is back. You don't have to unlist it by hand.
Treat the discovery token as a secret. It authenticates the heartbeat and reports your version and patchline. If Account Manager offers regenerate on the card, use it after a leak, then run the new link command.
If the link fails
On Update 6 and later, /discovery link says why a link failed. The token is
linked only after a successful heartbeat.
| Error | What to do |
|---|---|
| The token matches no listing | Copy the command from the card again |
| The server is signed in as a different game profile than the listing | Sign in with the game profile that owns the listing (/auth select picks a profile when you have more than one) |
| The discovery service is unreachable | Retry. The heartbeat has to succeed before the token links |
What the list shows
- Shows: name, description, and tags, plus custom listing images (Update 6). A missing or unapproved image falls back to the default. The in-game list hides server addresses by default.
- Doesn't show: a live player count or ratings.
- Limits: one listing per game profile. The in-game Discovery UI isn't available on parent-managed player accounts.
Listing rules
Listed servers take on extra duties under the Server Operator Policies: accurate operator contact, moderation coverage (24-hour response target for urgent safety reports where reasonably practicable), required public disclosures, a content baseline, accurate self-rating, and basic technical hygiene (supported versions, crash rate, patching). Violations can mean a warning, delisting, token or key suspension, or account-level action.
Older builds (Update 5)
Update 5 shipped the in-game browser, with the operator flow described in the official server lists notes. On Update 5, run the link command from the accepted card in Console or in chat as an OP. Listings were name, description, and tags only, with no custom icons, banners, or other rich media.
Update 6 added custom
listing images, hid server addresses by default, and gave /discovery link
distinct errors for a wrong token, game profile, or heartbeat.
Related guides
Frequently asked questions
How do I list a Hytale server on Server Discovery?
Sign in to the Hytale Account Manager, open Server Profiles, and create a listing with an accurate name, description, type, audience, and regions. When the card shows Accepted, paste its link command into the server Console. The server must keep sending heartbeats or the listing is hidden after two minutes.
Do I need Server Discovery to let friends join my Hytale server?
No. Discovery is the official public in-game list. Friends can join a private server with Direct Connect using the address. You still need to authenticate the dedicated server, but listing is optional.
What is a Hytale discovery token?
It's the secret on an accepted listing card that lets your server authenticate its heartbeat to the discovery service. Treat it like a password. Copy the link command from Account Manager exactly, and never paste the token into chat or a public ticket.
Why did my Hytale server disappear from Server Discovery?
If heartbeats stop for more than two minutes, the listing is hidden until the server is back online. A denied or paused card, a failed link, or a server signed in as a different game profile than the listing also keeps it off the list. Check the card status, then the Console output from the link command.
Can I show player counts or list more than one server on Server Discovery?
Not in the first version. Listings have no live player count or ratings, and you get one listing per game profile, so a second public server needs its own game profile.