How to Install Minecraft Mods (Fabric and Forge)

Installing mods is the single biggest upgrade you can make to Java Edition, and it takes about five minutes once you know the steps. The part that trips people up is not the installing — it is picking the right mod loader and matching versions. Get that right and everything else falls into place.

Step 1: choose a mod loader

Vanilla Minecraft cannot load mods by itself. A loader patches the game so it can. There are two you will actually meet:

• Fabric — lightweight and updates to new Minecraft versions within days. Almost every performance mod targets Fabric first. This is the right default for most people.
• Forge — older and heavier, but it is where the huge content modpacks live. If you specifically want a large kitchen-sink pack, you will likely need Forge.
• NeoForge — a Forge fork that many large packs have moved to. Treat it like Forge for installation purposes.

You cannot mix them. A Fabric mod will not load on Forge, and vice versa. If a mod page mentions both, it means separate downloads exist for each.

Step 2: install the loader

1. 1.Download the installer for your chosen loader.
2. 2.Run it and select the Minecraft version you want to play — this must match the version your mods were built for.
3. 3.The installer creates a new profile in the Minecraft Launcher. It does not touch your vanilla install.
4. 4.Open the launcher, select that new profile from the dropdown, and launch once. Let it reach the main menu, then quit.

That first launch matters. It generates the folders the next step needs.

Step 3: find your mods folder

Mods live in a folder called mods inside your Minecraft directory:

• Windows — press Win+R, type %appdata%\.minecraft and hit enter.
• macOS — ~/Library/Application Support/minecraft
• Linux — ~/.minecraft

If there is no mods folder, create one. It only appears automatically after a modded launch.

Step 4: add Fabric API first

This is the step almost everyone misses. Fabric API is a shared library that the large majority of Fabric mods depend on. It is not bundled with the loader — you install it as a mod, exactly like any other, by dropping the .jar into the mods folder.

If you skip it, the game will crash on startup with a message about a missing dependency. Forge does not need an equivalent; its API ships with the loader.

Step 5: drop in your mods

Download the .jar files and put them in the mods folder. Do not unzip them — a mod is meant to stay a .jar. Every mod on our Mods page is hosted directly on MineSpecs, so downloads do not bounce you through an ad-gate or a redirect chain.

Launch the game with your modded profile. If everything matched, you will see the mod count on the title screen or in a Mods button.

The four errors you will actually hit

"Incompatible mod set" or a missing-dependency crash. A mod needs something you have not installed — usually Fabric API. The crash log names the missing dependency; read the first few lines and install what it asks for.

Wrong Minecraft version. A mod built for 1.21.4 will not load on 1.21.1. Check the version on the download page against your profile.

Wrong loader. Fabric jar in a Forge install, or the reverse. Nothing loads, or the game crashes immediately.

Two mods that do the same job. Running two rendering optimisers, or two of the same library at different versions, causes conflicts. Add mods in small batches and launch between batches, so you know which one broke it.

A good first set of mods

If you just want the game to run better, start with these three from our Mods catalogue:

• Sodium — a rewrite of the rendering engine. Frequently doubles frame rates on its own.
• Lithium — optimises the game's server-side logic and tick performance, with no visual change.
• Iris — adds shader support and works alongside Sodium, so you gain frames *and* get shaders.

With Iris installed you can go straight to our Shaders page and drop a pack into the shaderpacks folder. If you want more frames before more visuals, our FPS guide covers the settings that matter most.

Keeping a modded setup healthy

Back up your world folder before adding mods to an existing save — some mods add blocks and items, and removing them afterwards can leave holes. Update mods together rather than one at a time, and keep a note of which versions worked. When a modded save breaks, the fastest fix is almost always going back to the last combination you know launched.