Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

iTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more

Update a Hytale dedicated server with its staged updater: run /update check, download the release with /update download, review /update status, then run /update apply --confirm. The server exits with code 8; a correctly configured wrapper applies the staged files and starts the server again. Your configuration, worlds, saves and mods are intended to remain in place, but you should still make and verify a backup before maintenance.

How Hytale’s dedicated-server update works

The Hytale Server Manual updated October 12, 2026 describes a two-part process. The server application stages a release, while the launcher wrapper performs the file replacement during the next launch cycle. This separation is why applying an update is not the same as restarting a process from the console.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The normal sequence is:

  1. /update check asks whether a newer release is available.
  2. /update download downloads that release into staging.
  3. /update status lets you inspect what is staged.
  4. /update apply --confirm tells the server to shut down and hand the staged update to the wrapper.

After the apply command, the server exits with code 8. The wrapper recognizes that exit code, replaces the release files and launches the updated server. As the manual puts it, “The server does not restart itself.” If you start the Java server directly instead of through the wrapper, the process can stop after applying because nothing is watching for exit code 8.

Prepare before taking the server offline

1. Announce a maintenance window

Tell players when the server will close and give them time to disconnect cleanly. Stop scheduled events, allow active saves to finish, and avoid beginning an update while a world-changing operation is in progress. A short, planned outage is safer than terminating the process while players are writing data.

#1 Best Overall
Craft Hytale's 3D-Block Game
  • Polished core systems
  • Exploration
  • Flexible combat
  • Robust building

2. Confirm backups are enabled and usable

The documented default is RunBackupBeforeUpdate: true. The wrapper defaults also enable a backup before an update. Check the setting in your server configuration and confirm that the backup destination has enough free space. A setting is not a backup test: verify that a recent archive exists and that you know where the updater stores its backup directory.

For a high-value world, copy a backup outside the server installation as well. Keep the original world and configuration untouched until the new build has started successfully and players have completed a test connection.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

3. Check the runtime and hardware baseline

Hypixel Studios’ 2026 requirements specify at least 4 GB of memory and Java 25. Both x64 and arm64 systems are supported. Check the Java version used by the wrapper, not only the version installed for your interactive shell; services often point to a different executable. Leave headroom above the 4 GB minimum for the operating system, Java process, world size and mods.

4. Inventory extensions

The updater is designed to leave the mods/ directory intact, but an intact mod is not automatically a compatible mod. Record the enabled plugins and mods, their versions and any required dependencies. Check each project’s compatibility notes for the target server build before allowing players back in.

Run the staged update from the server console

  1. Put the server in maintenance. Broadcast the shutdown time, prevent new sessions if your operations routine supports it, and wait for players to leave.
  2. Verify the backup. Confirm RunBackupBeforeUpdate is enabled, check that storage is available and identify the latest backup.
  3. Check for a release. In the authenticated server console, enter /update check. If no update is offered, do not force one merely to repeat the operation.
  4. Download the release. Enter /update download. The files are placed in the updater’s staging area; the running binaries are not replaced at this point.
  5. Use the force option only deliberately. /update download --force is intended for an intentional redownload of the current release or for bootstrapping the update layout. It is not the routine command for every update.
  6. Inspect staging. Run /update status and confirm that the expected release is ready. If the status does not show a staged build, resolve that problem before applying anything.
  7. Apply the staged files. Enter /update apply --confirm. The server shuts down and returns exit code 8.
  8. Let the wrapper relaunch it. Keep the wrapper process running. It detects exit code 8, applies the staged release and starts the server with the updated files. Do not immediately start a second copy on the same port.
  9. Validate the result. Read the startup log, confirm the reported server build, check that the world list and permissions are present, and connect with a test client before ending maintenance.

Which files change and which data stays

The staged updater selectively replaces release components rather than treating the installation as a blank server. The expected installation contains an asset archive, a launcher and a server directory:

game/
  Assets.zip
  start.sh   (or start.bat)
  Server/
    HytaleServer.jar
    configuration files
    saves/
    mods/

