Hytale mods and plugins: where to put them and how to enable them

Step-by-step guide

you know where to drop a mod or plugin on your Hytale server, and when to enable the “early plugins” option.

Time : 10 minutesLevel : intermediateChecked : 17 Nov 2026 (Hytale, early access)

Before you start

  • Hytale distinguishes plugins (.jar files, which add server features) and asset packs (.zip files, which add content such as models or textures). Both go in the mods folder.
  • 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.
1

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.

2

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.

3

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.

4

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.

No Hytale server yet?

Launch yours in minutes. €1 = 1 GB.

See the Hytale plans