Hytale server mods and plugins

Hytale mods run on the server, so your friends don’t install anything to join. Add mods from the Mods tab with one tap, or upload .jar and .zip files to the mods folder, then restart.

How Hytale mods work

Hypixel built Hytale so that all modding happens on the server. It doesn’t support client mods. A player joining a modded server gets what they need from the server.

There are two main kinds of mod. Both go in the same mods folder:

Many mods include both. Some plugins also create a settings folder inside mods the first time they load.

Where mods come from. CurseForge is the main site for Hytale mods. Since Update 6, Hytale also has an in-game mod browser on the main menu, which installs mods for your own worlds. For a server, use the Mods tab or upload the files.

Install a mod from the Mods tab

1. Open Mods in the panel.
2. Search for a mod by name, or browse.
3. Pick it. The panel shows whether it works with your server’s Hytale version.
4. Press install. You’ll see a short plan: the files, any other mods it needs, and any warnings.
5. Confirm. We make a backup first, then download the files from the mod’s official source into mods.
6. Restart the server to turn the mod on.

This works while the server is asleep too. The mod loads the next time the server starts.

Some mod authors don’t allow other apps to download their files. The panel then links to the mod’s page, so you can download it there and upload it.

Install a mod by hand

1. Download the mod’s .jar or .zip file from its page, such as on CurseForge.
2. In the panel, open Files and go into the mods folder.
3. Upload the file. You can also use SFTP: your server’s address, port 2022, and the login from the SFTP card in Files.
4. Restart the server.
5. Open Console and read the startup lines. A mod that fails to load prints an error with its name.

Don’t unzip .zip mods. Hytale reads them as they are.

Early plugins

A few mods are “early plugins”, which load before the rest of the server. Hytale only loads them when you add --accept-early-plugins under Settings > Startup. Hypixel says early plugins are unsupported and may make the server unstable, so only use one when you need it, and follow the mod’s own setup notes.

What your friends need

Nothing. They join with your address and port as usual. Hypixel’s goal is that players can join any modded server without downloading external mods or packs.

They still need the same Hytale version as the server, like any other join.

Bring mods from your single-player world

If you built a world with mods in single player, bring the same mods so your world loads properly.

1. In the Hytale launcher, open settings, then Open Directory… > User Data.
2. Mods used by every world are in the Mods folder there. Mods for one world are in the mods folder inside that world’s folder in Saves.
3. Upload those files to the server’s mods folder, or install the same mods from the Mods tab.
4. Restart.

The backups guide covers moving the world itself.

Updates and version matching

Hytale is in Early Access and updates often. The game and the server must be on the same protocol version, or players can’t join. When an update changes the protocol, plugins need a new build from their authors.

• Mods never update on their own on Wilderack. The Mods tab shows when updates are available, with an Update all button that makes one backup first.
• Your server updates Hytale on its own by default, so players with the newest game can always join.
• After a big Hytale update, check your mods’ pages for new versions. Since Update 6, the server stops if a core plugin fails to load, rather than running half broken. The Console shows which mod failed.
• Pinning a version in Settings > Game version keeps old mods working, but players on the newer game can’t join until you update. Only pin for a short time.

Mods and server rules

Plugins that sell ranks, items or crates must follow Hypixel’s Server Operator Policies. Paid random items, for example, are not allowed on All Ages servers. The rules are summed up in rules for server owners.

If a mod breaks the server

1. Open Console and find the first error after startup. It usually names the mod.
2. Remove that mod in Mods, or delete its file from mods in Files.
3. Start the server again.
4. If the world itself is damaged, restore the automatic backup made before the mod was installed, in Backups.

See the server stops right after a mod is added for more.