Exact filenames inside the server directory can change between releases, so use the layout supplied with your installation. The important operational point is that the wrapper and the Server/ directory must remain in the relationship expected by the updater.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Item Updater behavior What you should verify
HytaleServer.jar Replaced with the staged server binary Startup log reports the intended build
Assets Release assets are updated, including the staged asset archive when supplied Server reaches a ready state without asset errors
Launcher wrapper Release wrapper scripts may be replaced Your service or scheduled task still invokes the new wrapper
Configuration Preserved by the staged update Port, authentication, permissions and custom settings remain correct
Worlds and saves Preserved by the staged update Worlds load and recent progress is present
mods/ Preserved Every extension supports the new server build

Preserved does not mean risk-free. A failed write, an incompatible extension or a damaged pre-existing save can still prevent startup, which is why the pre-update backup and post-update validation are part of the procedure.

Verify the updated server before reopening it

Read the first startup cycle

Watch the wrapper output and server log from launch through the ready message. Look for Java-version errors, missing assets, configuration parse failures, mod-loading exceptions and authentication errors. A process that stays running but repeatedly logs exceptions is not ready for players.

Rank #3
Sale
Wiggles 3D 5-Minute Dungeon A Chaotic, Co-Operative, Real-time Card Game | Fast-Paced Board Game | for Families, Ages 8 & up | 2-5 Players
  • 5-Minute Dungeon is the most fun you can have in 5 minutes! You'll need teamwork to defeat each dungeon in only 5 minutes, and then take on the next intense challenge. Defeat all 6 bosses to win!
  • Now with 25 more cards and the extra-challenging Dungeon Master: Final Form boss!
  • Featuring a free timer app for Android and Apple devices, with six different themed narrators!
  • Easy to learn, quick to teach: Match your cards to each symbol in the dungeon deck to win! 5-Minute Dungeon is perfect for teams of 2-5 players aged 8+.
  • Includes: 275 Cards, 5 Double-Sided Hero Mats (10 Heroes Total), 3 Double-Sided Boss Mats (6 Bosses Total)

Check the data players care about

  • Load each production world and confirm its expected name and recent progress.
  • Test an administrator account and a normal player account so permission changes are visible.
  • Check the configured port and query or status endpoint used by your monitoring.
  • Join with a client running the same protocol release as the server.
  • Exercise the most important modded features before declaring maintenance complete.

Keep the old backup until acceptance

Do not delete the updater backup immediately after a successful boot. Retain it until players have connected, saves have completed and you have checked the logs for a meaningful period. The backup is your fastest recovery path if a delayed mod error or world issue appears.

Protocol and client compatibility

Hytale requires the client and server to use exactly the same protocol version. A release that changes the protocol can therefore block every player who has not updated their client; changing firewall rules or port forwarding will not fix a protocol mismatch.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

When a player cannot connect after the update, compare the client’s displayed version with the server build and protocol in the startup information. If they differ, have the player update the game client or, when appropriate for your change-control plan, roll the server back to the version your player group is using. Do not loosen authentication or networking settings as a substitute for matching versions.

Automatic checks and manual approval

The default automatic check interval is 3,600 seconds, or one hour. Checking only discovers releases; it does not necessarily install them. AutoApplyMode is disabled by default, so an operator must confirm the apply operation manually. This default limits the chance that a protocol-changing release or incompatible mod will arrive during an active session.

Rank #4
How to Create a Hytale Server Hosting Guide
  • Easy to use interface that is designed for ease of creation
  • Interactive education for game server hosting creation
  • Provider listings for rental game servers for Hytale that match your criteria
  • Simple design to help you navigate the complexity of game server hosting
  • Further guides on how to join your server

You can change automation only after deciding how your service handles backups, maintenance notices, health checks and rollback. If you enable automatic application, keep the wrapper in charge of restarts and ensure your service manager does not launch a duplicate process when the wrapper exits and relaunches the server.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Troubleshoot an update that did not complete

The /update commands are unavailable

Confirm that the installation uses the expected game/ layout and that the server is launched from the Server/ directory with Assets.zip and the wrapper in the parent directory. A server launched from an unrelated working directory, or a bare Java command that bypasses the wrapper, may not expose the staged-update commands correctly. Correct the launch path, stop the stray process and start the supported wrapper before trying again.

The update downloaded but was not applied

