8 April 2026

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

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) 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 on LOW.MS hosting, backups are handled through the panel:

  1. Log in to your LOW.MS panel.
  2. Click Cloud Backup.
  3. 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:

  1. Stop the server. Copying universe/ while the server is writing to it can produce a corrupt backup.
  2. Copy the entire universe/ folder somewhere safe.
  3. If you want a full snapshot you can walk away with, also copy config.json, permissions.json, whitelist.json, bans.json, and your mods/ 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:

  1. Check which mods were present when the backup was created.
  2. Reinstall 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, the files may be inconsistent. Always stop the server before taking a manual backup.


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 in its place.
  5. Launch Hytale.

Self-hosted server

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

LOW.MS server

  1. Log in to your LOW.MS panel.
  2. Click 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 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.

Join our Discord to chat with our staff and community!
Join Discord