How Do I Upload My Existing Hytale World to the Server?

This guide will walk you through transferring your singleplayer Hytale world to your CloudNord server, so you can continue playing with friends on the same world you've been building.

What You'll Accomplish

• ✅ Transfer your singleplayer world to your dedicated server
• ✅ Optionally transfer your character progress and inventory

Important: Always create a backup before making changes to your server files.

Part 1: Transferring Your World

Step 1: Locate Your Singleplayer World

1. Open Hytale on your PC
2. Click Worlds
3. Right-click the world you want to transfer → Open Folder
4. Navigate to: universe/worlds/

You'll see one or more world folders here. Each folder represents a world you can upload.

Step 2: Back Up Your Server

Before making any changes:

1. Stop your server from the Game Panel
2. Navigate to the File Manager in your Game Panel
3. Download a backup of your universe/ folder (this contains all worlds and player data)
4. Optionally back up config.json and mods/ folders as well

Step 3: Upload Your World to the Server

1. Ensure your server is stopped
2. In the Game Panel, open File Manager
3. Navigate to: universe/worlds/
4. Upload the world folder from Step 1

✅ Correct folder structure:

universe/worlds/<worldname>/config.json

⚠️ Common mistake: Uploading with extra nesting like universe/worlds/<worldname>/<worldname>/. If your world doesn't appear, check your folder structure.

Step 4: Load and Set Your World as Default

1. Start your server from the Game Panel
2. Open the Console tab
3. Run the following commands (replace <worldname> with your world folder's name):

Load the world:

/world load <worldname>

Verify it loaded:

/world list

Set it as the default world:

/world setdefault <worldname>

Step 5: Join Your World

• New players will automatically spawn in the default world
• If you've already joined the server before, use this command in-game:

/tp world <worldname>

Part 2: Transferring Your Character (Optional)

If you want to keep your character progress, inventory, and stats from singleplayer, follow these steps.

Step 1: Find Your Player Data File

1. Open Hytale on your PC
2. Click Worlds
3. Right-click any world from the same universe → Open Folder
4. Navigate to: universe/players/

You'll see a JSON file named with your Hytale UUID (a long string of numbers and letters). This is your player data file.

Step 2: Upload Your Player Data to the Server

1. Stop your server from the Game Panel
2. (Recommended) Join your server once first to generate your server-side player file
3. In the Game Panel File Manager, navigate to: universe/players/
4. Delete the existing UUID file that matches your account
5. Upload your singleplayer UUID JSON file
6. Start your server and join

Note: If your character appears fresh/new after joining, you may have uploaded a different UUID file. Verify the filename matches your current account's UUID on the server.

Troubleshooting

I joined but the server created a brand new world

• You likely didn't set the default world, or the world name doesn't match
• Run these commands in the console:

/world list
/world setdefault <worldname>

• Verify your folder structure is: universe/worlds/<worldname>/config.json

My world doesn't appear in /world list

• The folder may not be in universe/worlds/
• Check for extra folder nesting
• Ensure the folder name matches exactly (case-sensitive on Linux servers)

My character/inventory didn't transfer

• You only uploaded the world but not your player UUID file
• Verify you uploaded the correct UUID file for your account
• Try joining once first, then replace the generated UUID file with your singleplayer one

Commands aren't working

• Make sure you're running them from the Console tab in the Game Panel
• Verify you have admin/OP permissions on the server

Need Help?

If you're experiencing issues not covered in this guide, please contact CloudNord support through your client area.