Need to find your Hytale save files? This guide covers every important file location for Hytale – world saves, player data, the mods folder, and config files – for both singleplayer and dedicated servers.
Hytale Client File Locations
Hytale stores user data (saves, mods, logs) separately from the launcher installation files.
User Data Folder (Saves, Mods, Logs)
Windows:
%appdata%\Hytale\UserData\
Full path: C:\Users\<YourUsername>\AppData\Roaming\Hytale\UserData\
Quick access: Press Win + R, type %appdata%\Hytale\UserData, and press Enter.
Linux:
$XDG_DATA_HOME/Hytale/UserData/
Typical path: ~/.local/share/Hytale/UserData/
macOS:
~/Library/Application Support/Hytale/UserData/
Launcher Install Path (For Self-Hosters)
If you need to copy server files from your Hytale installation:
Windows:
%appdata%\Hytale\install\release\package\game\latest
Linux:
$XDG_DATA_HOME/Hytale/install/release/package/game/latest
macOS:
~/Library/Application Support/Hytale/install/release/package/game/latest
This folder contains Server/, Client/, and Assets.zip – useful for setting up a dedicated server.
Hytale World Save Location
Singleplayer Worlds
Your singleplayer world saves are stored in the UserData folder:
Windows:
%appdata%\Hytale\UserData\Saves\
Linux:
~/.local/share/Hytale/UserData/Saves/
macOS:
~/Library/Application Support/Hytale/UserData/Saves/
Each world has its own subfolder containing the world data.
Dedicated Server Worlds
On a Hytale dedicated server, worlds live in:
universe/worlds/
Each world has its own folder with a config.json for world-specific settings.
Example structure:
universe/
├── worlds/
│ ├── world1/
│ │ ├── config.json
│ │ └── (world data)
│ └── world2/
│ ├── config.json
│ └── (world data)
└── players/
└── (player data files)
Hytale Mods Folder Location
Client Mods
Windows:
%appdata%\Hytale\UserData\Mods\
Linux:
~/.local/share/Hytale/UserData/Mods/
macOS:
~/Library/Application Support/Hytale/UserData/Mods/
Server Mods
On a dedicated server, place mods in:
mods/
This folder is in your server's root directory (same location as HytaleServer.jar).
Hytale Config File Locations
Server Config Files
| File | Purpose |
|---|---|
config.json |
Main server configuration |
permissions.json |
Ranks and permissions |
whitelist.json |
Whitelist entries |
bans.json |
Banned players |
These files are in your server's root directory.
World Config
Each world has its own config at:
universe/worlds/<worldname>/config.json
Important: Config files are read on server startup. Avoid editing while the server is running – changes may be overwritten.
Hytale Player Data Location
Server Player Data
Player data is stored in:
universe/players/
This includes player inventory, position, and progress.
Hytale Logs Location
Client Logs
Windows:
%appdata%\Hytale\UserData\logs\
Linux:
~/.local/share/Hytale/UserData/logs/
macOS:
~/Library/Application Support/Hytale/UserData/logs/
Server Logs
Server logs are stored in:
logs/
On LOW.MS you can tail the live log in Web Console and read historical logs through Log Viewer, so you rarely need to touch the files directly.
Hytale Cache Folder
The server creates a cache folder for optimised files:
.cache/
You generally shouldn't need to touch this. Only delete it for troubleshooting, and expect a slower first startup afterwards while the server rebuilds the cache.
Hytale Cloud Saves
Hytale saves are stored locally on your device. If you play on multiple PCs, you'll need to copy or sync your save files manually.
To protect your saves:
- Manually back up your
UserData\Saves\(client) oruniverse/(server) folder regularly - Copy backups to cloud storage (Google Drive, Dropbox, OneDrive) for redundancy
- Before major updates, always create a backup
How to Back Up Hytale Worlds
Singleplayer Backup
- Close Hytale completely.
- Navigate to your saves folder:
- Windows:
%appdata%\Hytale\UserData\Saves\ - Linux:
~/.local/share/Hytale/UserData/Saves/ - macOS:
~/Library/Application Support/Hytale/UserData/Saves/
- Windows:
- Copy the world folder you want to back up.
- Paste it somewhere safe (external drive, cloud storage).
Server Backup (LOW.MS)
If you're on LOW.MS hosting, backups are handled through the panel:
- Log in to your LOW.MS panel.
- Click Cloud Backup.
- The backup completes automatically and is stored on your account – no further action needed.
You can restore from any saved backup through Cloud Restore.
Server Backup (Manual)
If you're self-hosting and want to take a backup by hand:
- Stop the server. Copying
universe/while the server is writing to it can produce a corrupt backup. - Copy the entire
universe/folder somewhere safe. - If you want a full snapshot you can walk away with, also copy
config.json,permissions.json,whitelist.json,bans.json, and yourmods/folder.
If you want automatic scheduled backups on a self-hosted server, that's usually something you set up at the OS level – a cron job on Linux, or Task Scheduler on Windows, that stops the server, copies universe/, and starts it again. There's no universally-documented "official" backup command in Hytale's current Early Access builds, so OS-level scripting is the reliable approach. On LOW.MS, Scheduled Tasks in the panel handles this for you without any scripting.
Backup Troubleshooting
Server starts a new world instead of loading a backup
This usually means the folder structure is wrong. When you open the universe/ folder you should see the data files directly – not another nested universe/ folder.
Wrong:
universe/universe/worlds/...
Correct:
universe/worlds/...
Move the files up one level if they're nested incorrectly.
Server crashes when loading a backup
This is almost always a mod mismatch. If your backup was created with mods installed, those same mods must be in the server's mods/ folder when you restore.
Fix:
- Check which mods were present when the backup was created.
- Reinstall the same mod versions on the server.
- Try loading the backup again.
Backup is corrupted
If you created a backup while the server was running, the files may be inconsistent. Always stop the server before taking a manual backup.
Restoring a Backup
Singleplayer
- Close Hytale.
- Navigate to your saves folder.
- Delete or rename the corrupted world folder.
- Paste your backup folder in its place.
- Launch Hytale.
Self-hosted server
- Stop the server.
- Delete or rename the current
universe/folder. - Paste your backup
universe/folder in its place. - Start the server.
LOW.MS server
- Log in to your LOW.MS panel.
- Click Cloud Restore.
- Select the backup you want to restore.
- Start the server.
Quick Reference Table
| Data | Client Location (Windows) | Server Location |
|---|---|---|
| Worlds | %appdata%\Hytale\UserData\Saves\ |
universe/worlds/ |
| Player Data | (in world saves) | universe/players/ |
| Mods | %appdata%\Hytale\UserData\Mods\ |
mods/ |
| Config | %appdata%\Hytale\UserData\ |
config.json |
| Logs | %appdata%\Hytale\UserData\logs\ |
logs/ |
| Cache | – | .cache/ |
FAQ
Q: Where is my Hytale world saved?
A: Singleplayer worlds are in %appdata%\Hytale\UserData\Saves\ on Windows. Server worlds are in the universe/worlds/ folder on the server itself.
Q: Does Hytale have cloud saves?
A: Hytale saves are stored locally. If you play on multiple PCs, you'll need to manually copy or sync your saves.
Q: Where do I put Hytale mods?
A: Client mods go in %appdata%\Hytale\UserData\Mods\. Server mods go in the mods/ folder in your server directory.
Q: How do I find my Hytale folder quickly?
A: Press Win + R, type %appdata%\Hytale\UserData, and press Enter. That opens your Hytale user data folder directly.