How do I install mods onto my Hytale server?

How to Install Mods on Your Hytale Server

On AleForge, the quickest way is the built-in Hytale Mods page, which lets you browse and install mods without leaving the panel. If you prefer to upload files yourself, or you’re self-hosting, the manual method is below.

Early Access note: Hytale is still in Early Access and updates arrive often. A mod that works today may need an update later, so check each mod’s page for version notes.

---

Installing Mods With the Hytale Mods Page (Recommended)

1. Log in to the AleForge Panel and select your Hytale server.

2. In the left-hand menu, under Configuration, click Hytale Mods.

3. Open the Browse mods tab.

4. Use the Search for a mod bar to find a mod by name, or scroll through the list.

   

5. Each mod card shows the mod’s name, author, a short description, when it was last updated and its download count. Click the link icon next to the name if you’d like to read more on the mod’s own page first.

6. When you’ve found a mod you want, click Select version, choose the version you’d like, and confirm the install.

7. Open the Installed mods tab to check that your mod is on the server. The number next to the tab shows how many mods you have installed.

8. Restart your server from the Console page so the new mod loads.

Tip: Add a few mods at a time. If something goes wrong, it’s much easier to find the cause.

---

Installing Mods Manually

Prefer to upload your own files? You can download mods from sources such as CurseForge and add them to your server yourself. Mods can be in either .zip or .jar format.

On AleForge

1. Download the mods you’d like to install.
2. Log in to the AleForge Panel.
3. Stop your server from the Console page.
4. Go to Files and open the Mods folder.
5. Upload the mods you downloaded. You can drag and drop them, or use SFTP for larger uploads.
6. Start your server again.

Self-Hosting or Using Another Provider

1. Download the mods you’d like to install.
2. Stop your server.
3. Open your server files and go to the Mods folder.
4. Upload the mods you downloaded in .zip or .jar format.
5. Start your server again.

---

Troubleshooting

• A mod doesn’t appear in game: Make sure you restarted the server after installing it, and check the Installed mods tab.
• The server won’t start after adding a mod: Remove the newest mod, restart, and check the Console for error messages.
• A mod stopped working after an update: Look for a newer version of the mod, or roll back using your backup.
• Friends can’t connect: Check that their game and your server are on matching versions.

---

Need a Hytale Server?

AleForge’s Hytale server hosting gives you an always-online world, a built-in mod browser, backups, DDoS protection and 24/7 support.