Skip to content
Kweebedia logo Kweebedia
Install Hytale Mods on PC - Client Setup Guide

Install Hytale Mods on PC - Client Setup Guide

Install Hytale mods for your singleplayer worlds with this complete guide.

Quick Start: CurseForge App

Section titled “Quick Start: CurseForge App”

The easiest way to install mods is with the CurseForge App:

  1. Download the CurseForge App
  2. Install and open the app
  3. Find Hytale in the game menu
  4. Browse mods and click “Install”
  5. Click “Play” to launch with your mods

The app handles downloading, file placement, and updates automatically.

Manual Installation

Section titled “Manual Installation”

Prefer to manage mods yourself? Follow these steps.

Step 1: Find a Mod

Section titled “Step 1: Find a Mod”
  1. Visit curseforge.com/hytale/mods
  2. Browse by category or use the search bar
  3. Filter by type (Packs, Plugins)

What to Look For

Section titled “What to Look For”
FactorWhy It Matters
DownloadsHigher numbers suggest stability
Last updatedRecent updates mean active maintenance
DescriptionClear documentation shows quality
CommentsCommunity feedback reveals issues

Check for Dependencies

Section titled “Check for Dependencies”

Some mods require other mods to function. The mod page will list these under “Dependencies” or in the description. Download all required dependencies along with the main mod.

Step 2: Download the Mod

Section titled “Step 2: Download the Mod”
  1. Click on a mod page
  2. Go to the Files tab
  3. Click the orange “Download” button
  4. Save the .jar file

Step 3: Install the Mod

Section titled “Step 3: Install the Mod”
  1. Open your Hytale Launcher
  2. Click the cogwheel icon in the top left corner
  3. Click “Open Directory”
  4. Navigate to UserData/Mods
  5. Move the downloaded .jar file into this folder

Folder Locations

Section titled “Folder Locations”
PlatformPath
Windows%appdata%\Hytale\UserData\Mods
macOS~/Library/Application Support/Hytale/UserData/Mods
Linux~/.local/share/Hytale/UserData/Mods

Step 4: Enable the Mod in Game

Section titled “Step 4: Enable the Mod in Game”
  1. Launch Hytale (or return to main menu if already open)
  2. Click “Worlds” from the main menu
  3. Open world settings:
    • New world: Click the cogwheel next to the name field
    • Existing world: Right-click your world
  4. Look at the bottom left — your installed mods are listed there
  5. Tick the mods you want to use
  6. Launch the world

That’s it! Your mods are now active.

Managing Mods

Section titled “Managing Mods”

Multiple Mods

Section titled “Multiple Mods”

You can install as many mods as you want:

UserData/
└── Mods/
    ├── cool-blocks.jar
    ├── new-creatures.jar
    └── weather-effects.jar

Enable or disable each mod individually in world settings. Some mods may conflict — check mod descriptions for compatibility notes.

Removing Mods

Section titled “Removing Mods”
  1. Delete the .jar file from UserData/Mods
  2. The mod will no longer appear in world settings

World Data

Worlds that used mod content may behave unexpectedly after removing the mod. Keep a backup before removing mods from worlds you care about.

Version Compatibility

Section titled “Version Compatibility”

Only install mods made for your Hytale version. Check the mod’s CurseForge page to verify it supports your game version. Mixing versions may cause crashes.

Frequently Asked Questions

Section titled “Frequently Asked Questions”

Where is the Hytale mods folder?

Section titled “Where is the Hytale mods folder?”

The mods folder is at UserData/Mods inside your Hytale directory. The easiest way to find it: open the Hytale Launcher, click the cogwheel icon, then “Open Directory”, and navigate to UserData/Mods. Create the folder manually if it doesn’t exist.

How do I enable mods in Hytale?

Section titled “How do I enable mods in Hytale?”

After placing mod files in your UserData/Mods folder, go to the main menu and click “Worlds”. Open world settings (cogwheel for new worlds, right-click for existing). Your installed mods appear in the bottom left — tick the ones you want to enable.

Can I use multiple mods at once?

Section titled “Can I use multiple mods at once?”

Yes. Install as many mods as you want in UserData/Mods. Enable or disable each mod individually per world. Some mods may conflict — check mod descriptions for compatibility notes.

Why isn’t my mod showing up?

Section titled “Why isn’t my mod showing up?”

Most commonly, the mod is in the wrong location or has been extracted. Ensure:

  • The file is directly in UserData/Mods (not a subfolder)
  • The file is a .jar (not extracted/unzipped)
  • You’re on the main menu before checking world settings

See Troubleshooting for more solutions.

Next Steps

Section titled “Next Steps”