How to Add Mods to Your Hytale Server

Hytale was built from the ground up with modding in mind. This guide walks you through installing mods on your Hytale server, whether you're using a hosting provider or running your own hardware.

Understanding Hytale Mods

Unlike games where modding is an afterthought, Hytale's architecture makes it easy to add custom content, gameplay mechanics, and server-side features.

Types of Mods

• Server-Side Mods: Run only on the server (admin tools, anti-cheat, gameplay tweaks)
• Client-Required Mods: Must be installed by both server and players (new items, creatures, content)
• Content Packs: Add new blocks, items, biomes, and creatures
• Gameplay Mods: Change mechanics, progression, or add new systems

Adding Mods on Hosted Servers

If you're using a Hytale hosting provider, adding mods is straightforward through their control panel.

Method 1: Control Panel Mod Manager

Most hosts offer a built-in mod browser:

1. Log in to your server control panel
2. Navigate to the Mods or Plugins section
3. Browse available mods or search by name
4. Click Install on the mods you want
5. Restart your server to apply changes

Method 2: File Manager Upload

For mods not in the browser, upload them manually:

1. Download the mod files to your computer
2. Open your host's File Manager
3. Navigate to the mods/ folder
4. Upload the mod files (.zip or .hytmod format)
5. Restart your server

Method 3: SFTP Upload

For large mods or bulk uploads, SFTP is faster:

1. Get SFTP credentials from your control panel
2. Connect with FileZilla or WinSCP
3. Navigate to mods/
4. Upload your mod files
5. Restart via control panel

Adding Mods on Self-Hosted Servers

If you're running your own server, you have direct file access.

Server Folder Structure

YourServerFolder/
├── Server/
│   └── HytaleServer.jar
├── Assets.zip
├── mods/          ← Install mods here
├── config.json
└── universe/

Installation Steps

1. Stop your server
2. Download mods from trusted sources
3. Copy mod files into the mods/ folder
4. Start your server
5. Check the console for errors or confirmations

Configuring Mods

Many mods generate config files on first run. Look in the mods/ folder for new .json or .cfg files after starting the server. Edit these with any text editor, then restart to apply changes.

Server-Side vs Client-Required Mods

Mod Type	Who Installs	Examples
Server-Only	Server admin only	Admin commands, anti-grief, economy plugins
Client-Required	Server AND all players	New items, mobs, textures, gameplay changes

For client-required mods, share download links with your players so their game versions match the server.