Hytale Mods Not Working? Mods Not Loading from CurseForge or the Mods Folder (Fix)

Hytale Guide • Updated Oct 16, 2026

Hytale Mods Not Loading: Fix Common Mod Issues

Mods that do not load are almost always a wrong file type or location, a missing manifest.json, a missing dependency, or a version mismatch. Use the checks below before wiping the server.

Quick Checks

Check	Why It Fails	Fix
mods/ folder	Mod directory missing or wrong path	Put mods in `mods/` in the server's working directory, or start the server with `--mods <dir>`
Plugin file type	A plugin is a `.jar`. A zip, or a jar inside a subfolder, is not picked up as a plugin	Put the `.jar` directly in `mods/`
manifest.json	Missing or invalid manifest at the root of the jar, zip or pack folder	Check the log for "Failed to load manifest file!" and fix the file
Version mismatch	The mod targets another server version (`ServerVersion` in its manifest)	Update the mod, or the server; the log warns about packs that target an older server
Dependencies missing	A plugin lists a required dependency that is not installed	Install the dependencies named on the mod page
Disabled in config	`Enabled` is false for it under `Mods` in `config.json`, or `DefaultModsEnabled` is false	Enable it in `config.json`

Step-by-Step Fix

Check where the mod is. Plugins are .jar files and asset packs are .zip or .jar files or folders, all inside mods/. See Does Hytale Support Lua? Server Plugins Explained for the difference.
Check the manifest. Every plugin and pack needs a manifest.json at its root with at least Group, Name and Version; a plugin also needs Main, its Java class.
Read the log. The server writes a new file in logs/ at each start, named like 2026-10-16_08-30-00_server.log. Look for "Loading pending plugins from directory", "Failed to load pending plugin" and "Failed to load manifest file".
List and reload. /plugin list shows what is loaded. /plugin reload <name> reloads one plugin and /plugin load <name> loads one you just added. A restart always works.
Start despite a broken mod. The --ignore-broken-mods flag lets the server boot even when one mod fails, so you can find it.
Resolve conflicts. If two mods fight, see Mod Compatibility Issues.

Example manifest.json

{
    "Group": "com.example",
    "Name": "HelloWorld",
    "Version": "1.0.0",
    "Main": "com.example.helloworld.HelloWorldPlugin"
}

Other fields the server reads include Description, Authors, Website, ServerVersion, Dependencies, OptionalDependencies, DisabledByDefault, LoadBefore and IncludesAssetPack.

Tip: When using CurseForge packs, confirm every dependency is installed. Missing a single dependency can prevent the entire pack from loading.

Keep your server moddable. Host your Hytale server with Supercraft for easy file access and mod management.

Tired of fighting this issue every patch?

Run a managed Hytale server with us. We handle the patches, mod-version pinning, save backups, and DDoS protection. Set up in minutes, multiple datacenter regions, no contract.

See Hytale hosting plans →

← Back to Hytale Guides

Menu