Skip to content Nodecraft

How to Install Hytale Mods

Support / Hytale / Mods / How to Install Hytale Mods
Hytale Icon
Create a Hytale Server today!
Start Free Trial

Modding is one of the best ways to customize your Hytale experience, from adding new features to changing how the game plays on your server or in single player. This guide walks through where to find Hytale mods and how to install them on your server and game client. You will also learn how mod installation differs across Windows, macOS, and Linux, along with how easily install them through the Nodecraft dashboard. Let's get started!

Where to Find Mods

Right now, the best place to get mods for Hytale is on Curseforge. You can view and download mods here. When you download mods, they can come in either a zip or jar file. 

You can find Curseforge mods directly through the Nodecraft dashboard! They are available as a one-click install.

Manual Mod Installation

Using the Mod Manager

  1. Open your Dashboard

  2. Locate your Hytale server and click on the Panel button. 

  3. On your panel click on the Mods tab.

    The Nodecraft control panel for a Hytale server with the Mods navigation option highlighted.

  4. Once on the mods click on Install from Curseforge.

    Nodecraft's Hytale mod manager part of a hytale server dashboard with an install from Curseforge button.

  5. Search the mod list for the mod you want to install or use the available search box to look for something specific.

  6. Once you locate the mod you’d like to install, click the Install button to the right.

    The CurseForge Mod Manager for a Hytale server located on the Nodecraft dashboard with various Hytale mods listed with Install buttons.

  7. The install is complete when you see Installed. You can then start/restart your server to enable the mod. 

Using the File Manager 

  1. Open your Dashboard

  2. Locate your Hytale server and click on the Panel button.

  3. Once on your panel, Stop your server then locate and click on Server FIles tab on the left-hand sidebar.

    The Nodecraft control panel for a Hytale server with the Server Files navigation option highlighted.

  4. Once the server files have loaded, double click on the Mods folder to open it.

    Nodecraft File Manager displaying the mods folder for a Hytale server.

  5. Click on Upload then drag and drop your downloaded mod(s) or click Choose FIles to manually select the files to upload.

    Uploading mod files to the Hytale server mods folder in the Nodecraft File Manager.

  6. Once uploaded, you can Start the server. 

You have now installed mods on your Hytale server. 

Installing Mods onto Your Game

Windows

  1. Locate the mods folder which can be done two different ways. 

    • Manual location of the mods folder: C:\Users\<windows user>\AppData\Roaming\Hytale\UserData\Mods

    • Click on the gear icon in the Hytale launcher in the upper left corner then select Open Directory which will open an explorer window where you can then open the Mods folder.

      Hytale launcher main screen showing the settings gear icon.Hytale launcher settings menu with the Open Directory option selected.

  2. Now that you are in the mods folder you can copy the downloaded mods.

  3. Once all mods are copied, return to the launcher and click Play.

MacOS

  1. Locate the mods folder which can be done two different ways. 

    • Manual location of the mods folder: /Users/<username>/Library/Application\ Support/Hytale/UserData/Mods

    • Click on the gear icon in the Hytale launcher in the upper right corner then select Open directory which will open a finder window where you can then open the Mods folder.

      Hytale launcher home screen with the settings gear icon highlighted.

  2. Now that you are in the mods folder you can copy the downloaded mods.

  3. Once all mods are copied, return to the launcher and click Play.

Linux

  1. Locate the mods folder which can be done two different ways. 

    • Manual location of the mods folder: /home/<user>/.var/app/com.hypixel.HytaleLauncher/data/Hytale/UserData/Mods 

    • Click on the gear icon in the Hytale launcher in the Left right corner then select Open directory which will open a file browser window where you can then open the Mods folder.

      Hytale launcher main screen showing the settings gear icon.

  2. Now that you are in the mods folder you can copy the downloaded mods.

  3. Once all mods are copied, return to the launcher and click Play.

Enabling Mods on Single Player worlds

By default, mods will not be enabled on new or existing single player worlds. Follow the steps below to learn how to enable them!

New World

  1. Open Hytale.

  2. Select Worlds.

    Hytale main menu with the Worlds option highlighted.

  3. Select your gamemode, enter a name then select gear icon next to the name input box.

    Hytale Create World screen showing the world settings gear icon.

  4. Once on the world settings, check the box for the mods that you would like to be enabled.

    Hytale world settings screen showing the Save World Settings button.

  5. Once done, click APPLY SETTINGS, then CREATE WORLD.

    Hytale world settings screen showing the Apply Settings button.

Existing World

  1. Open Hytale.

  2. Select Worlds.

  3. Locate the world to which you want to enable the mods on.

  4. Right click on the world you want to enable the mods on to open the world settings. 

  5. Once on the world settings, check the box for the mods that you would like to be enabled.

    Hytale world settings screen showing the Mods section for enabling mods.

  6. Once done, click SAVE WORLD SETTINGS.

    Hytale world settings screen showing the Apply Settings button.

Conclusion

You now know how to find, install, and enable mods for Hytale across servers and clients. From using the built in mod manager to uploading files manually, you have multiple ways to customize your server to fit your playstyle. Mods open the door to new mechanics, content, and quality of life improvements, allowing you to shape your Hytale world exactly how you want it!

Need Help?

If you have questions or run into any issues, our support team is here to help! Reach out using the support widget on our website or visit our support center for further assistance.