MINECRAFTHUB.IO
Installation

How to Install Minecraft Mods on Java Edition

Install Minecraft Java mods by matching a mod loader such as Fabric, Forge, or NeoForge to the mod, then adding the jar to the right mods folder by hand or through a launcher app. Covers picking a loader, the Mac install path, updating and uninstalling mods, and what to check when a mod does not load.

A green mod jar with a tick fits its loader while a mismatched red loader socket is crossed out, and the matching jar drops into the mods folder crate

Updated

Installing Minecraft mods on Java Edition comes down to three things lining up: a mod loader that matches what the mod was built for, a mods folder with the right jar file inside it, and a game version the mod actually supports. This guide covers how to install mods on Minecraft Java Edition end to end, from picking a loader to adding mods by hand or through a launcher app, plus how to update and uninstall them later.

Pick the mod loader the mod actually needs

Java Edition mods need one of four loaders: Fabric, Forge, NeoForge, or Quilt. Each one reads its own mod file format, so a Fabric jar won't load on Forge or NeoForge, and the reverse is true too. Check the loader listed on the mod's own download page before installing anything, since that page decides which loader you need, not the other way around.

If a mod needs Fabric, our guide to installing Fabric on Minecraft Java covers the installer, Prism Launcher, and the Modrinth App, plus the difference between Fabric Loader and Fabric API. If it needs Forge or NeoForge instead, the Forge and NeoForge installation guide covers both installers and picking between the two. Fabric tends to pick up support for a new Minecraft release fastest; Forge and NeoForge often take longer to catch up, so a mod you want on the newest version may only ship on Fabric at first.

How to add mods to Minecraft Java Edition

Once the loader is installed, adding a mod is the same short process regardless of which loader you picked.

  1. 1.Install the loader the mod needs and confirm it boots to a plain, unmodded title screen.
  2. 2.Download the mod's .jar file for the same Minecraft version and loader as your profile.
  3. 3.Open the mods folder for that profile and drop the .jar file in directly. Do not unzip it.
  4. 4.Add any required dependency the mod's page lists, most commonly Fabric API for Fabric mods.
  5. 5.Launch the profile again and check Mod Menu or the loader's own mods list for errors.

Where is the Minecraft mods folder?

  • Windows: %appdata%\.minecraft\mods
  • macOS: ~/Library/Application Support/minecraft/mods
  • Linux: ~/.minecraft/mods

A launcher instance created in Prism, the Modrinth App, or the CurseForge app usually keeps its own separate mods folder instead of the shared one above, since each instance is isolated. Our mods folder guide covers every Java and Bedrock file location in full, including what to do when the folder doesn't exist yet.

How to install Minecraft mods on Mac

The steps match Windows and Linux exactly: install the loader, then drop matching mod jars into ~/Library/Application Support/minecraft/mods. The one Mac-specific snag is Gatekeeper blocking a loader installer the first time you open it, because it isn't a signed, notarized app. Right-click the installer and choose Open instead of double-clicking to get past that one-time warning.

Install mods through a launcher app instead

The Modrinth App, the CurseForge app, and Prism Launcher can skip manual jar-dropping entirely. Create a new instance, choose the loader and Minecraft version, then search for mods inside the app and click install; each one downloads the loader and adds the jar to that instance's own mods folder for you. Installing a whole curated set of mods at once works the same way through these apps; our modpack installation guide covers that route end to end, including the manual .mrpack and CurseForge zip options for packs that only ship a raw file.

How to uninstall Minecraft mods

Removing a mod is the reverse of installing it. Open the profile's mods folder, delete the .jar file for the mod you want gone, and delete any dependency jar you no longer need alongside it. Relaunch the profile and check Mod Menu or the loader's mods list to confirm it's gone. Most mods also leave a settings file behind in the profile's config folder; it's harmless to leave and safe to delete if you want a clean slate.

How to update Minecraft mods

A mod added manually doesn't update itself. Download the new version from the mod's page, matching your current loader and Minecraft version, delete the old jar first, then drop the new one into the mods folder; leaving both in place at once is a common cause of duplicate mod ID crashes. Update every required dependency, such as Fabric API, at the same time, since a mod built against a newer dependency version won't always run against an older one. The Modrinth App, the CurseForge app, and Prism Launcher all flag available updates for mods added inside that instance and can install them with one click.

Minecraft mods not working

A mod that won't load is almost always a mismatch: the wrong Minecraft version, the wrong loader, or a missing dependency like Fabric API. If Minecraft crashes on launch, our exit code 1 guide covers the common causes behind that specific crash. A pack or mod list that's grown large can also run out of memory before anything else goes wrong; see how to allocate more RAM to Minecraft if the game only starts crashing after adding several mods. For a broader first pass, the beginner troubleshooting checklist walks through crashes, black screens, and missing content step by step.

Minecraft mods on Bedrock Edition

Bedrock Edition doesn't read .jar files or use a loader at all; it adds features through behavior packs and add-ons instead, browsable in our addons section and explained fully in our Java vs Bedrock comparison.

Frequently asked questions

What do I need before installing a Minecraft mod on Java Edition?

You need the right loader installed, Fabric, Forge, NeoForge, or Quilt, matching whichever one the mod's page lists, plus a game version that matches both the mod and the loader profile. Installing the wrong loader or the wrong version is the most common reason a mod never shows up in-game.

Do I need Fabric API for every Fabric mod?

Not every one, but most. Check the dependency list on the mod's own page before installing. If Fabric API is listed as required and it's missing from your mods folder, the game usually fails to launch with an error naming the missing dependency rather than silently skipping the mod.

How do I install Minecraft mods on a Mac?

The same way as Windows and Linux: install the matching loader, then drop mod jars into ~/Library/Application Support/minecraft/mods. The only extra step is right-clicking a loader installer and choosing Open the first time, since macOS Gatekeeper can block it from opening normally.

Why isn't my mod showing up after I installed it?

Check the mods folder first; a launcher instance from Prism, the Modrinth App, or the CurseForge app keeps its own separate folder, and dropping a jar into the wrong one is the single most common cause. After that, confirm the mod's Minecraft version and loader match your profile exactly, and that any required dependency is installed alongside it.

Can I install Minecraft mods on Bedrock Edition?

No. Bedrock Edition has no mod loader and can't read .jar files; it uses behavior packs and add-ons instead, which install by opening the file with Minecraft rather than copying it into a mods folder.

Resources mentioned.

Related guides.