What this guide does

• ✅ Moves your singleplayer world onto your dedicated server (so you can keep building with friends).
• ✅ Optionally moves your character/inventory progress too (player data file).

Important: Always take a backup of your server before changing anything. Your server’s saved data lives in universe/ (worlds + players).

---

Part 1: Upload your singleplayer world to the server

Step 1: Locate the world folder on your PC

The easiest way is from inside the game:

1. Open Hytale
2. Click Worlds
3. Right-click the world you want → Open Folder
4. Go to: universe/worlds/

Inside universe/worlds/ you’ll see one or more world folders. Each folder is a world you can upload.

---

Step 2: Back up your server (highly recommended)

1. Stop the server
2. Download/copy the server’s universe/ folder somewhere safe (and optionally config.json + mods/)

---

Step 3: Upload the world folder(s) to the server

1. Make sure the server is stopped
2. In your server files, open: universe/worlds/
3. Upload the world folder you found in Step 1 into universe/worlds/

✅ Correct structure should look like:

• universe/worlds/<worldname>/config.json

Common mistake: Uploading a ZIP or an extra nested folder like universe/worlds/<worldname>/<worldname>/.... If the server can’t see the world, check this first.

---

Step 4: Load the world and set it as default

Start the server, then use console/in-game commands.

Load the world

Run (replace <worldname> with the folder name you uploaded):

/world load <worldname>

You can list loaded worlds with:

/world list

Set the default world (so players spawn there)

/world setdefault <worldname>

---

Step 5: Join the world

• New players should spawn into the default world automatically once set.
• If you’ve already joined the server and want to move to it:

/tp world <worldname>

---

Part 2 (Optional): Transfer your singleplayer character/inventory to the server

If you want your character progress, inventory, and player state to carry over, you need to upload your player data file.

Step 1: Find your player data file

From inside the game:

1. Open Hytale
2. Click Worlds
3. Right-click a world in the same universe → Open Folder
4. Go to: universe/players/

Inside universe/players/ you’ll see a JSON file named with your Hytale UUID. That file is your player data.

---

Step 2: Upload your player file to the server

1. Stop the server
2. Go to server: universe/players/
3. (Recommended) Join the server once first so it generates your UUID file.
4. Delete the server-side UUID file that matches the one you’re replacing
5. Upload your singleplayer UUID JSON file into universe/players/
6. Start the server and join

If you join and your character is still “fresh”, you might be on a different account/UUID than the singleplayer file you uploaded. Confirm the filename matches your UUID on that server.

---

Troubleshooting

I joined but it generated a brand new world

• You likely didn’t set the default world, or the world name doesn’t match the folder name.
• Run:
  • /world list
  • /world setdefault <worldname>
• Double-check the folder path is exactly universe/worlds/<worldname>/config.json (no extra nesting).

The world doesn’t show up in /world list

• The folder might not be in universe/worlds/
• The folder might be nested one level too deep
• The folder name in the command must match the folder name exactly (case matters on Linux)

My inventory/character didn’t transfer

• You only uploaded the world; you didn’t upload your UUID player file.
• Make sure you replaced the correct UUID file on the server.
• Join once, then stop the server and replace the generated UUID file (safer).

Commands don’t work for me

• Run them from the server console, or ensure you have permission/OP to run admin commands.