How to Upload a World to Your Hytale Server

How to Upload a Singleplayer 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 world to your MintServers host so you don't have to start from scratch.

This guide will show you how to locate your save files on your computer and upload them to your server correctly.

Understanding Hytale Universe Structure

Hytale uses a universe/worlds structure. A single universe can contain multiple worlds. This is why world files are stored in the universe/worlds/ subdirectory on your server.

universe/
├── players/
└── worlds/
    ├── default/          ← Default world
    ├── MyCustomWorld/    ← Your uploaded world
    └── AnotherWorld/

Step 1: Locate Your World Files

First, you need to find where Hytale stores your saves locally on your PC.

1. Press Windows Key + R on your keyboard to open the Run box.
2. Type %appdata% and press Enter.
3. Navigate to the Hytale folder, then open UserData > Saves > universe > worlds.
4. Identify the specific world folder you want to transfer.

Pro Tip: We recommend creating a .zip archive of your world folder before uploading. Right-click the folder, select "Compressed to", and click "ZIP File".

Step 2: Upload to MintServers

Now that you have your files ready, it’s time to move them to the server.

1. Log into your MintServers game panel.
2. Stop your server using the "Stop" button in the Console.
3. Go to the "Files" tab.
4. Open the universe folder, and then the worlds folder.
   • Path: /universe/worlds/
5. Drag and drop your world folder (or the .zip file you created) into this directory.
6. If you uploaded a .zip file, right-click it in the file manager and select "Unarchive" or "Unzip".

Step 3: Load the World

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

1. Go back to the "Console" tab and click "Start".
2. Once the server is online, type the following command into the console bar (do not add a / if typing directly into the panel console):
   world load MyAwesomeWorld
   (Replace "MyAwesomeWorld" with the exact name of the folder you uploaded).
3. Wait for the confirmation message: "World loaded successfully."

Step 4: Set as Default (Optional)

If you want new players to spawn in this world automatically when they join, you need to set it as the default.

1. In the console, type:
   world setdefault MyAwesomeWorld
2. Restart your server one last time to ensure all changes stick.

How to Keep Your Inventory (Player Data)

By default, uploading a world only transfers the terrain. Your character's inventory, levels, and location are stored separately in the Universe data.

If you want to keep your progress, you need to migrate your player data files alongside the world.

Step 1: Locate Your Singleplayer Data

The easiest way to find the correct files is through the game itself.

1. Launch Hytale and click on Worlds.
2. Right-click on the world you want to upload.
3. Select "Open Folder". This opens your specific Universe directory.
4. Open the players folder. (Path: universe/players/).
5. Keep this window open—these are the files you need to upload.

Step 2: Upload to MintServers

Now, move these files to your server to sync your character.

1. Stop your server via the MintServers Console. (Crucial to prevent data corruption!)
2. Go to the "Files" tab in your panel.
3. Navigate to universe/players/.
4. Upload the files from your computer into this folder.
5. Start your server.

Data Transfer Reference

Here is a quick breakdown of what is actually being moved when you transfer these files:

Frequently Asked Questions

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

Make sure you ran the world load command. You can check which worlds are currently running by typing world list in the console. If your world is listed there, you can teleport to it using /tp world in-game.

My world name has spaces, what do I do?

If your folder name is "My New World", the console might get confused. We strongly recommend renaming the folder to use underscores (e.g., My_New_World) before you upload it to the server. This makes typing commands much easier!