How to Install Forge for Minecraft: A Complete Setup Guide

Minecraft Forge is the backbone of modded Minecraft. If you've ever wanted to run mods — from simple quality-of-life tweaks to massive overhauls that add new dimensions, creatures, and mechanics — Forge is almost certainly what makes that possible. Installing it isn't difficult, but there are enough moving parts that skipping a step can cause real headaches.

Here's exactly how the process works, what affects how smoothly it goes, and what to watch for based on your setup.

What Is Minecraft Forge?

Minecraft Forge is a free, open-source modding API and loader. It sits between Minecraft's Java code and the mods you install, acting as a compatibility layer that lets dozens (or hundreds) of mods run together without completely breaking the game.

Without Forge, mods would have to directly overwrite Minecraft's core files — which means two mods touching the same file would conflict. Forge solves this by giving mod developers a standardized framework to work within.

🔧 One critical point: Forge is only for Minecraft: Java Edition. If you're running Minecraft: Bedrock Edition (the version on consoles, Windows 10/11 app store, or mobile), Forge does not apply. Bedrock uses a completely different system for add-ons.

What You Need Before You Start

Before downloading anything, confirm you have:

  • Minecraft: Java Edition installed and launched at least once
  • Java installed on your system (more on this below)
  • The specific Minecraft version you want to mod — Forge versions are tied directly to Minecraft versions

Java: The Hidden Variable

Forge runs on Java, and which version of Java you need depends on which version of Minecraft you're targeting:

Minecraft VersionRequired Java Version
1.17 and earlierJava 8
1.18 – 1.20Java 17
1.21+Java 21

Newer Minecraft launchers often bundle their own Java runtime, but the Forge installer sometimes still needs a system-level Java installation to run correctly. If the installer refuses to launch or throws an error immediately, a missing or mismatched Java version is usually the first thing to check.

Downloading Forge: Matching Versions Matters

Go to the official Forge site (files.minecraftforge.net). You'll see a list of Minecraft versions on the left. Select the version that matches the mods you want to run — not necessarily the latest Minecraft version.

For each Minecraft version, Forge offers two build types:

  • Recommended — more stable, tested over time
  • Latest — most recent features, potentially less stable

For most users running established mods, the Recommended build is the safer starting point. If a mod specifically requires a newer Forge build, its documentation will say so.

⚠️ Watch out for the download page's ad layout. The large download buttons in the middle of the page are often ads. The actual Forge download links are smaller and positioned below the version/build information.

Running the Forge Installer

Once downloaded, you'll have a .jar file — for example, forge-1.20.1-47.2.0-installer.jar. To run it:

  1. Double-click the .jar file — if Java is installed correctly, it will open a small installer window
  2. Select "Install Client" (this is the default and correct option for playing mods yourself)
  3. Confirm the Minecraft installation directory — the installer auto-detects this in most cases
  4. Click OK and wait for it to complete

The installer downloads additional files from the internet during this process, so a stable connection matters. On slower connections, this can take a few minutes.

If double-clicking the .jar doesn't open anything, your system may not have Java associated with .jar files. In that case, open a terminal or command prompt and run:

java -jar forge-[version]-installer.jar 

Launching Forge in the Minecraft Launcher

After installation, open the official Minecraft Launcher. In the bottom-left corner (or under "Installations" depending on your launcher version), you'll find a new profile has been created — something like "forge-1.20.1".

Select that profile and launch. The first launch takes longer than usual as Forge sets up its environment. You'll eventually reach a Minecraft main menu that now shows the Forge version number in the bottom-left corner.

Adding Mods

With Forge running, adding mods follows a consistent process:

  1. Locate your Minecraft directory — on Windows this is typically %AppData%.minecraft, on macOS it's ~/Library/Application Support/minecraft
  2. Open (or create) the mods folder inside that directory
  3. Drop downloaded mod .jar files into the mods folder
  4. Launch Minecraft using the Forge profile

Every mod must match both the Forge version and the Minecraft version you're running. A mod built for 1.19.2 will not work reliably on a 1.20.1 Forge installation, even if it appears in the mod list.

What Affects How Smoothly This Goes

The installation process itself is fairly consistent, but several factors shape the experience from person to person:

Operating system plays a role — the file paths, Java associations, and permission settings differ meaningfully between Windows, macOS, and Linux. Linux users in particular often need to manually set execute permissions on the installer.

Mod count and complexity matters more than most beginners expect. Running 5 mods and running 150 mods are fundamentally different situations in terms of load time, RAM requirements, and conflict likelihood. Forge itself is lightweight; what you put on top of it determines your actual hardware demands.

Which Minecraft version you target shapes your mod library options. Some of the most popular mods have versions available for 1.12.2, 1.16.5, and 1.20.1 — but not every version in between. Choosing a version based on the specific mods you want, rather than defaulting to the latest, often leads to a better modded experience.

Prior Minecraft installations can occasionally cause path or profile conflicts, especially if you've used third-party launchers like CurseForge, MultiMC, or Prism Launcher alongside the official launcher.

Speaking of third-party launchers — many experienced modded Minecraft players use Prism Launcher or CurseForge specifically because they handle Forge installation, mod management, and version isolation automatically. Whether the manual approach or a launcher-based approach fits better depends heavily on how many modpacks you plan to run and how comfortable you are managing files manually.