How to Back Up and Restore a Hytale Server

The irreplaceable part of a Hytale server is the data below Server/universe. Back up that directory together with the server config, permissions, whitelist, bans and mods. Use Hytale's built-in periodic backups for quick recovery, then copy regular snapshots to another machine or storage provider.

Adventurers crossing a stone bridge toward a luminous fantasy ruin

Run a managed Hytale world with automatic backups and full file access

What belongs in a Hytale backup

Server/universe: worlds and player save data. The playable worlds are below universe/worlds.
Server/config.json: top-level server settings and update policy.
Server/permissions.json, whitelist.json and bans.json: access and moderation state.
Server/mods: the .jar and .zip content the world expects.
Device-auth credential files, if this is a personal self-hosted server. Treat them as secrets and never put them in a public or shared archive.

The server JAR and Assets.zip are replaceable official downloads. Keep their version recorded, but prioritize the world and configuration data that the downloader cannot recreate.

Enable Hytale's built-in backups

The official launcher starts the server with backup support enabled:

--backup --backup-dir backups --backup-frequency 30

That default takes a backup every 30 minutes while the server runs. You can change the directory and interval with the same command-line options. Keep enough free disk for several generations and inspect the backup directory after the first interval instead of assuming the flag worked.

Take a clean manual snapshot

Periodic copies are useful, but take a deliberate snapshot before an update, mod change, world edit or migration:

Tell players the save window is starting and stop new joins.
Stop the server cleanly so no world file is changing during the copy.
Archive universe, config, permissions, whitelist, bans and mods as one dated set.
Start the server again and confirm the intended world loads.
Copy the archive off the game host and verify that it can be opened.

Do not copy a live universe piecemeal. A set assembled while chunks and player data are still being written can contain files from different moments.

Use more than one retention layer

A simple policy for a small community is several frequent local backups, daily off-host copies for the last week, and a few weekly copies. Keep an extra snapshot before every Hytale update or mod-set change. Retention matters because corruption or a mistaken edit may go unnoticed until the newest backup already contains it.

Restore without destroying the current evidence

Stop Hytale first. Move the current universe and configuration set to a dated quarantine location rather than deleting it. Restore the chosen backup into the same paths, fix ownership for the service account, and start on the current compatible server build. Keeping the failed state makes it possible to recover a newer file later or diagnose what went wrong.

Restore the matching mod set with the world. If a backup predates a Hytale protocol update, update the official binaries and Assets.zip separately instead of replacing the current runtime with an old download.

Verify the restore

Confirm the server starts on Java 25 and binds its expected UDP port.
Join the correct default world with a current client.
Inspect player data, important builds and recently changed regions.
Check permissions, whitelist and bans.
Read the startup log for missing or incompatible mods.
Create a fresh backup after the restored server has run cleanly.

Backups before Hytale updates

Hytale's Update config has separate switches for a full pre-update backup and a config-file backup. Keep both enabled. The official launcher also preserves the previous update files under updater/backup for binary rollback, but that update copy does not replace a regular off-host world-backup policy.

Managed Hytale backups

A GHosting Hytale server runs the official periodic backup flags and exposes the standard Server directory through Files and SFTP. That gives the owner both quick local recovery and a path to download independent copies before updates or major world changes.

Hypixel Studios documents the backup flags and the universe file structure in the official Hytale Server Manual.