How to install Hytale mods and plugins
Stop your Hytale server, upload the mod's .zip or .jar file into the mods folder with Files or SFTP, then start the server and check the console.
- Difficulty:
- Beginner
- Time:
- 5 minutes
On this page
Hytale servers load mods and plugins from a folder called mods. To add one, stop the server, put the mod's .zip or .jar file into that folder, and start the server again.
Before you start
Download mods only from trusted sites, such as CurseForge, or from the author's official page.
Check that the mod supports your server's Hytale version. Hytale updates often, and an old mod can stop the server from starting.
Make a backup in Backups first, so you can go back if something breaks. See How to create and restore backups.
Install a mod with the file manager
Open your server in the Game Panel and click Stop.
Go to Files and open the
modsfolder. It sits next toconfig.json. If you can't see it, start the server once so it is created, then stop it again.Click Upload → Upload Files and choose the mod file from your device. If you have a direct download link, use Upload → Upload from URL instead.
Upload the file exactly as downloaded. Don't unzip it unless the mod's author tells you to.
Click Start and open Console. Look for lines that mention your mod loading, or for errors.
For many files or large mods, SFTP is easier. See How to connect to your server with SFTP and Using the file manager.
Configure a mod
Many mods create their own settings file the first time they load. After the first start, look in Files for new files or folders with the mod's name. Stop the server before you edit them, save, then start it again.
Remove or update a mod
Stop the server.
In Files → mods, delete the old file (or replace it with the new version).
Start the server and check the console.
Removing a mod that added blocks, items or creatures can affect worlds that already use them. Back up before removing content mods from an existing world.
If the server won't start after adding a mod
Read the last lines in Console. The error usually names the mod that failed.
Check that the mod matches your Hytale version and that any other mods it depends on are also installed.
Remove the newest mod and start again. If the server starts, that mod is the problem.
Still failing? Restore the backup you made before installing.
A mod that adds a lot of content needs more RAM. If the panel header shows memory close to the limit, consider an upgrade: open the service in the billing panel and click Upgrade Plan. Note that the Minecraft Plugins and Mods browsers are not part of a Hytale server, so Hytale mods are always added through Files or SFTP.
Frequently asked questions
What's the difference between a Hytale mod and a plugin?
For server owners it makes no difference: both go in the mods folder. Plugins are usually Java .jar files that add server features, while content packs often come as .zip files.
Do players need to install the mods too?
Hytale's modding is designed to run on the server, so in most cases players just join. Always check the mod's description, because the author says what their mod needs.
Can Endercloud support fix a broken mod?
We help with the hosting side, such as uploads, files, restarts and backups. Bugs inside a mod need to go to the mod's author.
Was this article helpful?
Related articles
Install Geyser and Floodgate from the Plugins tab, add a port with Create Allocation in Network, set it as Geyser's Bedrock port, and Bedrock players can join your Java server.
spark records what your server spends its time on and gives you a link to a report. Use /spark tps, /spark health and /spark profiler to find the plugin, mod or entity behind your lag.
Install DiscordSRV, create a Discord bot with the Server Members and Message Content intents, then put the bot token and channel ID in DiscordSRV's config.yml and restart.
On an offline-mode server, install a login plugin such as AuthMe or LibreLogin so nobody can join as you, and SkinsRestorer so players get skins back with /skin.
