HypeServ
Hytale

Installing Mods on a HypeServ Hytale Server

Step-by-step instructions for adding mods to your Hytale server on HypeServ.

This guide walks you through how to add mods to your HypeServ Hytale server, including downloading, uploading, and activating mods.

Mods let you customize gameplay, add new items or mechanics, and create unique experiences for players.

Mod support and tooling are early and may change over time. Always use mods compatible with your server’s Hytale version and back up your server before making changes.

How to add a Mod to you Hytale Server

Stop your server

Before installing mods, stop your Hytale server from the HypeServ panel:

  1. Open your Server in the HypeServ panel.
  2. Click the Stop button for your Hytale server.
This ensures files are not in use while you upload mods.

Downloaing the mods

Where to get mods

  • Trusted mod platforms (e.g., CurseForges Hytale section)
  • Mod developers’ official releases
  • Community mod platforms and creators (Discord, GitHub)

Mods typically come as .zip or .jar files.

Only download mods meant for your current Hytale server version to reduce crashes.

Upload mods to your server

There are two common methods to upload mods:

Via HypeServ File Manager

  1. Open the Files tab for your Hytale server in the HypeServ panel.
  2. Navigate to the mods/ folder in the root directory.
  3. Upload your downloaded mod files directly into this folder.
  4. Do not unzip the mod files, upload them as .zip or .jar.

Via SFTP

  1. Connect to your server using an SFTP client (e.g., FileZilla or WinSCP) using your HypeServ credentials.
    You can find your SFTP credentials in your Server settings (Tab Settings) under SFTP Settings. Click here to read our detailed SFTP connection guide.
  2. Locate the mods/ directory in the server root.
  3. Upload each mod file to this directory.

Whether you use the file manager or SFTP, the end result should be a server folder like:

Server Files
/
├── mods/
│   ├── SomeMod.jar
│   └── AnotherMod.zip
├── config.json
├── universe/
└── ...

Start your server

After uploading your mods:

  1. Return to the HypeServ panel.
  2. Click Start to restart your Hytale server.

The server will automatically detect and load mods placed in the mods/ folder. Watch your Console tab for any errors or confirmation messages during startup.

Verify mods are working

Once the server is running:

  • Look for messages indicating the mod(s) have loaded in the console output.
  • Join the server in game and check whether mod features are present (items, commands, mechanics).
  • If a mod provides commands, test them to confirm successful loading.

If a mod fails to load, check:

  • Compatibility with your server’s Hytale version.
  • Errors in the console log that point to missing dependencies or conflicts.
  • If you see no output, check if the mod file has been correctly placed in the mods/ directory.

Updating or removing mods

Updating a mod

  1. Stop the server.
  2. Delete the old mod file from the mods/ folder.
  3. Upload the new version of the mod.
  4. Start the server again.

Removing a mod

  1. Stop the server.
  2. Remove the mod file from the mods/ folder.
  3. Restart the server.
Some mods can alter your world’s data. Removing a mod after world generation might cause missing content or errors. Always make backups first.

Tips for smoothly running a modded server

  • Always Back up your world before adding or updating mods.
  • Only install one mod at a time and restart to isolate issues.
  • Monitor console logs to catch errors early.

Get your server!

Order your Hytale server, start it for the first time, connect in-game, and learn the basics.

Need help with mods?

If your mods aren’t loading or you’re unsure how to install them, our support team can help. We’ll walk you through the process or help troubleshoot issues.

Admin Commands

An overview of the most important admin, world, builder, and player commands for Hytale servers.

Troubleshooting

Fix common Hytale server issues like failed authentication, world not loading, version mismatch, lag spikes, and mod crashes.