Skip to content

How to Upload a Singleplayer World to Your Hytale Server ​

You can transfer your singleplayer world to your server and continue playing with friends.

How to Find Your World Files ​

Method 1: Via Hytale ​

  1. Open Hytale
    Open Hytale and go to "Worlds".

  2. Open Folder
    Right-click on your world and select "Open Folder".

  3. Copy World Folder
    Navigate to universe/worlds/ - here you'll find your world folders. Copy the desired world folder.

Method 2: Manually ​

You can find your Hytale save files here:

Operating SystemPath
Windows%appdata%\Hytale\Saves
Linux$XDG_DATA_HOME/Hytale/Saves
macOS~/Application Support/Hytale/Saves

Navigate to universe/worlds/ within your save to find the world folders.

How to Upload the World ​

Note

Stop your server before uploading files, otherwise they will be overwritten by the server.

  1. Stop the Server
    Stop your server via the management panel.

  2. Connect via SFTP
    Connect to your server via SFTP.

  3. Upload World Folder
    Upload the copied world folder to the following directory:

    /universe/worlds/
    /universe/worlds/
  4. Start the Server
    Start your server.

How to Activate the World ​

After uploading, you need to load the world and set it as default.

Via Console ​

  1. Load the World
    Enter the following command in the console:

    world load <worldname>
    world load <worldname>

    Replace <worldname> with the name of the uploaded folder.

  2. Set as Default
    To make players automatically spawn in this world when joining:

    world setdefault <worldname>
    world setdefault <worldname>

Note

Console commands are entered without /. In-game with admin rights, you need the / (e.g., /world load <worldname>).

Via Configuration ​

You can also set the default world manually in the server configuration:

  1. Stop the Server
    Stop your server via the management panel.

  2. Open config.json
    Open the config.json in the root directory of your server.

  3. Change Default World
    Find the Defaults block and change the World value:

    json
    "Defaults": {
      "World": "myworld",
      "GameMode": "Adventure"
    }
    "Defaults": {
      "World": "myworld",
      "GameMode": "Adventure"
    }
  4. Start the Server
    Start your server.

Transfer Player Data ​

If you also want to transfer your player progress (inventory, position, etc.):

  1. Copy the contents of the players/ folder from your singleplayer save.
  2. Upload it to the players/ folder on the server.

Warning

Only upload the world folders, not the entire universe/ folder - otherwise existing server worlds will be overwritten.