LIMITED TIME OFFER: 25% off your first month — use code


 
 
 
 
Knowledgebase Hytale How to Upload a World to Your Hytale Ser...

How to Upload a World to Your Hytale 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 depending on what you want to achieve:

  • 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 existing 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 (main universe directory)
📁 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.

⚠️ Warning: Overwrite Risk
This method will replace the current universe on your server. If you have existing server data you want to keep, make a backup first!

Step 1: Zip Your Local Universe

  1. Press Windows Key + R on your keyboard to open the Run dialog.
  2. Type %appdata% and press Enter.
  3. Navigate to the following folder path:
AppData\Roaming\Hytale\UserData\Saves
  1. Right-click the folder named universe (or your custom save name).
  2. Select Send to > Compressed (zipped) folder.

Step 2: Upload to MintServers

  1. Log into your MintServers panel and Stop the server.
  2. Go to the Files tab on the left-hand sidebar.
  3. Locate the existing universe folder on your server and rename it to universe_old (or delete it if you are sure you no longer need it).
  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!
🚀 Launch Your Unlimited RAM Game Server — Just $9.99/mo!

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, navigate 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 compress it into a zip file.

Step 2: Upload to MintServers

ℹ️ Large Files?
If your world is larger than 100MB, we highly recommend using FTP (FileZilla) instead of the browser uploader to avoid timeouts.
  1. In your game panel, go to Files > universe > worlds.
  2. Drag and drop your zipped world file here.
  3. Right-click the file and select 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 the following command (replacing "MyCustomWorld" with your exact folder name):
💻 Console Input
world load MyCustomWorld
  1. Wait for the confirmation message: "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.

⚠️ Universe Compatibility:
Player data is tied to the specific Universe ID. Mixing player data from different universes may cause data loss or character resets. Proceed with caution!
  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 on the MintServers panel.
  4. In the panel file manager, navigate to universe / players /.
  5. Upload the files here.
  6. Start your server.

🛠️ Troubleshooting World Uploads

I uploaded the world but cannot travel to it: Make sure you ran the world load command in the console. You can type world list in the console to see active worlds, then use /tp world [worldname] in-game to go there.

My world name has spaces in it: 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 you zip and upload it!

No worries if your world or items are still refusing to load properly! Just open a support ticket and our team will gladly jump in and instruct you on how to resolve the configuration.

Was this article helpful?

The Last Minecraft Hosting You Will Ever Need!

Unlimited Slots, Unlimited RAM, One-Click Mods & Plugins