Independent Minecraft community. Not affiliated with Mojang or Microsoft.

Mods

How to Install Mods in Minecraft Java: A Complete Guide

In this guide, you'll learn exactly how to install mods in Minecraft: Java Edition, from picking the right mod loader to launching your first heavily modded world. You'll also learn where to find safe mods, how to fix the most common

In this guide, you'll learn exactly how to install mods in Minecraft: Java Edition, from picking the right mod loader to launching your first heavily modded world. You'll also learn where to find safe mods, how to fix the most common crashes, and why modding works completely differently on Bedrock Edition.

01

What You Need to Know First

Minecraft: Java Edition supports full modding. Bedrock Edition (the version on consoles, phones, and the Microsoft Store) does not — it only supports "add-ons" and Marketplace content, which are far more limited. Everything below applies to Java Edition on PC, Mac, or Linux.

Mods require a mod loader — a program that runs inside Minecraft and loads third-party code. The three loaders that matter today are Forge, Fabric, and NeoForge. A mod built for one loader will not work on the others, so always check which loader a mod requires before downloading it.

Requirements

  • A legitimate copy of Minecraft: Java Edition (mods will not work on pirated launchers reliably)
  • The correct Java version installed (see the Java section below)
  • At least 4 GB of RAM allocated to Minecraft for most modpacks; 6–8 GB for larger packs
  • Mod files ending in .jar — never extract these, and never run the loader installer by double-clicking it into the mods folder
02

Choosing a Mod Loader

Forge

Forge is the oldest and most widely supported loader. It powers massive classic modpacks, and most content mods target it. Popular modded versions on Forge include 1.20.1, 1.19.2, 1.18.2, 1.16.5, 1.12.2, and 1.7.10. If you want mods like Create, Tinkers' Construct, or Thaumcraft (1.12.2 and older), Forge is your best bet.

Fabric

Fabric is lightweight and updates to new Minecraft versions within days. Many performance mods (Sodium, Lithium, Iris for shaders) and newer technical mods are Fabric-only. Popular Fabric versions include 1.20.1, 1.20.4, and 1.21. Note: almost all Fabric mods require the Fabric API file to be installed alongside them.

NeoForge

NeoForge is a fork of Forge created in late 2023, starting at Minecraft 1.20.2. If a mod says "NeoForge" and you try to run it on Forge, it will crash. Newer versions (1.20.4+, 1.21) increasingly split between the two, so check the mod page carefully.

Which Version Should You Pick?

For a first-time modded experience, Minecraft 1.20.1 is the sweet spot: nearly every major mod supports it, and both Forge and Fabric have mature releases. Brand-new versions (1.21.x) often have sparse mod libraries for the first few months.

03

Installing Forge: Step by Step

  1. Go to files.minecraftforge.net and select your Minecraft version from the left sidebar.
  2. Click Installer (not the "Installer-win" unless you specifically want the Windows-only version) to download the .jar installer.
  3. Make sure Minecraft: Java Edition has been launched at least once so the game files exist.
  4. Double-click the downloaded installer and select Install client, then click OK.
  5. Open the official Minecraft Launcher. A new profile named forge (or "Forge") will appear in the installation dropdown at the bottom-left. Select it.
  6. Press Play. If the main menu shows a "Mods" button on the lower-left, Forge is working.
04

Installing Fabric: Step by Step

  1. Go to fabricmc.net/use/installer and download the Fabric installer (universal .jar or platform-specific version).
  2. Run the installer and select your target Minecraft version from the dropdown.
  3. Choose the latest Loader version (leave it at default unless a mod page specifies otherwise).
  4. Click Install. The installer creates a new profile in your launcher.
  5. Download the Fabric API from Modrinth or CurseForge — it is required by most mods.
  6. Select the Fabric profile in the Minecraft Launcher and press Play.
05

Installing Your Mods

The Mods Folder

  1. Launch the game once with your Forge or Fabric profile, then close it. This generates the mods folder.
  2. Press Windows key + R, type %appdata%\.minecraft\mods, and press Enter. On Mac, the path is ~/Library/Application Support/minecraft/mods. On Linux, it's ~/.minecraft/mods.
  3. Drag your downloaded mod .jar files into this folder. Do not unzip them.
  4. If using Fabric, place Fabric API in the folder too.
  5. Relaunch the game with the modded profile and check the Mods screen to confirm each mod loaded.

Where to Find Safe Mods

  • Modrinth (modrinth.com) — the largest modern mod hosting site, with strict malware scanning
  • CurseForge (curseforge.com/minecraft) — the long-standing alternative, now owned by Overwolf
  • The official Minecraft Forum and developer GitHub pages

Avoid random "free mod" aggregator sites. Mods from Modrinth and CurseForge are scanned for malicious code; files from unknown mirrors are a common source of stolen accounts and ransomware.

