Skip to main content

Transfer Your Character Progress, Inventory & Save Data


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 TimeDifficultyLast Updated
5 minutesBeginnerJanuary 2026

Quick Navigation

SectionWhat You’ll Learn
Locate Player DataFind your save files
Upload to ServerTransfer 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

StepAction
1Launch Hytale
2Click on Worlds
3Right-click any world that belongs to the universe you want to use
4Click Open Folder
This will open the universe directory on your computer.
LocationPath
Player Data Folderuniverse/players/
Inside the players/ folder, you will find player data files that store your character progress, inventory, and stats.

First Month Discount

Use code KB20 at checkout to get 20% off your first month of hosting!

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

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

Upload via FTP (Alternative)

StepAction
1Connect to your server using an FTP client (e.g., FileZilla)
2Navigate to universe/players/
3Upload your player data files
4Disconnect and start your server

File Structure Reference

What Gets Transferred

DataDescription
Character ProgressLevel, experience, unlocks
InventoryItems, equipment, resources
Player StatsHealth, stamina, abilities

Directory Structure

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

Troubleshooting

Player Data Not Loading

IssueSolution
Wrong UniverseEnsure you uploaded to the matching universe folder
Server RunningStop the server before uploading files
File PermissionsCheck that files were uploaded completely

Character Appears Reset

If your character appears reset after joining, double-check that:
  • 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

ResourceLink
Official Hytale Websitehytale.com
Hytale Support Portalsupport.hytale.com

Support Channels

If you need assistance or have any questions, please contact our support team:

First Month Discount

Use code KB20 at checkout to get 20% off your first month of hosting!

Last Updated: January 2026 | Need Help? Contact our 24/7 support team!