Tools / Hytale
Hytale Server Preflight
Paste the command you start your Hytale server with, and the folder you run it from. The preflight checks what stops a dedicated server starting or being reached: Java 25, the launcher's install folder that Update 7 refuses with exit code 11, the assets path, backups, the UDP port and authentication. It hands back a start command with the fixes applied.
Server stopped with exit code 11 after Update 7? It is running from, or saving into, the launcher's install folder, which every launcher update patches or wipes. Update 7 is still a pre-release, so today this hits pre-release servers; if it ships as it stands, it will hit every server started from there.
Checked in this tab. Nothing you paste is uploaded.
Want this on a real server? Supercraft hosts Hytale →
What it checks, and where each rule comes from
- Java 25. The server runs on Java 25, x64 or arm64, on a machine with at least 4 GB of memory. An older Java stops it immediately.
- The launcher's install folder. The launcher keeps the game in
%appdata%\Hytale\install\release\package\game\lateston Windows,$XDG_DATA_HOME/Hytale/install/release/package/game/lateston Linux and~/Library/Application Support/Hytale/install/release/package/game/lateston macOS. Since Update 7 the server will not write there: the working folder,--universe,--prefab-cacheand--backup-dirmust all be elsewhere, or it exits with code 11. - Assets. Without
--assetsthe server looks for..\HytaleAssets. The official scripts pass--assets ../Assets.zip. - Backups. Off unless you pass
--backup. The official scripts use--backup --backup-dir backups --backup-frequency 30. - The port. UDP 5520 unless
--bindsays otherwise. QUIC over UDP, never TCP, and never a loopback address for a public server. - Authentication. After the first start, type
/auth login devicein the console and approve the code at accounts.hytale.com/device. The code expires after 900 seconds. - Updates. The built-in updater only runs when the server starts from a
Server/folder whose parent holdsAssets.zipand the start scripts. An applied update exits with code 8, and only the scripts start it again.
Everything except exit code 11 is from Hypixel's own Hytale Server Manual; exit code 11 is from the Update 7 pre-release notes, summarised in our Update 7 guide.
Rather not run it yourself? Hytale server hosting keeps the server out of the launcher's folder, on Java 25, with backups on by default.
FAQ
Why does my Hytale server stop with exit code 11?
Since Update 7 the server refuses to start when what it writes would land inside the
launcher's install folder, which every launcher update patches or wipes. Copy the
Server folder and Assets.zip to a folder of your own and start
from there. --allow-install-dir switches the check off, at the risk of losing
the world on the next launcher update.
Which Java version does a Hytale server need?
Java 25. java --version should print openjdk 25; an older Java
fails at once with UnsupportedClassVersionError.
Which port does a Hytale server use?
UDP 5520 by default. Hytale uses QUIC over UDP, so forward and allow UDP; TCP forwarding is not needed, and a TCP port checker will call a working Hytale server closed.
Does a Hytale server back itself up?
Only with --backup. The official start scripts turn it on, every 30 minutes,
into backups. If your world is damaged, the
Hytale World Doctor scans and repairs its region files.
Is my command or folder uploaded?
No. The preflight runs in your browser. Nothing you paste is sent anywhere.