Version Matching Rules

  • A mod for 1.20.1 will not work on 1.20.4 or 1.21 — the version numbers must match exactly.
  • A Forge mod will not load on Fabric, and vice versa.
  • Some mods require additional library mods (dependencies). The download page will list them; if the game crashes with a "missing dependency" error, install the listed library.
06

Using a Mod Manager (Easier Alternative)

If manually managing folders sounds tedious, a mod manager handles installations, updates, and multiple versions automatically.

  • Prism Launcher (prismlauncher.org) — free, open-source, excellent for managing many isolated instances with separate mod folders
  • CurseForge App — one-click modpack installation, but bundled with Overwolf bloatware
  • Modrinth App — lightweight, open-source, and integrates directly with Modrinth
  • ATLauncher — good for curated modpacks like FTB and Technic content

These tools let you keep a 1.20.1 Forge instance, a 1.21 Fabric instance, and a modpack all side by side without file conflicts — highly recommended if you plan to mod long-term.

07

Java Version Requirements

Minecraft's bundled Java version handles most of this automatically in the modern launcher, but older modded setups need manual attention:

  • Minecraft 1.20.5 and newer: Java 21
  • Minecraft 1.18 through 1.20.4: Java 17
  • Minecraft 1.16.5 and older: Java 8 (specifically Java 8 Update 51 or newer; very old 1.7.10 packs sometimes demand Java 8 exactly)

Using the wrong Java version is the single most common cause of the error "Unsupported class file major version." Prism Launcher and the CurseForge app let you assign a specific Java installation per instance, which solves this permanently.

08

Troubleshooting Common Problems

  • Game crashes on launch with "Forge mod loading failed": A mod is for the wrong Minecraft version. Remove mods one at a time (or in halves) to isolate the culprit.
  • "Mods" button missing on the main menu: You launched the vanilla profile, not the Forge/Fabric profile.
  • OutOfMemoryError: Increase allocated RAM in your launcher (4 GB minimum for small modlists, 6–8 GB for 150+ mods).
  • Mod installed but not appearing: The file is in the wrong folder, it's a Fabric mod on Forge, or a dependency is missing.
  • Black screen or texture glitches: Update your graphics drivers, or check whether a performance mod conflicts with your GPU.
  • Duplicate mod errors: Two mods doing the same job (like two minimaps) can crash the game — remove one.
09

Java vs Bedrock: The Key Differences

Feature Java Edition Bedrock Edition
Third-party mods Fully supported via Forge/Fabric/NeoForge Not supported
Add-ons N/A (mods replace this role) JSON-based behavior/resource packs; limited scope
Marketplace None Official paid skins, worlds, mash-ups
Shaders Full support (Iris/OptiFine) RenderDragon engine limits shader options
Performance mods Sodium, Starlight, Lithium, etc. None equivalent

If true modding — new blocks, dimensions, automation, magic systems — is what you want, Java Edition is the only option. Bedrock add-ons can tweak existing mobs and items but cannot add the kind of content found in mods like Applied Energistics 2 or Twilight Forest.

10

Bottom Line

Install a mod loader (Forge or Fabric), drop version-matched .jar files into the mods folder, and make sure your Java version matches your Minecraft version. Use Modrinth or CurseForge for downloads, Prism Launcher to keep instances organized, and start with 1.20.1 for the widest mod selection. Avoid Bedrock if you want real mods — it simply doesn't support them.

Questions

how to install mods in minecraft java edition

To install mods in Minecraft Java Edition, you first need to install a mod loader such as Forge or Fabric by downloading the installer from their official websites and running it. Once the mod loader is installed, download compatible mod files from trusted sources like CurseForge or Modrinth and place them in the mods folder located in your Minecraft directory. Launch Minecraft using the mod loader profile, and the mods will load automatically when you enter a world.

where is the minecraft mods folder located

On Windows, the mods folder is located at %appdata%\.minecraft\mods. On macOS, it is found at ~/Library/Application Support/minecraft/mods, and on Linux it is at ~/.minecraft/mods. If the mods folder does not exist, you can create it manually after installing a mod loader like Forge or Fabric.

do minecraft mods work on bedrock edition

No, traditional mods designed for Java Edition do not work on Minecraft Bedrock Edition. Bedrock uses add-ons and behavior packs, which are installed differently and are not compatible with Java Edition mod files. Players on Bedrock can find add-ons through the official Minecraft Marketplace or community sites that specifically support Bedrock.

why are my minecraft mods not loading

Mods may fail to load if they are incompatible with your Minecraft version or mod loader, so always verify that each mod matches both the game version and the loader you are using. Another common cause is missing dependency mods, which some mods require to function. Check the crash report in your logs folder or the game's mod list screen to identify the specific issue.

Comments

Log in to save articles and join the discussion.

Start the discussion.

Minecraft.Co.Com

Login

Public registration and email recovery are not available yet. Existing accounts can sign in.