How to Install Minecraft Mods on Java Edition (2026 Guide)

Quick answer: To install Minecraft mods on Java Edition, pick a mod loader (Forge, Fabric, or NeoForge), run its installer to create a modded launcher profile, download mod .jar files from CurseForge or Modrinth that match your exact game version and loader, drop them into the .minecraft/mods folder, and launch the game with the modded profile. The whole process takes about 10–15 minutes once you know the steps.

Installing mods is what turns Minecraft Java Edition from a great game into a nearly endless one. New creatures, new dimensions, better performance, total gameplay overhauls — all of it is a few downloads away. The catch is that mods don’t install themselves like apps from a store: you need a mod loader first, and every mod must match your game version and loader exactly.

This guide walks you through the entire process from a clean install to a working modded game, including how to fix the most common crashes. It covers Minecraft Java Edition on PC (Windows, macOS, and Linux) as of 2026.

What You Need Before You Start

• Minecraft: Java Edition — purchased and installed through the official Minecraft Launcher. Mods do not work on the trial/demo version.
• A PC — mods are a Java Edition feature, so you need Windows, macOS, or Linux. (Bedrock on phones, consoles, and the Windows Store version uses add-ons instead — a completely different system.)
• Java — good news: the official Minecraft Launcher installs the correct Java runtime automatically. You do not need to download Java yourself for playing; current versions (26.x) run on Java 25, which the launcher handles.
• Enough storage and RAM — mods add files and memory usage. 4 GB of allocated RAM is a comfortable minimum for a lightly modded game; heavy modpacks want 6–8 GB.

Step 1: Choose a Mod Loader

A mod loader is the framework that lets mods run inside Minecraft. Think of it as the power strip that mods plug into. There are four main options, and mods built for one loader do not work on another — so choose before you download anything.

Loader	Best for	Version focus	Notes
Forge	Huge legacy mod library	1.20.1 and older	The original loader with the most mods ever made; best if you want classic, well-established mods
NeoForge	Modern large-scale mods	1.20.2 and newer (including 26.x)	A community-driven successor to Forge; the default choice for new modded setups in 2026
Fabric	Performance and lightweight setups	All recent versions	Fast, minimal, and quick to update; most Fabric mods also need the Fabric API mod
Quilt	Experimental / community fork	Recent versions	Smaller ecosystem; only choose it if a specific mod requires it

Simple rule of thumb: playing on 1.20.1 or older and want the biggest classic mod selection? Pick Forge. Starting fresh on a current version like 26.x? Pick NeoForge. Want a fast, minimal setup with performance mods like Sodium? Pick Fabric. When in doubt, check which loader the mods you want actually support — that decides it for you.

Step 2: Install the Mod Loader

1. Go to the loader’s official website (files.minecraftforge.net for Forge, fabricmc.net for Fabric, neoforged.net for NeoForge). Never download loaders from random mirror sites.
2. Download the installer for your chosen Minecraft version. (Note: in 2026 Mojang switched to calendar versioning, so current releases are numbered 26.1, 26.2, 26.3 instead of the old 1.2x scheme — pick the installer matching the game version you want to play.)
3. Run the installer file. Select “Install client” and confirm the Minecraft directory it points to (the default is correct for almost everyone).
4. Open the Minecraft Launcher. Click the dropdown next to the Play button and select the new profile it created (it will be named something like “forge”, “fabric-loader”, or “neoforge”).
5. Press Play once with the modded profile, let the game load to the main menu, then close it. This generates the mods folder you’ll need next.

Minecraft 1.20.1 · Forge · v47.4.10 (Recommended) · Official download

Universal installer · Fabric · v1.1.0 · Official download

Minecraft 26.3 · NeoForge · v26.3.0.92 · Official download

Step 3: Download Mods Safely

Where you get mods matters more than anything else for your computer’s safety. Stick to these two verified sources and ignore everything else:

• CurseForge (curseforge.com) — the largest mod repository, with version filtering built in.
• Modrinth (modrinth.com) — a modern, open-source alternative popular with Fabric and performance mods.

For every mod you download, check three things on its page before clicking download:

1. Game version — the mod’s file must list your exact Minecraft version (e.g. 26.3, not just “26.x”). A 1.20.1 mod will crash a 26.3 game.
2. Loader — the file must be built for your loader (Forge, Fabric, or NeoForge). This is the single most common cause of crashes.
3. Dependencies — many mods require library mods to work. Fabric mods almost always need Fabric API; others may need libraries like GeckoLib or Cloth Config. The mod page lists these under “Dependencies” or “Relations” — download and install them the same way.

⚠️ Download safety: Only download mods from CurseForge, Modrinth, or a mod author’s official page. Avoid “free mods” APK sites, repack blogs, and Discord download links — repackaged files are a common source of malware. And never type passwords or personal information into any in-game mod chat: mod dialogue can be sent to external servers.

