> ## Documentation Index
> Fetch the complete documentation index at: https://help.freakhosting.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Upload a Singleplayer World to Your Server

> > Bring your creations online - This guide shows you how to upload your singleplayer world to your Hytale server, load it using commands, and set it as the d...

## Transfer Your Custom World, Load It Online & Set It as Default

<CardGroup cols={2}>
  <Card title="Difficulty" icon="gauge-low">
    Beginner
  </Card>

  <Card title="Time" icon="clock">
    5 Minutes
  </Card>
</CardGroup>

***

> **Bring your creations online** - This guide shows you how to upload your singleplayer world to your Hytale server, load it using commands, and set it as the default spawn world.

| Reading Time |  Difficulty  | Last Updated |
| :----------: | :----------: | :----------: |
|   8 minutes  | Intermediate | January 2026 |

***

## Quick Navigation

| Section                                                            | What You'll Learn        |
| :----------------------------------------------------------------- | :----------------------- |
| [Locate World Files](#step-1-locate-your-singleplayer-world-files) | Find your world folder   |
| [Upload to Server](#step-2-upload-your-world-to-the-server)        | Transfer files to server |
| [Load the World](#step-3-load-the-world-on-the-server)             | Activate via commands    |
| [Set Default World](#step-4-set-the-default-world)                 | Make it the spawn world  |
| [Travel Between Worlds](#step-5-travel-between-worlds)             | Multi-world navigation   |

***

## Understanding Hytale Universe Structure

<Note>
  > 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.
</Note>

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

***

## Step 1: Locate Your Singleplayer World Files

First, find your world folder on your local computer.

| Step | Action                                                  |
| :--: | :------------------------------------------------------ |
|   1  | Open the **Hytale** client                              |
|   2  | Navigate to the **Worlds** menu                         |
|   3  | **Right-click** the world you want to upload            |
|   4  | Select **Open Folder**                                  |
|   5  | In File Explorer, navigate to `universe/worlds/`        |
|   6  | Identify the specific world folder you want to transfer |

<Tip>
  > The world folder name is what you'll use in server commands later. Note it down exactly.
</Tip>

***

## Step 2: Upload Your World to the Server

Transfer the world folder to your server.

### Option A: Direct Upload (Small Worlds)

| Step | Action                                       |
| :--: | :------------------------------------------- |
|   1  | Log in to your **Game Server Control Panel** |
|   2  | **Stop** your server                         |
|   3  | Go to the **Files** tab (File Manager)       |
|   4  | Navigate to `universe/worlds/`               |
|   5  | **Upload** the entire world folder           |
|   6  | Wait for the upload to complete              |

### Option B: ZIP Upload (Large Worlds - Recommended)

| Step | Action                                                             |
| :--: | :----------------------------------------------------------------- |
|   1  | On your computer, **compress** the world folder into a `.zip` file |
|   2  | Log in to your control panel and **stop** the server               |
|   3  | Navigate to `universe/worlds/`                                     |
|   4  | Upload the `.zip` file                                             |
|   5  | Use the control panel's **Unarchive** feature to extract it        |
|   6  | Delete the `.zip` file after extraction                            |

> \[!IMPORTANT]
> ZIP upload is significantly faster for large worlds and reduces the chance of upload failures.

***

## Step 3: Load the World on the Server

Once uploaded, you must activate the world using server commands.

### View Available Worlds

```
world list
```

This displays all world folders in `universe/worlds/`.

### Load a Specific World

```
world load <worldname>
```

| Parameter     | Description                         |
| :------------ | :---------------------------------- |
| `<worldname>` | The exact folder name of your world |

**Example:**

```
world load MyCustomWorld
```

> \[!CAUTION]
> The world name must **match the folder name exactly**, including capitalization.

***

## Step 4: Set the Default World

Make your uploaded world the primary spawn point for all players.

### Set Default World Command

```
world setdefault <worldname>
```

**Example:**

```
world setdefault MyCustomWorld
```

| Effect           | Description                              |
| :--------------- | :--------------------------------------- |
| Startup Behavior | Server loads this world first on startup |
| Player Spawn     | New players spawn in this world          |
| Priority         | This world takes precedence over others  |

***

## Step 5: Travel Between Worlds

Players with appropriate permissions can teleport between loaded worlds.

### Teleport to Another World

```
/tp world <worldname>
```

**Example:**

```
/tp world AnotherWorld
```

<Note>
  > This command requires operator permissions. Players can smoothly navigate between different environments on a single server.
</Note>

<Tip>
  ### Save on Your Hosting

  Ready to get a new server? Use code **KB20** at checkout for **20% off** your first month!
</Tip>

***

## Command Reference

| Command                   | Description                       |
| :------------------------ | :-------------------------------- |
| `world list`              | Display all available worlds      |
| `world load <name>`       | Load a specific world into memory |
| `world setdefault <name>` | Set a world as the default spawn  |
| `/tp world <name>`        | Teleport to a different world     |

***

## Troubleshooting

### World Not Appearing in List

| Issue                    | Solution                               |
| :----------------------- | :------------------------------------- |
| Folder in wrong location | Ensure folder is in `universe/worlds/` |
| ZIP not extracted        | Use Unarchive feature after upload     |
| Server not restarted     | Restart the server after upload        |

### Command Not Working

| Issue            | Solution                                           |
| :--------------- | :------------------------------------------------- |
| Name mismatch    | Check folder name matches exactly (case-sensitive) |
| World not loaded | Run `world load <name>` first                      |
| No permissions   | Ensure you have operator access                    |

***

## Additional Resources

| Resource                | Link                                              |
| :---------------------- | :------------------------------------------------ |
| Official Hytale Website | [hytale.com](https://hytale.com/)                 |
| Hytale Support Portal   | [support.hytale.com](https://support.hytale.com/) |

<Note>
  ### Need Extra Help?

  If you encounter any issues, our support team is ready to assist:

  * **Live Chat:** Quick assistance via our website.
  * **Support Ticket:** [Open a Ticket](https://freakhosting.com/clientarea/submitticket.php)
  * **Discord:** [Join our Community](https://discord.gg/freakhosting)
  * **Email:** [support@freakhosting.com](mailto:support@freakhosting.com)
</Note>

<Tip>
  ### Save on Your Hosting

  Ready to get a new server? Use code **KB20** at checkout for **20% off** your first month!
</Tip>

***

<div align="center">
  **Last Updated:** January 2026 | **Need Help?** Contact our 24/7 support team!
</div>