Upload Singleplayer World on Hytale Server

Introduction

Hytale offers vast, procedurally generated universes that can represent hundreds of hours of exploration and building. If you have started an adventure in singleplayer and want to transition that progress to a HumbleServers Hytale node to play with friends, you can do so by migrating your world files.

Hytale handles world data within “Universes.” While the structure differs from Minecraft, the migration process is highly reliable when using an SFTP client like WinSCP.

Step 1: Locate Your Singleplayer World Files

Before you can upload your world, you need to find where Hytale stores your local save data on your computer.

1. Open your Hytale Launcher.
2. Navigate to the Settings or Data tab.
3. Click on “Open Worlds Directory”. Alternatively, you can manually navigate to: %appdata%/Hytale/Saved/Worlds/
4. Inside this folder, identify the sub-folder named after the Universe you want to move. Keep this window open for later.

Step 2: Prepare WinSCP and Stop Your Server

To move entire folders, this guide uses SFTP. You can also upload whole folders of any size on the Files page in the client area.

1. Download WinSCP: If you haven’t already, download and install WinSCP.
2. Stop Your Server: Open your server in the HumbleServers client area , go to the Console, and click Stop. Never upload world files while the server is “Running.”

Step 3: Connect via SFTP

1. On your server’s page, open Files and click the SFTP button.
2. Find your SFTP Details (Server Address and Username).
3. Open WinSCP and enter these details:
   • File Protocol: SFTP
   • Host Name: Your Server Address
   • User name: Your SFTP Username
   • Password: Your SFTP password (set one with Set SFTP password in the same dialog)
4. Click Login.

Step 4: Upload the Universe Folder

1. In the right-hand panel of WinSCP (the server side), navigate to: Saved/Worlds/
2. In the left-hand panel (your computer), navigate to the Hytale worlds directory you found in Step 1.
3. Drag and drop your specific Universe folder from the left side to the right side.
4. Wait for the transfer to complete. WinSCP will handle all the sub-folders automatically.

Step 5: Configure the Server to Load the World

Hytale servers need to be explicitly told which Universe ID to boot into.

1. Go to the Settings page in your server’s sidebar.
2. Find the variable labeled World Name or Universe ID.
3. Enter the exact name of the folder you just uploaded (e.g., MyAdventureUniverse).
4. Check that the Level Name variable matches the internal world name (usually default).

Step 6: Start and Verify

1. Return to the Console and click Start.
2. Monitor the startup logs. You are looking for a line that says “Universe Loaded Successfully” or “Starting World.”
3. Once the server is “Running,” you and your friends can join your migrated world!