Step 4: Install the Mod Files

1. Open your .minecraft folder. The fastest way: in the Minecraft Launcher, go to Installations, hover over your modded profile, click the folder icon — or press Win + R, type %appdata%\.minecraft (Windows) and press Enter. On macOS it’s ~/Library/Application Support/minecraft; on Linux, ~/.minecraft.
2. Open the mods folder inside it. (If Step 2’s test launch worked, this folder exists. If not, create it manually.)
3. Copy or drag your downloaded .jar files into the mods folder. Do not unzip them — mods go in as .jar files.
4. Repeat for every mod and every dependency library.

Step 5: Launch and Verify

1. In the Minecraft Launcher, make sure your modded profile (forge / fabric-loader / neoforge) is selected — not the vanilla “Latest release” profile.
2. Press Play. The first launch with mods takes longer than usual; that’s normal.
3. On the main menu, look for a “Mods” button. Click it: you should see every mod you installed listed with its version number. If the list matches what you put in the folder, everything loaded correctly.
4. Create a new test world first rather than opening your main survival world — this lets you confirm the mods work without risking an existing save.

What About Bedrock Edition?

This guide is for Java Edition only. Bedrock (phones, consoles, Windows Store version) doesn’t use mod loaders or .jar files at all — it uses .mcaddon add-on packages imported directly into the game, often with Beta APIs and cheats enabled. If you’re on Bedrock, the steps above don’t apply; look for our Bedrock-specific guides instead.

Troubleshooting: Fixing Common Mod Problems

1. The game crashes immediately on launch (“Exit Code 1”)

This is almost always a version or loader mismatch. Check the crash report in .minecraft/crash-reports: look for lines mentioning a mod name plus words like “requires” or “incompatible.” The fix is usually removing the offending mod and downloading the file built for your exact game version and loader. Also confirm your launcher profile is the modded one, not vanilla.

2. “Missing dependency” errors

The crash message names a library the mod needs (e.g. “requires fabric-api” or “requires geckolib”). Download that library from CurseForge or Modrinth — matching your game version and loader — and drop its .jar into the mods folder alongside the mod.

3. Mods folder is empty or mods don’t appear in the Mods menu

Two likely causes: you launched the wrong launcher profile (vanilla instead of the modded one), or you placed the .jars in the wrong .minecraft folder (this happens if you have multiple installs). Re-check the profile dropdown and use the launcher’s folder icon to open the exact directory that profile uses.

4. The game launches but lags badly

Mods cost performance. Start by allocating more RAM: in the launcher, go to Installations → your modded profile → More Options → JVM Arguments and change -Xmx2G to -Xmx4G (or 6G for big packs). If it’s still slow, add performance mods like Sodium (Fabric) or Embeddium (Forge/NeoForge) — but remove only mods you can live without; more mods always means more load.

5. A mod works, but another one breaks when both are installed

That’s a mod conflict. Remove half your mods, test, and narrow it down by halves until you find the pair that clashes. Check both mods’ pages for known incompatibilities — and keep a backup of your world before testing combinations.

Frequently Asked Questions

Are Minecraft mods free?

Yes — the loaders (Forge, Fabric, NeoForge) and the vast majority of mods are completely free. You only need to own Minecraft: Java Edition itself.

Can I get banned for using mods?

Not on single-player or your own worlds — Mojang allows modding. On multiplayer servers, the server owner sets the rules: many modded servers require specific mods, while vanilla/minigame servers may kick you for unapproved ones. When in doubt, ask the server’s staff.

Do mods work in multiplayer?

Yes, but everyone connecting needs the same mods (and the same versions) installed. The server itself also needs the loader and any server-side mods. The simplest reliable route for playing modded with friends is a modpack everyone installs identically.

Which mod loader is best for beginners in 2026?

NeoForge if you’re starting on a current version and want the widest modern mod support, or Fabric if you want something lightweight and fast. Forge remains the right pick for 1.20.1 and older, where its library is unmatched. Our comparison table above covers the trade-offs.

Can I use mods and shaders at the same time?

Yes. On Fabric, install Sodium plus the Iris mod; on Forge/NeoForge, use Embeddium plus Oculus. Then drop shader packs into the shaderpacks folder the same way you installed mods.

Do I need to update my mods when Minecraft updates?

Yes — mods are version-locked. When you move to a new Minecraft version, you must download new mod files built for that version (and the matching loader release). Many players keep a separate launcher installation per Minecraft version so old setups keep working.

Once you’re comfortable with the basics, the real fun starts: horror mods like Verity add an AI companion that talks back and slowly turns sinister, and there are thousands more mods across every genre waiting in the same mods folder you just learned to use.