Hytale Guides

Guide

How to Backup Your Hytale World Saves

How to Backup Your Hytale World Saves

Hytale world saves are stored locally on your computer for single-player games and on your server for multiplayer, making regular backups essential to prevent data loss from corruption, hardware failure, or accidental deletion. While Hytale features automatic internal backups, understanding how to manually back up and restore your worlds provides the ultimate safeguard for your creations and progress.

Why Back Up Your Hytale World?

Your Hytale world represents countless hours of exploration, building, and adventure. Losing this data due to unforeseen circumstances can be incredibly frustrating. Backing up your world saves ensures that you always have a recoverable version, protecting you from:

  • File Corruption: Unexpected game crashes or system errors can sometimes corrupt save files.
  • Hardware Failure: Hard drive malfunctions can lead to permanent data loss.
  • Accidental Deletion: Mistakes happen, and a backup can reverse an accidental deletion.
  • Game Updates: While rare, major game updates can sometimes affect world compatibility, making a pre-update backup valuable.
  • Mod Conflicts: If you experiment with mods, a backup allows you to revert your world if a mod causes issues.

Understanding Hytale World Save Locations

Hytale organizes its save data in specific directories on your system. For single-player games, this data is within your user profile. For dedicated servers, it resides in the server’s installation directory. The core of your world data is typically found within a universe/ folder, which contains all map chunks, player data, and world-specific information. The game also generates periodic backup archives (ZIP files) of your worlds, usually every 30 minutes, stored within a dedicated backup subfolder for each world.

How to Backup Your Hytale Single-Player World Saves

Manually backing up your single-player world is a straightforward process of copying specific folders to a safe location.

Step-by-Step: Manual Single-Player World Backup

  1. Close Hytale Completely:

    Before attempting any file operations on your world saves, ensure the Hytale game client is fully closed. Modifying files while the game is running can lead to corrupted saves or incomplete backups.

  2. Locate Your Hytale Save Folder:

    The location of your Hytale save files varies slightly depending on your operating system:

    • Windows: Press the Win + R keys to open the Run dialog. Type %appdata%\Hytale\UserData\Saves\ and press Enter. This will open the folder directly.
    • Linux: Navigate to ~/.local/share/Hytale/UserData/Saves/ or, if defined, $XDG_DATA_HOME/Hytale/UserData/Saves/.
    • macOS: Navigate to ~/Library/Application Support/Hytale/UserData/Saves/.

    Alternatively: You can often find a shortcut to your Hytale data directory through the Hytale launcher. Look for a “Settings” or “Options” menu, and there might be an “Open Directory” or “Show Game Files” option. From there, navigate into UserData, then Saves.

  3. Identify Your World Folder:

    Inside the Saves folder, you will see several subfolders. Each of these typically represents a single Hytale world you have created or played. They are often named according to your world’s in-game name or a unique identifier.

  4. Copy the Entire World Folder:

    Select the entire folder corresponding to the world you wish to back up. Copy this folder and paste it into a secure, separate location. This could be an external hard drive, a USB stick, a cloud storage service (like Google Drive, Dropbox, or OneDrive), or another drive on your computer. It’s good practice to rename the copied folder with a date (e.g., MyWorldName_2023-10-27) for easier version tracking.

Step-by-Step: Restoring From Hytale’s Internal Backups (Single-Player)

