About Forge
Forge (Minecraft Forge) is a mod loader and modding API for Minecraft: Java Edition. It's installed separately for each Minecraft version, shows up in the launcher as its own installation beside vanilla, and loads mods written for Forge. On its own it changes almost nothing: the title screen gains a Mods button, and everything else comes from the mods you add.
Forge's defining trait is age. It has the longest history of any loader still maintained, with builds reaching back to the early years of Java Edition modding, and many well-known modpacks from older Minecraft versions exist only for Forge because nothing else supported those versions at the time. That history also explains the two things that trip people up most: a download page organised around Recommended and Latest builds whose numbers don't match Minecraft's, and a 2023 fork, NeoForge, that now has mods of its own.
Reading Forge's download page
Each Minecraft version has its own page on files.minecraftforge.net, and most list two builds. Recommended is one the Forge team has promoted as stable for that version. Latest is simply the newest build, carrying the most recent fixes without that promotion. A newly released Minecraft version often shows only Latest builds for a while, because nothing has been promoted yet. That's expected, not a warning.
The build number is the other trap, because it doesn't contain the Minecraft version at all. Each Minecraft version gets its own build series, and the leading number climbs as Minecraft releases do, so a Forge number means nothing until you know which Minecraft version it belongs to. The installer's file name carries both halves, Minecraft version first and Forge build second, which makes it the quickest check before you run anything. The FAQ below lists the build series for the most-played modding versions.
Choosing the right Forge build
The Minecraft version comes first, and your mods set it, not Forge. A modpack names its exact Forge build, and that's the one to install, since the pack was tested against it. For a mod list you assembled yourself, Recommended is the sensible default, and Latest is there for when a mod asks for something newer.
Mods can declare a minimum Forge build within a Minecraft version, and Forge checks it before the game starts. When yours is too old, loading stops on Forge's "Error loading mods" screen, which names the build the mod wants. Installing a newer Forge for the same Minecraft version fixes it without touching your other mods.
If you can choose the Minecraft version, choose the last patch of a line. Forge gives full support to the newest release and a set of long-lived older versions, moves the rest to a slower legacy tier, and gives a patch that was replaced over a serious bug almost none: its staff will point you to the corrected patch instead.
Where Forge mods keep their settings
Forge splits mod configuration by who it affects. Client and common settings live in the config folder of your Minecraft directory. Server settings are stored per world instead: in saves/<world name>/serverconfig for single-player, and world/serverconfig on a dedicated server. That's why editing a file in config sometimes changes nothing in an existing world, and why the same modpack can behave differently in two of your saves. When a mod's instructions mention a server option, look in the world's own folder first.
Forge and NeoForge
In July 2023 nearly all of Forge's developers left and forked the project as NeoForge. Forge carried on under LexManos, its lead maintainer at the time, and both projects have kept releasing builds for new Minecraft versions since.
The two overlap on just one Minecraft version, the release that was current when the developers left. NeoForge's release for it was built from Forge's own code, so files for that version are often tagged for both loaders. For every version after it, the loaders have different internals and a mod built for one won't load on the other. That makes the loader tag on each individual file more important than the project's name. Jade and FerriteCore, for instance, publish Forge and NeoForge files side by side, and grabbing the wrong one is an easy mistake. Modpacks divide the same way: DeceasedCraft is built on Forge, while many packs for recent versions have moved to NeoForge.
What Forge won't run
Fabric and Quilt mods don't load on Forge, and a NeoForge mod only does when it comes from that single shared version and is tagged for Forge too. That rules out some well-known performance and shader mods: Sodium and Iris publish Fabric and NeoForge builds but none for Forge, so a Forge setup has to do without them. OptiFine goes the other way. It can run inside a Forge installation, but only when the particular OptiFine build names a compatible Forge version. Our OptiFine page explains how to pair the two.
How to Download Forge for Minecraft
Start in the Forge Downloads section on this page. It has one row per Minecraft version, and clicking Download on yours takes you to that version's page on files.minecraftforge.net, the only official source. Click Installer under Recommended, or under Latest if the version has no Recommended build.
That link opens a short advertising page before the file, since ads are how Forge pays for its hosting. Wait for the page's Skip button and ignore everything else on it. What arrives should be a .jar whose name starts with forge- and contains your Minecraft version. Anything else, such as an .exe from a mirror site or a "download helper", isn't Forge.
How to Install Forge in Minecraft
- In the Minecraft Launcher, play the vanilla version you want once, then close the game and the launcher. That puts the vanilla files Forge builds on in place before the installer looks for them.
- Open the installer. It shows the exact build it will install (for example
1.20.1-forge-47.4.18), which is your last chance to catch a wrong download.
- Keep Install client selected. Install server and Extract are for other jobs and won't add anything to your launcher.
- Check the path underneath. It should be your Minecraft folder, which on Windows is
C:\Users\<you>\AppData\Roaming\.minecraft. Then click OK and wait for the success message.
- Open the launcher, pick the new forge installation beside the Play button and launch it. The title screen gains a Mods button, and its list shows Minecraft and Forge with their versions.
- Click Open mods folder on that screen, close the game, and put your Forge mods in that folder.
The CurseForge app and Prism Launcher can do all of this for you when you create a Forge instance or install a Forge modpack. For choosing and adding mods once Forge runs, see our guide to installing Minecraft mods.
If the installer won't open
Double-clicking a .jar only works when Java is installed and associated with .jar files. If WinRAR or 7-Zip opens it as an archive, right-click it and choose Open with and Java. If nothing happens at all, install a current Java and try again, or run java -jar followed by the installer's file name from a terminal in the same folder.
If Forge stops with "Error loading mods"
This screen lists each problem in plain terms, such as "Mod verity requires geckolib 4.4 or above" with "Currently, geckolib is not installed" underneath. A missing mod is a dependency to download for the same Minecraft version and for Forge. A version it asks for is a mod or Forge build to update. The buttons below it open the mods folder, latest.log and the crash report.
When the game closes without that screen, the usual suspects are a mod for another Minecraft version or a Fabric or NeoForge file in the folder. Our Forge troubleshooting guide shows how to find the culprit in the log.