How to Install Minecraft Mods: Complete Beginner’s Guide (2026)

Here is a fact that trips up more beginners than anything else: the number-one reason mods don’t work is a version mismatch — the mod is built for Minecraft 1.20.1 but you’re running 1.21.4. That five-second check before you download anything will save you hours of frustrated troubleshooting. Once you’ve got that habit locked in, installing mods is genuinely straightforward. This guide walks you through the whole process, from picking a mod loader to dropping your first .jar file in the right folder.

Java vs Bedrock: What You Can Actually Mod

Before anything else, you need to know which edition of Minecraft you’re running — because the answer changes everything.

Java Edition is the version sold on the Minecraft website for PC. It has full, unrestricted mod support. Thousands of mods exist for it, ranging from small quality-of-life tweaks to total game overhauls that barely resemble vanilla Minecraft.

Bedrock Edition is the version on consoles, mobile, and the Microsoft Store version for Windows. It only supports "add-ons" — a limited system controlled by Mojang. Add-ons can change textures, sounds, and some gameplay behaviour, but they’re nowhere near as powerful as Java mods. You cannot install Java mods on Bedrock.

If you bought Minecraft on an Xbox, PlayStation, Nintendo Switch, or phone, you have Bedrock. If you want real mods, Java Edition is the only path. It costs around $30 and is available at minecraft.net. [1]

Choosing Your Mod Loader

Java Edition doesn’t support mods natively — you need a mod loader installed between Minecraft and your mods. There are three main ones in 2026:

Forge is the original mod loader, around since 2011. It has the largest historical mod library of any loader. That said, its development has slowed and it’s considered legacy for newer Minecraft versions. If you want to play older modpacks (pre-1.20), Forge is often still your best bet.

Fabric is lightweight and updates fast. It’s popular for performance mods (like Sodium and Lithium) and utility mods. The Fabric ecosystem moves quickly — new Minecraft versions typically get Fabric support within days of release. Fabric mods often require a separate Fabric API mod to function, which you add to your mods folder alongside your other mods. [2]

NeoForge is the successor to Forge, forked in 2023 by nearly the entire original Forge development team. For Minecraft 1.20.5 and later, NeoForge has become the de-facto standard — the majority of major new mods and modpacks target it. If you’re playing on a recent version (1.21+), NeoForge is the loader to start with.

The simple rule: check what mod loader your target mod requires, then install that one. Our Forge vs Fabric guide goes deeper if you want a full comparison. [3]

Step-by-Step: Installing Mods on Java Edition

I’ll use NeoForge as the example here since it’s the current standard, but the process is identical for Forge and Fabric — just download the installer from the relevant site.

1. Check your Minecraft version. Launch Minecraft and look at the bottom-left corner of the main menu. Note the exact version number (e.g. 1.21.4). You need to match mods and your loader to this number precisely.
2. Make sure Java is installed. Minecraft 1.17+ bundles its own Java runtime, but mod loaders typically need Java installed separately on your system. Download the latest version of Java from java.com. [4]
3. Download the mod loader installer. Go to the official site for your loader:
   • NeoForge: neoforged.net
   • Forge: files.minecraftforge.net
   • Fabric: fabricmc.net/use/installer

   Select the version that matches your Minecraft version and download the installer.

4. Run the installer. Open the downloaded file and follow the prompts. The installer will automatically locate your Minecraft directory and create a new launch profile. You don’t need to change anything unless your Minecraft folder is in a custom location.
5. Download your mod. Use only CurseForge (curseforge.com) or Modrinth (modrinth.com) — more on why below. On the mod’s page, check the supported versions and loader carefully, then download the correct .jar file. Do not extract it. [5]
6. Find your mods folder.
   • Windows: Press Win+R, type %appdata%\.minecraft\mods, and press Enter. If the mods folder doesn’t exist, create it.
   • Mac: Open Finder, press Cmd+Shift+G, and navigate to ~/Library/Application Support/minecraft/mods.
   • Linux: Navigate to ~/.minecraft/mods.
