How to Install Mods on a Hytale Server
This guide explains how to install and manage mods on your Hytale server. Mods are add-ons that change or enhance your server with new features, gameplay mechanics, items, creatures, and more.
Option #1: Installing Mods on a Survival Servers Hytale Server
If you rent a Hytale server from Survival Servers, adding mods is easy using our control panel.
Step 1: Stop Your Server
- Log into your Survival Servers control panel
- Click the Stop button to shut down your server
Step 2: Access Your Server Files
You can upload mods using either FTP or the File Manager:
Using the File Manager (easiest):
- In your control panel, click File Manager
- Navigate to the
modsfolder - Click Upload and select your mod files
Using FTP:
- Connect to your server using an FTP client (like FileZilla)
- Your FTP details are in your control panel under FTP Access
- Navigate to the
modsfolder - Upload your mod files (
.zipor.jar)
Step 3: Start Your Server
- Return to your control panel
- Click Start to launch your server
- The server will automatically load any mods in the mods folder
Tip: Check the console output to confirm your mods loaded successfully.
Option #2: Installing Mods on Your Own Hytale Server
If you're hosting Hytale on your own computer or dedicated server, follow these steps.
Step 1: Find Mods to Download
Download mods from trusted sources:
- CurseForge - Popular mod hosting site
- Official Hytale Discord - Community resources and mod sharing
Step 2: Stop Your Server
Before installing mods, always stop your server first:
- Type
stopin the server console, or - Press
Ctrl+Cin the terminal window
Step 3: Add Mods to the Mods Folder
- Locate your server's
mods/folder- This folder is in your main server directory alongside
HytaleServer.jar
- This folder is in your main server directory alongside
- Copy your downloaded mod files into the
mods/folder- Mods are typically
.zipor.jarfiles
- Mods are typically
- Do not extract/unzip the mod files - place them as-is
Your folder structure should look like this:
HytaleServer/ ├── HytaleServer.jar ├── Assets.zip ├── config.json ├── mods/ │ ├── CoolMod.jar │ └── AnotherMod.zip └── ...
Step 4: Start Your Server
Start your server normally. It will automatically detect and load any mods in the mods/ folder.
Check the console for:
- Confirmation that mods loaded successfully
- Any error messages if a mod failed to load
Removing Mods
To remove a mod from your server:
- Stop your server
- Delete the mod file from the
mods/folder (via FTP, File Manager, or directly) - Start your server
Note: Some mods add data to your world. Removing the mod might cause issues if your world depends on that mod's content. Always back up your world before removing mods.
Updating Mods
To update a mod to a newer version:
- Stop your server
- Delete the old mod file from
mods/ - Add the new version of the mod to
mods/ - Start your server
Tip: Check the mod's changelog before updating to see what changed and if there are any special upgrade instructions.
Understanding Mod Types
Server-Side vs Client-Side Mods
| Mod Type | Where to Install | Example Uses |
|---|---|---|
| Server-side only | Server only - players don't need anything | Admin tools, server utilities, performance tweaks |
| Client-side only | Player's game only | Visual enhancements, UI changes |
| Both required | Server AND each player's game | New items, creatures, gameplay mechanics |
Check the mod's description to see what type it is before installing.
Version Compatibility
- Mods must be compatible with your server's Hytale version
- When Hytale updates, mods may need updates too
- Always check mod pages for version compatibility before downloading
Recommended Server Plugins
These plugins are developed by professional hosting partners and add useful features:
| Plugin | What It Does |
|---|---|
| Nitrado:WebServer | Adds web application and API support to your server |
| Nitrado:Query | Shows server status and player counts via HTTP (useful for websites) |
| Nitrado:PerformanceSaver | Automatically adjusts view distance based on server performance |
| ApexHosting:PrometheusExporter | Provides detailed server and performance metrics |
Troubleshooting
Server Won't Start After Adding a Mod
- Check the logs - Look in the
logs/folder for error messages - Remove the mod - Take out the new mod and try starting again
- Version mismatch - The mod might not be compatible with your Hytale version
- Missing dependencies - Some mods require other mods to work
Mod Not Loading
- Wrong file location - Make sure the mod is directly in
mods/, not in a subfolder - Corrupted download - Re-download the mod file
- Wrong file type - Ensure it's a
.zipor.jarfile
See Also
- How to Create a Hytale Server Guide
- How to Join a Hytale Server
- Official Hytale Website
- Hytale Support & Documentation
- Rent a Hytale Server from Survival Servers