How to Install Mods on a Hytale Server

From Survival Servers
Jump to navigation Jump to search

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

  1. Log into your Survival Servers control panel
  2. 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):

  1. In your control panel, click File Manager
  2. Navigate to the mods folder
  3. Click Upload and select your mod files

Using FTP:

  1. Connect to your server using an FTP client (like FileZilla)
  2. Your FTP details are in your control panel under FTP Access
  3. Navigate to the mods folder
  4. Upload your mod files (.zip or .jar)

Step 3: Start Your Server

  1. Return to your control panel
  2. Click Start to launch your server
  3. 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:

Step 2: Stop Your Server

Before installing mods, always stop your server first:

  • Type stop in the server console, or
  • Press Ctrl+C in the terminal window

Step 3: Add Mods to the Mods Folder

  1. Locate your server's mods/ folder
    • This folder is in your main server directory alongside HytaleServer.jar
  2. Copy your downloaded mod files into the mods/ folder
    • Mods are typically .zip or .jar files
  3. 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:

  1. Stop your server
  2. Delete the mod file from the mods/ folder (via FTP, File Manager, or directly)
  3. 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:

  1. Stop your server
  2. Delete the old mod file from mods/
  3. Add the new version of the mod to mods/
  4. 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 .zip or .jar file

See Also