How to Import Player Data from Singleplayer

​

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.

​

Quick Navigation

​

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

​

Open the Universe Folder

​

Navigate to Player Data

​

Step 2: Upload Player Data 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

​

Upload via FTP (Alternative)

​

File Structure Reference

​

What Gets Transferred

​

Directory Structure

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

​

Troubleshooting

​

Player Data Not Loading

​

Character Appears Reset

• 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