Skip to content
Kweebedia logo Kweebedia
Install Mods on Hytale Server - Setup Guide

Install Mods on Hytale Server - Setup Guide

Learn how to install mods and plugins on your dedicated Hytale server.

Before You Start

Section titled “Before You Start”

Make sure you have:

  • A running Hytale server (setup guide)
  • Access to your server’s file system
  • Permission to restart the server

Installation Steps

Section titled “Installation Steps”

Step 1: Find a Mod

Section titled “Step 1: Find a Mod”
  1. Visit curseforge.com/hytale
  2. Browse by category or use the search bar
  3. Filter by type (Packs, Plugins)

What to Look For

Section titled “What to Look For”
FactorWhy It Matters
DownloadsHigher numbers suggest stability
Last updatedRecent updates mean active maintenance
DescriptionClear documentation shows quality
CommentsCommunity feedback reveals issues

Check for Dependencies

Section titled “Check for Dependencies”

Some mods require other mods to function. The mod page will list these under “Dependencies” or in the description. Download all required dependencies along with the main mod.

Step 2: Download the Mod

Section titled “Step 2: Download the Mod”
  1. Click on a mod page
  2. Go to the Files tab
  3. Click the orange “Download” button
  4. Save the .jar or .zip file

Step 3: Stop Your Server

Section titled “Step 3: Stop Your Server”

Always stop your server before adding mods.

Console command:

/stop

Or: Close the server process if running locally.

Step 4: Add Mod Files

Section titled “Step 4: Add Mod Files”

Navigate to your server’s root folder and place mod files in the mods/ folder:

your-server/
├── HytaleServer.jar
├── Assets.zip
├── config.json
└── mods/           ← Put mods here
    ├── custom-blocks.jar
    └── economy-plugin.jar

Step 5: Restart and Verify

Section titled “Step 5: Restart and Verify”

Start your server:

Terminal window
java -jar HytaleServer.jar --assets PathToAssets.zip

Watch the console for:

  • Successful mod loading messages
  • Any errors or warnings

Join the server and test mod features to confirm everything works.

Hosted Server Providers

Section titled “Hosted Server Providers”

If you’re using a hosting provider, the process varies slightly:

ProviderMethod
NitradoWeb interface file manager → upload to mods/
Apex HostingControl panel file manager → upload to mods/
PebbleHostSFTP or web file manager → upload to mods/

General steps for hosted providers:

  1. Stop the server from the control panel
  2. Access the file manager (web or SFTP)
  3. Navigate to the mods/ folder
  4. Upload your .jar or .zip files
  5. Restart the server from the control panel

Check your provider’s documentation for specific instructions.

Managing Mods

Section titled “Managing Mods”

Multiple Mods

Section titled “Multiple Mods”

You can install multiple mods at once:

mods/
├── content-pack-1.jar
├── content-pack-2.jar
├── utility-plugin.jar
└── minigame-plugin.jar

Considerations:

  • Check for mod conflicts in descriptions
  • Some mods require specific load order (check documentation)
  • More mods = longer startup time

Removing Mods

Section titled “Removing Mods”
  1. Stop the server
  2. Delete the mod file from mods/
  3. Restart the server

World Data

Removing mods may affect worlds that used mod content. Backup your universe/ folder before removing mods.

Frequently Asked Questions

Section titled “Frequently Asked Questions”

Do I need to restart my Hytale server after adding mods?

Section titled “Do I need to restart my Hytale server after adding mods?”

Yes. Unlike client installations, Hytale servers must be fully stopped and restarted when adding or removing mods. Always use the /stop command or close the server process before modifying your mods/ folder.

Where do mods go on a Hytale server?

Section titled “Where do mods go on a Hytale server?”

Place mod files directly in the mods/ folder inside your server’s root directory (the same folder as HytaleServer.jar). Do not extract the files — keep them as .jar or .zip format.

Can players join my modded server without installing mods?

Section titled “Can players join my modded server without installing mods?”

Yes. Hytale modding is server-side, so players automatically receive mod content when they connect. They don’t need to download or install anything — just join your server normally.

Why isn’t my mod loading?

Section titled “Why isn’t my mod loading?”

Most commonly, the mod is in the wrong location, extracted, or the server wasn’t restarted. Ensure:

  • The file is directly in mods/ (not a subfolder)
  • The file is a .jar or .zip (not extracted)
  • The server was fully stopped and restarted

See Troubleshooting for more solutions.

Next Steps

Section titled “Next Steps”