> ## 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 Import Player Data from Singleplayer

> > Continue your adventure online - This guide shows you how to transfer your singleplayer character data, inventory, and progress to your Hytale server so yo...

## Transfer Your Character Progress, Inventory & Save Data

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

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

***

> **Continue your adventure online** - This guide shows you how to transfer your singleplayer character data, inventory, and progress to your Hytale server so you don't have to start over.

| Reading Time | Difficulty | Last Updated |
| :----------: | :--------: | :----------: |
|   5 minutes  |  Beginner  | January 2026 |

***

## Quick Navigation

| Section                                                            | What You'll Learn                |
| :----------------------------------------------------------------- | :------------------------------- |
| [Locate Player Data](#step-1-locate-your-singleplayer-player-data) | Find your save files             |
| [Upload to Server](#step-2-upload-player-data-to-your-server)      | Transfer files via control panel |

***

## Important: Before You Begin

> \[!CAUTION]
>
> ### Universe Compatibility
>
> Player data is **tied to the specific universe** it was created in. You must upload the player data to the **matching universe** on your server for it to work correctly.

***

## Step 1: Locate Your Singleplayer Player Data

First, you need to find your player data files on your computer.

### Open the Universe Folder

| Step | Action                                                                 |
| :--: | :--------------------------------------------------------------------- |
|   1  | Launch **Hytale**                                                      |
|   2  | Click on **Worlds**                                                    |
|   3  | **Right-click** any world that belongs to the universe you want to use |
|   4  | Click **Open Folder**                                                  |

This will open the universe directory on your computer.

### Navigate to Player Data

| Location           | Path                |
| :----------------- | :------------------ |
| Player Data Folder | `universe/players/` |

<Note>
  > Inside the `players/` folder, you will find player data files that store your character progress, inventory, and stats.
</Note>

<Tip>
  ### Save on Your Hosting

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

***

## Step 2: Upload Player Data to Your Server

Once you have located the player data files, upload them to your server.

> \[!IMPORTANT]
>
> ### Stop Your Server First
>
> For best results, make sure your server is **stopped** before uploading player data. This prevents file conflicts and data corruption.

### Upload via Control Panel

| Step | Action                                                               |
| :--: | :------------------------------------------------------------------- |
|   1  | **Stop** your server in the control panel                            |
|   2  | Navigate to the **Files** tab                                        |
|   3  | Open the following directory: `universe/players/`                    |
|   4  | **Upload** the player data files from your computer into this folder |
|   5  | **Start** your server                                                |

### Upload via FTP (Alternative)

| Step | Action                                                           |
| :--: | :--------------------------------------------------------------- |
|   1  | Connect to your server using an **FTP client** (e.g., FileZilla) |
|   2  | Navigate to `universe/players/`                                  |
|   3  | Upload your player data files                                    |
|   4  | Disconnect and start your server                                 |

***

## File Structure Reference

### What Gets Transferred

| Data               | Description                 |
| :----------------- | :-------------------------- |
| Character Progress | Level, experience, unlocks  |
| Inventory          | Items, equipment, resources |
| Player Stats       | Health, stamina, abilities  |

### Directory Structure

```
universe/
├── players/
│   ├── [PlayerUUID].json    ← Your player data file
│   └── ...
└── worlds/
    └── [WorldName]/
```

***

## Troubleshooting

### Player Data Not Loading

| Issue            | Solution                                            |
| :--------------- | :-------------------------------------------------- |
| Wrong Universe   | Ensure you uploaded to the matching universe folder |
| Server Running   | Stop the server before uploading files              |
| File Permissions | Check that files were uploaded completely           |

### Character Appears Reset

<Tip>
  > If your character appears reset after joining, double-check that:
</Tip>

> * The player data file was uploaded to the correct `universe/players/` folder
> * The universe on the server matches the one from your singleplayer save
> * Your server was restarted after uploading

***

## 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>