Hytale Practical Wiki

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.

Last checked: September 2026Early Access

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

  1. Open the Hytale site and use the Download Hytale button — it downloads the installer.
  2. Run the installer; it shows a link to authenticate. Open it, log into your account, and authorize the device.
  3. The downloader then fetches the most recent server version as a zip file (a Server folder and an Assets.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

  1. 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.
  2. Open your existing server directory and delete the old Assets.zip and Server folder. Your world data and configuration are not in these — they live elsewhere in the directory and stay untouched.
  3. Extract the zip you just downloaded, and drag the new Server folder and Assets.zip into 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.

Spotted an error, or a patch changed something this page relies on? Report it on this page.