Run /update status to confirm that a release is staged, then run /update apply --confirm. If the server stops and remains stopped, inspect how it was launched. The server process does not restart itself; the wrapper must remain active to see exit code 8 and perform the replacement. A system service configured to run only java -jar HytaleServer.jar will not provide that behavior unless you adapt it to invoke the wrapper.

The wrapper starts, but the new server crashes

Capture the first error in the startup log rather than repeatedly retrying. Check Java 25, available memory, asset integrity, configuration syntax and every mod or plugin. If the failure began immediately after the update, use the updater’s backup directory and follow the wrapper’s rollback instructions. Restore the backup, start the previously working build through its supported wrapper and keep the failed logs for diagnosis.

Players cannot connect

First compare client and server protocol versions. If they match, check that the server reached a ready state, the configured port is listening and the host firewall or provider network still exposes it. A protocol mismatch is an application-version problem, not a networking problem.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The world appears missing

Stop the server before making changes. Confirm that the wrapper started with the same working directory and configuration file used before the update, then inspect the world and save paths in configuration. Do not create a new world with the same name over the existing data. If the original save cannot be found or loads incorrectly, stop and restore the pre-update backup rather than experimenting on the only copy.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Self-hosting versus managed Hytale hosting

The command sequence is the same in principle, but responsibility differs. With self-hosting, you control the filesystem, wrapper, Java runtime, mods and rollback. With a managed provider, the control panel may expose one-click installation, scheduled backups and automatic updates while the provider operates networking, hardware and maintenance.

Concern Self-hosted server Managed server
Files and mods Full access; you must preserve the layout and test extensions Access depends on the provider’s file manager, SFTP and mod policy
Backups and rollback You configure storage, retention and restore procedures The provider may automate backups, but you should verify export and restore options
Update automation You run the wrapper and choose when to apply releases Many panels offer one-click or automatic updates; confirm whether approval is available
Uptime and maintenance You handle hardware, operating-system patches, monitoring and recovery The provider handles infrastructure and usually offers support
Console and logs Direct access to process output and files Access varies by panel and plan
Recurring cost Your hardware, power, storage and administration are the cost centers A recurring hosting charge replaces much of the infrastructure work

Official Hytale support identifies Nitrado, Apex Hosting, GPORTAL, Shockbyte and Dathost as Launch Verified providers. Their exact features, pricing and verification status can change, so confirm the current offering before moving a production world. Regardless of provider, ask where backups are stored, how to download them, whether automatic updates can be paused and how to access logs after a failed restart.

Operational limits worth recording

  • The documented minimum is 4 GB of memory with Java 25; treat it as a floor, not a performance target.
  • x64 and arm64 are supported architectures.
  • The default update-check interval is 3,600 seconds.
  • RunBackupBeforeUpdate is enabled by default.
  • AutoApplyMode is disabled by default and requires confirmation.
  • Authenticated server use is limited to 500 servers per Hytale game license.
  • The documented game-session lifetime for provider authentication is one hour.

The last two limits concern licensing and authentication behavior, not the mechanics of replacing files. Account for them when designing a fleet or a managed-service integration, and consult the current manual if your deployment model depends on those limits.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

A repeatable maintenance checklist

  • Announce the window and wait for clean player disconnects.
  • Confirm a recent, restorable backup and free storage.
  • Check Java 25, memory headroom and wrapper permissions.
  • Review mod and plugin compatibility for the target release.
  • Run /update check.
  • Run /update download; reserve --force for an intentional redownload or layout bootstrap.
  • Run /update status.
  • Run /update apply --confirm.
  • Wait for the wrapper to handle exit code 8 and relaunch the server.
  • Read logs, test worlds and permissions, and connect with a matching client protocol.
  • Keep the backup until the updated server has passed real player traffic.

Following this workflow updates the release files without deliberately replacing your worlds or configuration, while preserving a clear rollback path when a build, protocol or extension is not ready for production.

Quick Recap

Bestseller No. 1
Craft Hytale's 3D-Block Game
Craft Hytale's 3D-Block Game
Polished core systems; Exploration; Flexible combat; Robust building
Bestseller No. 2
SaleBestseller No. 3
Bestseller No. 4
How to Create a Hytale Server Hosting Guide
How to Create a Hytale Server Hosting Guide
Easy to use interface that is designed for ease of creation; Interactive education for game server hosting creation

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.