Skip to main content

How to Upload a Custom Hytale World?

Universe vs. Single World​

Game saves in Hytale are divided into two levels:

  • Universe: Contains a complete save of the game state, including all associated worlds, dimensions, as well as full player data and progress.
  • Single World: Consists solely of the map/terrain geometry file itself. It does not contain any data about players or their inventories.

If you are transferring your existing single-player progress to the server, you need to upload the entire universe. If you only want to add a clean map found online, you upload a single world.

How to Find Your Local Save Game (Singleplayer)​

Before starting the transfer, you must locate the save files on your computer.

  1. Open the official Hytale launcher.
  2. Click the settings icon (gear).
  3. Click the Open directory button.
  1. Navigate to the UserData folder, then enter the saves directory.
  2. Each folder located there corresponds to one of your single-player worlds. Inside each of them is a subfolder named universe.

Method 1: Uploading the Entire Universe (Retaining Progress)​

This method overwrites the current server state and uploads your private save along with your progress.

  1. Stop the server in the Console tab.
  2. Connect to your server via the SFTP protocol.
  3. In the server file manager, locate and delete the current universe directory located in the server's root folder.
  4. Upload the universe folder from your computer along with all of its contents.
  5. Restart the server in the Console tab.

Method 2: Uploading a Single World​

This method allows you to replace just the map for a specific world without deleting the global universe data.

  1. Stop the server in the Console tab.
  2. Connect to the server via SFTP.
  3. Navigate to the path universe/worlds/.
  4. The default folder contains your main map. If you want to replace it, enter it and delete all of its contents.
  5. Copy the contents of your local world folder and upload it directly to the clean default directory on the server.
  6. Restart the server.

Adding Additional Worlds to the Server​

The Hytale engine supports managing multiple maps simultaneously from the command line.

  1. Go to the Console tab.
  2. Enter the command to create a new, clean world: worlds add [name] (for example, worlds add survival).
  3. Once the command is processed, the engine will create a new folder in the path universe/worlds/[name].
  4. If you want to upload a custom map there from your computer, turn off the server and replace the contents of this new folder using an SFTP connection.