7. Drop the .jar file into the mods folder. That’s it — no extraction, no installation wizard. Just copy the file in. If you’re using Fabric, also add the Fabric API .jar to the same folder (download it from Modrinth).
8. Launch Minecraft using the mod loader profile. Open the Minecraft Launcher, click the dropdown next to the Play button, and select the NeoForge/Forge/Fabric profile. Click Play.
9. Verify the mod loaded. From the main menu, click Mods (the button appears once a loader is installed). Your mod should appear in the list. If it does — you’re done.

Where to Download Mods Safely

There are only two places you should download Minecraft mods: CurseForge and Modrinth. Both platforms review uploaded files and have active moderation. [5]

Avoid downloading mods from:

• Random websites that appear in Google results
• YouTube video descriptions (unless the link goes directly to CurseForge or Modrinth)
• Sites like 9minecraft.net — these are known for rehosting mods with malware added

When reading a mod’s page, pay attention to: the supported Minecraft versions, the required mod loader, whether it lists any required dependencies (like Fabric API — you need to install those too), and the download count. A mod with millions of downloads that has been around for years is a far safer choice than a brand-new upload with 50 downloads.

Installing Mods on Bedrock (Add-Ons)

Bedrock add-ons work differently. There’s no mod loader — Minecraft handles them natively.

1. Download the add-on file. It will have an .mcpack or .mcaddon extension.
2. Double-click the file. Windows will automatically open it in Minecraft and import it. On mobile, tap the file and choose to open it with Minecraft.
3. You’ll see a notification confirming the import was successful.
4. Open a world (or create a new one), go to Add-Ons or Resource Packs / Behaviour Packs in the world settings, and enable the pack.

Add-ons are much more limited than Java mods — they can’t add entirely new mechanics or change core systems the way Java mods can. If you were hoping to install something like OptiFine or Biomes O’ Plenty on Bedrock, that’s not possible. The Marketplace in Bedrock does offer some paid add-ons with more polish, but they’re still constrained by what Mojang allows. [1]

Troubleshooting Common Issues

If something goes wrong, here’s where to start:

The crash log is your best friend. Minecraft writes a detailed log every time it crashes — search it for the word "caused by" and you’ll usually find the culprit mod or missing dependency named directly.

Once you’ve got mods working, you might want to explore what’s possible. Our complete beginner’s guide covers the rest of vanilla Minecraft, and our redstone guide is worth reading once you’ve got a stable modded setup running. [2]

Conclusion

Installing Minecraft mods isn’t complicated once you understand the version-matching rule and know which mod loader to use. For 1.21+, start with NeoForge; for performance mods and quick updates, go Fabric; for legacy modpacks, Forge still works. Always download from CurseForge or Modrinth, always match your mod version to your Minecraft version, and read the crash log when something goes wrong. With those habits in place, you’ll be running a full modded setup in under ten minutes.

If you want to share your mods with others, check out our guide to server setup — it covers everything from running a server on your own hardware to hosted alternatives.

Sources

• Microsoft. Installing Add-Ons in Minecraft Bedrock Edition. Microsoft Learn.
• Fabric Documentation. Finding Trustworthy Mods. FabricMC.
• NeoForged Team. NeoForge — Neo Modding API for Minecraft. NeoForged.net.
• Oracle. Download Java. Java.com.
• CurseForge. How to Install Minecraft Mods (Java & Bedrock Guide). CurseForge Blog.

References

1. Microsoft. Installing Add-Ons in Minecraft Bedrock Edition. Microsoft Learn.
2. Fabric Documentation. Finding Trustworthy Mods. FabricMC.
3. NeoForged Team. NeoForge — Neo Modding API for Minecraft. NeoForged.net.
4. Oracle. Download Java. Java.com.
5. CurseForge. How to Install Minecraft Mods (Java & Bedrock Guide). CurseForge Blog.

Michael R.

I've been playing video games for over 20 years, spanning everything from early PC titles to modern open-world games. I started Switchblade Gaming to publish the kind of accurate, well-researched guides I always wanted to find — built on primary sources, tested in-game, and kept up to date after patches. I currently focus on Minecraft and Pokémon GO.