Hytale mods and plugins: where to put them and how to enable them
you know where to drop a mod or plugin on your Hytale server, and when to enable the “early plugins” option.
Before you start
- Hytale distinguishes plugins (
.jarfiles, which add server features) and asset packs (.zipfiles, which add content such as models or textures). Both go in themodsfolder. - Mods are built for a specific Hytale version. After a game update, they may stop working.
- Your players may need to download or own the content: test the connection after each addition.
Find or create the mods folder
Stop the server, then open the file manager or SFTP (see “Connect over SFTP”). According to community documentation, the mods/ folder sits at the server root; if it does not exist yet, create it. Check the real location after the first authorised start.
Drop the file
Drop the plugin’s .jar file or the pack’s .zip in mods/, without unzipping it. A downloaded archive sometimes holds several files: take only the one meant for the server.
Early plugins
Some plugins under development need the Accept early plugins option on the Démarrage (Startup) screen. Hytale warns that loading early plugins is unsupported and can cause instability: only turn it on if the plugin requires it. Also turn Sentry off while developing plugins.
Restart and check
Start the server and read the Console: it reports the loading of each mod. An error names the faulty file.
If it does not work
The server crashes after an addition
remove the last file from mods/ and restart.
A plugin is ignored
it is misplaced (one sub-folder too many), or it needs early plugins.
Players can no longer join
an asset pack is missing on their side.
A mod stops working after a game update
look for the compatible version.
Questions? Get in touch
Our team will answer by message or on Discord.