Hytale Save File Location (World, Mods, Config Folders)

Need to find your Hytale save files? This guide covers every important file location for Hytale — including world saves, player data, 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 are stored 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/

Check here first when troubleshooting errors. The latest log file shows recent server activity.

---

Hytale Cache Folder

The server creates a cache folder for optimized files:

.cache/

You generally shouldn't need to touch this folder. Only delete it for troubleshooting purposes — expect a slower first startup while the server rebuilds cached data.

---

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) or universe/ (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

1. Close Hytale completely
2. Navigate to your saves folder:
   • Windows: %appdata%\Hytale\UserData\Saves\
   • Linux: ~/.local/share/Hytale/UserData/Saves/
   • macOS: ~/Library/Application Support/Hytale/UserData/Saves/
3. Copy the world folder you want to back up
4. Paste it somewhere safe (external drive, cloud storage)

Server Backup (LOW.MS)

If you're using LOW.MS hosting, you can back up your server directly from the panel:

1. Log in to your LOW.MS panel
2. Click on 'Cloud Backup'
3. Backup completes automatically and is stored in your account

Server Backup (Manual)

1. Stop your server
2. Copy the entire universe/ folder
3. Store the backup in a safe location

What to back up:

• universe/ — all world and player data
• config.json — server settings
• permissions.json — ranks and permissions
• mods/ — if you have mods installed

Server Backup (Using /backup Command)

Hytale servers have a built-in backup command:

/backup

This triggers an immediate backup without stopping the server.

Requirements:

• The --backup-dir startup argument must be configured
• Example startup command:

java -jar HytaleServer.jar --assets Assets.zip --backup-dir ./backups

Automated Server Backups

To enable automatic backups, add these arguments to your server startup:

java -jar HytaleServer.jar --assets Assets.zip --backup --backup-dir ./backups

Argument	Description
--backup	Enable automatic backups
--backup-dir <path>	Directory to store backups

Check your hosting panel for a "Backups" or "Scheduled Tasks" section if you're using managed hosting.

---

Backup Troubleshooting

Server starts a new world instead of loading 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 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.

Fix:

1. Check which mods were used when the backup was created
2. Install the same mod versions on the server
3. Try loading the backup again

Backup is corrupted

If you created a backup while the server was running (without using /backup), files may be inconsistent.

Prevention:

• Always stop the server before manual backups, OR
• Use the /backup command which handles this safely

---

Restoring a Backup

Singleplayer

1. Close Hytale
2. Navigate to your saves folder
3. Delete or rename the corrupted world folder
4. Paste your backup folder
5. Launch Hytale

Server

1. Stop the server
2. Delete or rename the current universe/ folder
3. Paste your backup universe/ folder
4. Start the server

Server (LOW.MS)

If you're using LOW.MS hosting:

1. Log in to your LOW.MS panel
2. Click on 'Cloud Restore'
3. Select the backup you want to restore
4. 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.

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. This opens your Hytale user data folder directly.

Q: Can I move my singleplayer world to a server?

A: Yes! See our Migrate Singleplayer to Dedicated Server guide.