What Are Hytale Mods?
Hytale mods are custom content created by the community that modifies or adds to the game. Unlike Minecraft, Hytale does not use traditional mod loaders like Forge or Fabric. Instead, the game features a server-side first architecture — when you join a modded server, the game automatically syncs all mod assets to your client without you having to install anything manually.
For singleplayer or your own worlds, you install mods by placing files in the correct folder and activating them in-game.
Types of Hytale Mods
The Hytale modding scene already has a growing library of content across many categories:
- Blocks — New decorative or functional building materials
- Food & Farming — New crops, cooking recipes, livestock
- Furniture — Detailed non-block decorative items
- Gameplay — New or modified core mechanics
- Mobs & Characters — New creatures, NPCs, bosses
- World Gen — Changes how landscapes are generated
- Quality of Life — Interface tweaks and small improvements
- Utility — Tools, commands, performance tweaks
- Library — Shared code frameworks that other mods depend on
- Prefab — Pre-made structures and blueprints
Mod File Formats
Hytale mods come in two main formats:
- .jar files — Java-based plugins. You place these directly in the mods folder.
- Content packs (folders) — Folders containing assets, scripts, and configs. Often distributed as
.zipfiles — you need to extract them first and place the unzipped folder in the mods directory.
Before You Start
- A legal copy of Hytale installed and up to date
- Mods from a trusted source (see below)
- Basic knowledge of navigating your file explorer
Trusted Mod Sources
- CurseForge (Hytale) — One of the largest mod platforms, with close to 2000 Hytale mods, scanned for malware and vetted by moderators
- Iced Fox Studios — Our own curated Hytale content
- Hytale Modding — Community documentation and modding resources
Method 1: Per-World Installation (Recommended)
This is the easiest and cleanest method. You install mods for a specific world only, so different worlds can have different mod setups.
Go to Your World
From the Hytale main menu, click "Worlds" and find the world you want to mod.
Open the World Folder
Right-click the world, go to Settings, and click "Open Folder". This opens the world's directory in your file explorer.
Find the Mods Folder
Inside the world folder, you'll see a mods folder. Open it. This is where your mod files go.
C:\Users\YourName\AppData\Roaming\Hytale\UserData\Saves\Your World Name\mods
Place Your Mod Files
Now place your mods in this folder. There are two options depending on the mod type:
- If it's a
.jarfile — Drop the.jardirectly into themodsfolder. Done. - If it's a content pack (
.zip) — Extract/unzip the file first, then place the resulting folder (not the .zip) inside themodsfolder.
Activate the Mod In-Game
Go back to Hytale. Open your world's Settings again. You'll see the mod listed — toggle it on, click "Apply Settings", and you're done. Enter the world and enjoy.
Method 2: Global Installation (All Worlds)
If you want a mod to be available across all your worlds, you can place it in the global mods folder instead.
Open the Global Mods Folder
Navigate to the Hytale UserData/Mods directory:
%AppData%\Hytale\UserData\Mods~/Application Support/Hytale/UserData/Mods$XDG_DATA_HOME/Hytale/UserData/ModsPlace Your Mod Files
Same as before: .jar files go in directly, content packs go in as unzipped folders.
Activate Per World
Even though the mod is globally available, you still need to activate it in each world's settings. Go to your world settings, toggle the mod on, and apply.
Method 3: Using CurseForge
CurseForge offers a desktop app that automates mod management for Hytale. It handles downloading, installing, and organizing mods for you.
Install the CurseForge App
Download the CurseForge desktop app, install it, and launch it. It should auto-detect your Hytale installation.
Browse Hytale Mods
Click on Hytale in the CurseForge app. Use the "Discover" or "Browse" tabs to search for mods by category, popularity, or name.
Install with One Click
Found a mod you like? Click "Install". CurseForge downloads and places it in the right folder automatically. You can manage installed mods from Hytale > "My Mods".
Activate In-Game
Launch Hytale (from CurseForge or the normal launcher). Go to your world settings and enable the mods you installed, then click "Apply Settings".
Mods in Multiplayer
Hytale handles multiplayer modding differently from most games. It uses a server-side first architecture:
- When you join a modded server, Hytale automatically syncs all required mod assets to your client. You don't need to install anything manually.
- If you host your own server, you place mods in the server's mods directory and configure them. Players who join will receive the content automatically.
This is a huge improvement over games like Minecraft, where you have to manually match your mod list with the server's.
Troubleshooting
Mod doesn't appear in world settings
Make sure the file is in the correct mods folder (per-world or global). If it's a .zip, make sure you extracted it first — Hytale won't read zipped packs. For .jar mods, the file should be placed directly, not inside a subfolder.
Game crashes when activating a mod
The mod may be incompatible with your Hytale version. Remove it from the mods folder, launch the game normally, and check for an updated version of the mod.
Mod loads but features don't work
Some mods depend on library mods (like "Hybrid" by Serilum). Check the mod's description for required dependencies and install them too.
How to check which mods are active
Install the "Better Modlist" mod from CurseForge. Once active, type /modlist in the chat to see a scrollable list of all mods loaded in your current world.
Frequently Asked Questions
.jar files (Java-based plugins) which you place directly in the mods folder, and content packs which are folders containing assets, scripts, and configuration files. Content packs are often distributed as .zip files that you need to extract first.
%AppData%/Hytale/UserData/Mods on Windows. For per-world mods, each world has its own mods folder at %AppData%/Hytale/UserData/Saves/[World Name]/mods. The easiest way to find it: right-click your world in-game > Settings > Open Folder.
mods folder inside the world's save directory. Place mods there to apply them to that specific world only. Mods in the global UserData/Mods folder are available to all worlds but still need to be activated per-world in the settings.