How to Upload a World to Your Hytale Server

How to Upload a Hytale World or Universe to Your Server

Started an amazing adventure in singleplayer and want to bring your friends along? You can easily upload your existing Hytale saves to your MintServers host.

You have two options:

• Upload the Whole Universe (Recommended): Transfers everything—all worlds, player inventories, levels, and settings exactly as they are on your PC.
• Upload a Single World: Adds just one specific map to your current server without overwriting other worlds or player data.

Understanding Hytale Universe Structure

Hytale uses a universe folder to hold everything. Inside that, you have specific directories for worlds and players.

universe/
├── players/        ← Inventories & Player Stats
└── worlds/
    ├── default/    ← The main world
    ├── MyWorld/    ← A custom world

Option 1: Upload the Whole Universe (Full Migration)

Use this method if you want your server to be an exact copy of your singleplayer save. This is the easiest method as it automatically transfers your inventory and player stats.

Step 1: Zip Your Local Universe

1. Press Windows Key + R on your keyboard.
2. Type %appdata% and press Enter.
3. Navigate to: Hytale > UserData > Saves.
4. Right-click the folder named universe (or your custom save name).
5. Select "Send to" > "Compressed (zipped) folder".

Step 2: Upload to MintServers

1. Log into your MintServers game panel and Stop the server.
2. Go to the "Files" tab.
3. Locate the existing universe folder on your server and rename it to universe_old (or delete it if you are sure).
4. Drag and drop your new universe.zip file into the main file directory.
5. Right-click the zip file and select Unarchive (or Unzip).
6. Ensure the resulting folder is named exactly universe.
7. Start your server. You can now skip to the end of this guide!

Option 2: Upload a Single World

Use this method if you just want to add a map file to your server without deleting your existing server data.

Step 1: Locate Your World Folder

1. On your PC, go to %appdata% > Hytale > UserData > Saves.
2. Open the universe folder, then open worlds.
3. Find the specific world folder you want (e.g., MyCustomWorld).
4. Right-click it and zip it (Compressed folder).

Step 2: Upload to MintServers

1. In your game panel, go to Files > universe > worlds.
2. Drag and drop your zipped world file here.
3. Right-click and Unarchive.

Step 3: Load the World

Uploading the files isn't enough; you have to tell the server to load this specific world.

1. Go to the Console tab and Start the server.
2. Type this command: world load MyCustomWorld
   (Replace "MyCustomWorld" with your folder name).
3. Wait for the confirmation: "World loaded successfully."

How to Keep Your Inventory (For Option 2 Only)

Note: If you used Option 1 (Whole Universe), your inventory is already uploaded. You can ignore this section.

If you used Option 2, uploading the world only transfers the terrain. Your character's inventory is stored separately.

Steps to Migrate Player Data

1. On your PC, inside your save folder, open universe > players.
2. Select the player data files (usually named by your Player ID).
3. Stop your server completely.
4. In the panel file manager, navigate to universe/players/.
5. Upload the files here.
6. Start your server.

Frequently Asked Questions

I uploaded the world but I can't travel to it?

Make sure you ran the world load command. Type world list in the console to see active worlds, then use /tp world [worldname] to go there.

My world name has spaces, what do I do?

If your folder name is "My New World", the console commands might fail. We strongly recommend renaming the folder to use underscores (e.g., My_New_World) before uploading it.