Hytale automatically creates periodic ZIP archives of your world. These can be used to revert your world to an earlier state.

  1. Close Hytale:

    Ensure the game is not running to prevent conflicts or data corruption during the restoration process.

  2. Navigate to Your Specific World’s Folder:

    Follow the steps outlined above (Step 2 in “Manual Single-Player World Backup”) to reach your Saves folder, then open the specific world folder you want to restore (e.g., %appdata%\Hytale\UserData\Saves\[Your World's Name]\).

  3. Access the backup Folder:

    Inside your chosen world’s folder, you will find a subfolder named backup. Open this folder.

  4. Choose a Backup Archive:

    The backup folder contains several ZIP files, each timestamped. These are your automatic world backups. Select the ZIP file that corresponds to the date and time you wish to restore your world to. It’s often best to pick the most recent one that you know was working correctly.

  5. Go to the universe Folder:

    Navigate back to your world’s main folder (the parent of the backup folder). Inside this main world folder, locate and open the universe folder. This folder contains the active data for your world.

  6. Replace Existing World Data:

    Important: Delete all existing files and subfolders *inside* the universe folder. Then, copy the chosen ZIP backup file from the backup folder into this now-empty universe folder. Right-click the ZIP file and choose to “Extract Here” or “Extract to current folder,” ensuring its contents are placed directly into the universe folder, not within a new subfolder.

  7. Launch Hytale:

    Start Hytale. Your world should now load from the state saved in the restored backup archive.

How to Backup Your Hytale Dedicated Server World Saves

For dedicated servers, the process involves accessing the server’s file system, typically via a control panel or SFTP.

Step-by-Step: Manual Dedicated Server World Backup

  1. Shut Down the Server:

    It is absolutely critical to stop your Hytale dedicated server completely before attempting to back up or modify any of its files. This prevents file corruption and ensures a consistent backup.

  2. Access Server Files:

    Connect to your server’s file system. If you use a hosting provider, they usually offer a web-based File Manager in your control panel. Alternatively, you might use an SFTP (SSH File Transfer Protocol) client like FileZilla to connect directly to your server.

  3. Download World Data:

    Navigate to the main directory where your Hytale server is installed. Locate the universe/ folder. This folder contains all the essential world data, including map chunks, player inventories, and bases. Download this entire universe/ folder to your local machine.

  4. Download Mods (If Applicable):

    If your server uses any modifications, you must also locate and download the mods/ folder. World saves are often dependent on the specific mods that were active when they were created, and restoring a world without its corresponding mods can lead to errors or crashes.

  5. Store Safely:

    Save these downloaded folders (universe/ and mods/) to a secure, organized location on your computer or an external backup solution.

  6. Server-Side Backup Commands (Optional):

    Server administrators can use built-in server commands to trigger backups. The /backup command can initiate an immediate backup. For automated backups, you can configure server startup arguments such as --backup, --backup-directory <Path>, and --backup-frequency <Integer> (where frequency is in minutes) to have the server automatically create backups at specified intervals.

Step-by-Step: Restoring a Dedicated Server Backup

  1. Shut Down the Server:

    As with backing up, ensure the Hytale server process is completely stopped before any file manipulation.

  2. Access Server Files:

    Use your server panel’s File Manager or an SFTP client to connect to your server.

  3. Prepare for Upload:

    Navigate to your server’s main directory. Locate the existing universe/ folder. You should either delete this folder (if you’re certain you want to replace it) or rename it (e.g., to universe_old) as a temporary safeguard. This prevents conflicts when uploading your backup.

  4. Upload Backup:

    Upload your backed-up universe/ folder from your local machine to the server’s main directory. Ensure the uploaded folder is named exactly universe (all lowercase) and is placed directly in the server’s root, not nested within another folder.

  5. Restore Mods (If Applicable):

    If your backup included a mods/ folder, ensure that the exact versions of those mods are present in the server’s mods/ folder. If you’re restoring an older backup, you might need to replace the current mods/ folder with the one from your backup to maintain compatibility.

  6. Restart the Server:

    Once the files are uploaded and correctly placed, start your Hytale dedicated server. It should now load the world from your restored backup.

Tips for Effective Hytale World Backups

  • Backup Regularly: Make backups frequently, especially before major game updates, installing new mods, or embarking on significant building projects.
  • Utilize Cloud Storage: Copy your backups to cloud services (Google Drive, Dropbox, OneDrive) for off-site redundancy. This protects your data even if your local computer suffers catastrophic failure.
  • Consider Third-Party Tools: Explore community-developed tools if available. For example, tools like “Hytale World Exporter” (if developed) might simplify management and provide ZIP export/import functionality, or “SaveSync” (if developed) could aid in co-op save sharing without a dedicated server. Always exercise caution and verify the safety of third-party tools.
  • Implement Version Control: Instead of overwriting the same backup file each time, keep multiple dated backup versions. This allows you to revert to various older states if a recent backup turns out to be corrupted or undesirable.

Common Mistakes to Avoid When Backing Up Hytale Worlds

  • Not Closing the Game/Server: Attempting to copy or modify save files while Hytale (client or server) is running is a primary cause of corrupted or incomplete backups. Always shut down first.
  • Incorrect Server Folder Structure: When restoring server backups, ensure the universe folder is placed directly in the server’s root directory. A common error is nesting it (e.g., server_root/universe/universe/data), which will cause the server to generate a brand new world.
  • Forgetting Mods for Server Backups: If your server uses mods, always back up and restore the mods/ folder along with the universe/ folder. Without the correct mods, your world might load incorrectly, display errors, or crash.
  • Replacing Server Files While Running: Never attempt to delete, upload, or replace server files while the server process is active. This can lead to irreversible data corruption and server instability.
  • Improper Internal Backup Restoration: When restoring from Hytale’s internal ZIP backups, ensure you extract the contents *directly* into the universe folder after deleting its previous contents, rather than extracting it into a subfolder within universe.