Hytale server problems

Hytale is new and its server software changes often, so details here can change. See Hytale settings.

Authentication or account linking error

Why it happens: By default (Auth Mode set to authenticated) a Hytale server must be authorised with a Hytale account. Errors usually mean this has not been done or has expired.

How to fix it:

1. Read the Console for a login link and code. Hytale’s server manual describes running /auth login device in the Console, opening the link it prints, and entering the code (the code expires after a few minutes, so run it again if it does).
2. Finish the login with your Hytale account.
3. Leave Auth Mode (HYTALE_AUTH_MODE) on Startup alone unless support tells you to change it.
4. If you cannot finish authorising, open a ticket.

Players cannot connect, authentication or session errors

Why it happens: The player or the server failed the account check. Hytale’s manual says servers must be authenticated before players can join.

How to fix it:

1. Ask the player to restart the launcher and log in again.
2. Restart the server and re-check the Console.
3. If it continues for everyone, open a ticket.

Server is not visible

Why it happens: Hytale’s official server manual lists server discovery as a future addition, so join by address instead of expecting to find the server in a list.

How to fix it:

1. Wait for Online.
2. Use the address and port from Network. See Network and ports.
3. Check the game’s update state and that players are on the same version.
4. See Can’t connect to any game server.

Cannot connect, timed out

Why it happens: A wrong address or port makes the connection time out.

How to fix it: Use the exact port on Network, and open a ticket if it still times out so we can check the port setup.

Version mismatch

Why it happens: The game client and the server are on different builds. Patchline (HYTALE_PATCHLINE) selects the branch, release by default.

How to fix it:

1. Check players are on the same patchline as the server.
2. Restart the server so it updates.
3. If you switched patchline, you may need to reinstall: Settings > Danger Zone > Reinstall Server. Back up first, see Backups.

Server runs out of memory

Why it happens: Hytale’s server is a Java program. Its manual says view distance is the main driver of memory use, and players and mods add to it.

How to fix it: Watch the memory graph on the Console and, if you can change it in the game’s server settings, lower the view distance. See Out of memory. Then consider Upgrade.

Server crashes after adding a mod or plugin

Why it happens: Hytale mods are new, and can break on updates.

How to fix it:

1. Remove the newest one from the mods folder in Files and restart.
2. Check the mod author’s notes for the current game version.
3. Accept Early Plugins (HYTALE_ACCEPT_EARLY_PLUGINS): Hytale warns early plugins are unsupported and may cause instability. Only enable it if you accept this.
4. We cannot promise any mod works.

“Early plugins” warning stops start

Why it happens: Hytale warns that early plugins are unsupported, and the server may need this accepted.

How to fix it: Set HYTALE_ACCEPT_EARLY_PLUGINS to 1 on Startup if you understand the risk, or remove the plugin.

I cannot use operator commands

Why it happens: Allow operators (HYTALE_ALLOW_OP) is off by default.

How to fix it: Set it to 1 on Startup, restart, then use the game’s op command from the Console.

Server browser or A2S query tools cannot see my server

Why it happens: The Source Query plugin answers A2S queries when enabled.

How to fix it:

1. Check Install Source Query plugin (INSTALL_SOURCEQUERY_PLUGIN) is 1.
2. Source Query Port (QUERY_PORT) should differ from the game port. If left blank it is game port plus one.
3. If the query port is not reachable, open a ticket.

Boot is slow

Why it happens: Hytale’s manual says the server ships with an ahead-of-time (AOT) cache that improves boot time by skipping JIT warmup.

How to fix it: Keep Use Ahead-of-Time Cache (USE_AOT_CACHE) on. If start still fails, open a ticket.

Server broke after a game update

Why it happens: Game updates can change formats and break worlds or mods.

How to fix it:

1. Make a backup before updating. See Backups.
2. Remove mods, restart, and add them back one by one.
3. Restore a backup if needed.

Still stuck?

Open a ticket or ask on Discord. See Contact support.