How to update a Hytale server
Hytale updates every 2 to 6 weeks, and after each one your server falls behind the client until you update it — that mismatch is the top cause of "failed to connect" errors during patch weeks. The update itself is a file swap: download the new build, replace two things, start it back up.
Before you start: check what you're running
Start your server and run /version (or read the console output at boot — it prints the build). Compare that against the current build on the update tracker. If they match, you're done; if not, continue.
Step 1 — Download the new server files
- Open the Hytale site and use the Download Hytale button — it downloads the installer.
- Run the installer; it shows a link to authenticate. Open it, log into your account, and authorize the device.
- The downloader then fetches the most recent server version as a zip file (a
Serverfolder and anAssets.zip).
You want the server package, not the game client — if what you got launches a game instead of a console window, you picked the client download. Background on the server software itself is on the server jar page.
Step 2 — Swap the files into your server directory
- Back up your world first. The update only replaces engine files, but a backup turns any mistake from a disaster into an inconvenience — skipping it is the most common start of a failed-to-boot problem.
- Open your existing server directory and delete the old
Assets.zipandServerfolder. Your world data and configuration are not in these — they live elsewhere in the directory and stay untouched. - Extract the zip you just downloaded, and drag the new
Serverfolder andAssets.zipinto your server directory.
Step 3 — Start it and verify
Start the server the same way you always do. When it's up, run /version again — it should now report the current build. Connect once yourself before telling players the server is back, and if a friend still can't join, check the version on their client too; a player on a newer client than the server gets the same connection error.
Two things that change this workflow
- Rented hosting. If you pay for a hosting provider, they usually update the server for you or offer a one-click update — you don't do any of this manually. That service is part of what the monthly fee pays for.
- Pre-release channel. The launcher can opt your server into pre-release builds (weekly patches before they are stable). Useful for testing a mod or map against the next update; not recommended for a public server, because pre-release builds are unfinished by definition.
- Breaking changes, and how to survive them. Rapid Early Access updates can break server mods — a server full of mods can crash on update day. The studio's stated policy: a proper deprecation process is coming so mods stop breaking without warning, and in the meantime mod authors should prepare their mods against the final pre-release build of each update, which is what the stable release ships from.
Why this matters more in Hytale than in some games
Hytale's patch pace is fast — weekly pre-releases, a stable bundle every 2 to 6 weeks. Every stable update puts every un-updated server one version behind, and the client refuses mismatches rather than degrading. Treat "update the server" as a scheduled task after each release, not an emergency task after the first player complains. The rhythm and each update's contents are on the update tracker.
Related pages
- How to host a Hytale server — the first-time setup this page assumes you already did.
- Server guide — the hub for all server topics.
- Failed to connect — what players see when this update didn't happen.