Installing Mods on Your Hytale Server

Hytale Server Modding

Mods extend Hytale with new items, creatures, mechanics, and gameplay features. This guide covers every method for installing and managing mods on your RespawnHost Hytale server.

Installing Mods via the Marketplace (Recommended)

The easiest way to install mods — no manual downloads or uploads needed:

1. Open the RespawnHost panel and select your Hytale server
2. Navigate to the Marketplace tab
3. Browse available mods or search by name
4. Click Install on the mod you want
5. The mod is downloaded automatically and placed in the correct directory
6. Restart the server to activate the mod

The Marketplace automatically checks compatibility with your server version. You can see at a glance which mods are installed and their versions.

Installing Modpacks with the One-Click Installer

Complete modpacks can be installed with the One-Click Installer in the panel:

1. Open the RespawnHost panel and select your server
2. Navigate to the Modpacks tab
3. Choose from the available modpacks
4. Click Install
5. The modpack is fully installed — including all mods, configs and dependencies
6. Restart the server

The One-Click Installer ensures all mods in the modpack are compatible and the correct versions are installed.

Before You Begin

Before installing mods, consider:

• RAM requirements increase with each mod. If you are running close to your RAM limit, upgrade your package first. See RAM Requirements.
• Client-side requirement — Most mods must be installed on both the server and every player’s client. Mods that only run server-side are rare.
• Version matching — All mods must be compatible with the same Hytale version. Mixing versions causes crashes.
• Back up your world before adding or removing mods. See World Management for backup instructions.

CurseForge Mods (Manual)

For mods not available in the Marketplace, you can use CurseForge:

1. Download the mod file from CurseForge. Ensure it matches your server’s Hytale version.
2. Open the File Manager in the RespawnHost panel.
3. Navigate to the server’s mod directory (serverconfig/mods/).
4. Upload the mod file (typically a .jar or .zip).
5. Restart the server.

Alternatively, connect via SFTP and upload files using your preferred FTP client.

Manual Upload

For mods from any other source:

1. Download the mod from the author’s website or repository.
2. Verify the mod is designed for server-side use (not client-only).
3. Open the File Manager or connect via SFTP.
4. Upload the mod file to serverconfig/mods/.
5. Restart the server.

Managing Installed Mods

Viewing Installed Mods

The Marketplace and Mods tabs in the panel list all installed mods with their names, versions, and status (enabled/disabled).

Disabling a Mod

To temporarily disable a mod without removing it:

1. Go to the File Manager.
2. Navigate to serverconfig/mods/.
3. Rename the mod folder and append .disabled (e.g., mod-name.disabled).
4. Restart the server.

Removing a Mod

1. Go to the File Manager.
2. Navigate to the mods directory.
3. Delete the mod file or folder.
4. Restart the server.

Be cautious when removing mods from an active world. Some mods generate world content that may cause errors if the mod is removed while that content exists.

Updating Mods

1. Check the mod author’s page for new versions.
2. Remove the old mod file from the server.
3. Upload the new version (or reinstall via the Marketplace).
4. Restart the server.

The Marketplace handles updates automatically if the mod is in its catalog.

Mod Compatibility

Checking Compatibility

Not all mods work together. Before installing multiple mods:

• Check each mod’s documentation for known incompatibilities.
• Test mod combinations on a fresh server before adding them to your main world.
• Read community forums for compatibility reports.

Common Compatibility Issues

Issue	Cause	Solution
Server crash on startup	Conflicting mods	Remove mods one by one to identify the conflict
Missing items in world	Removed a mod that generated items	Reinstall the mod or clean the world data
Client disconnect	Client missing required mods	Ensure all players install the same mods
Performance drop	Heavy mods stacking	Reduce mod count or upgrade RAM

Resolving Conflicts

When two mods conflict:

1. Check if either mod has a compatibility patch.
2. Try loading the mods in a different order.
3. Contact the mod authors — they may release a fix.
4. Choose one mod over the other if no fix is available.

Mod Categories

Hytale mods generally fall into these categories:

Category	Description	RAM Impact
Quality of Life	UI improvements, inventory tweaks	Low
Content	New items, blocks, creatures	Medium
Mechanics	New gameplay systems, progression	Medium-High
World Generation	Custom biomes, structures, terrain	High
Total Conversion	Complete overhaul of gameplay	Very High
Administration	Server tools, logging, moderation	Low

Troubleshooting

Server Crashes After Installing a Mod

1. Check the console for error messages.
2. Identify which mod is causing the crash from the stack trace.
3. Remove that mod and restart.
4. Report the issue to the mod author.

Players Cannot Connect After Adding Mods

Players need the same mods installed on their clients. Provide a mod list or modpack download for your community.

Performance Degradation

Monitor RAM usage in the panel metrics tab. If usage increases significantly after adding mods, consider upgrading your package. See RAM Requirements for recommendations.

Frequently Asked Questions

Do all players need the same mods?

For most mods, yes. Both the server and every connecting player must have the same mods installed. Server-only administration mods are an exception.

How many mods can I run?

This depends on your RAM and the mod complexity. As a rough guide: 6 GB handles light modding (under 10 mods), 12 GB handles medium modding (10-30 mods), and 24+ GB handles heavy modpacks.

Can I use a modpack?

Yes. Install modpacks via the One-Click Installer in the panel, or upload the modpack’s server files manually to the mods directory. Ensure all players also install the client-side modpack.

Where do I find Hytale mods?

The Marketplace in the panel provides a curated selection of popular mods with one-click installation. Additional mods are available on CurseForge and modding community forums.

What is the difference between the Marketplace and manual upload?

The Marketplace installs mods with one click — automatically, version-checked, and with no downloads required. Manual upload is for mods not available in the Marketplace.