Hytale Practical Wiki editors · Updated September 25, 2026

How to install Hytale mods

There are two install paths: the in-game browser (one click, covers most cases) and manual installation (needed for server mods and off-browser distributions). Both are below, then what to do when a mod won't load.

Last checked: September 2026Early Access

Before installing anything

• Know which side it runs on. Client mod or server mod — installing a server mod on your client does nothing, and vice versa. The mods overview explains the split.
• Check the game version. A mod built for an older build may fail on yours — after game patches, give mod authors time (see the update tracker).
• Back up any world you care about before modding it. Always this one, always first.

The easy way: in-game

1. Open the mod browser in-game.
2. Find the mod, check its last-updated date and side (client/server).
3. Install — one click, files land where they belong.
4. Enable it for the world you want, ideally a test world first.

Manual install — client

1. Find the game's mods folder. The browser installs into it; existing installed mods show you exactly where it is on your system.
2. Drop the mod's folder in. Mods are folders, not loose files — if what you downloaded is a zip, extract it and place the mod folder itself into the mods directory.
3. Enable it for your world and launch.

Manual install — server

Server mods go on the server, in its own mods folder next to the server jar:

1. Stop the server. Installing into a running server is asking for half-loaded mods.
2. Place the mod folder in the server's mods directory.
3. Check the config if the mod has one.
4. Start the server and read the boot console — mods that load print evidence; mods that fail print the reason.

If players then can't connect, the most likely cause is a mod version mismatch between server and clients — see the failed to connect checklist.

When a mod won't load

1. Wrong side. A client mod installed on the server (or vice versa) never loads. Check first; it's the most common cause.
2. Nested folder from manual installation — the warning box above.
3. Version mismatch — mod built for a different game build.
4. A conflict with another mod. The isolation procedure for finding which two mods are fighting is on the mod browser page.
5. Read the error — the game and server consoles log the actual reason. It's usually more specific than "failed".

Removing mods without ruining worlds

The asymmetry worth knowing before your first uninstall: installing is reversible, uninstalling from a world that used the mod is not. The sequence:

1. Back up the world. Same rule as installing — every mod change earns a backup.
2. Disable before deleting when unsure. Disabling stops the mod loading but keeps it one click from returning.
3. Remove the mod's content from the world first, if you can — items from chests, blocks from builds. Worlds generally keep running without the mod; they don't keep its content.
4. Then delete via the browser, or remove the folder manually if it was a manual install.

Related pages

• Mod browser — the everyday, one-click path.
• Mods overview — evaluating mods before installing them.
• How to mod Hytale — when installing stops being enough.