How to Install NeoForge for Minecraft Modding

NeoForge has quickly become one of the most important mod loaders in the Minecraft ecosystem. Born from a fork of the long-running Minecraft Forge project, NeoForge carries forward a familiar foundation while introducing modernized internals and an active development community. If you're ready to start running mods through NeoForge, this guide walks through exactly how the installation process works — and what variables will shape your experience.

What Is NeoForge and Why Does It Matter?

NeoForge is a mod loader — a piece of software that sits between Minecraft and your mods, allowing the game to load third-party modifications that would otherwise be incompatible with the base game. It handles the heavy lifting of injecting mod code into the game at launch, managing mod dependencies, and resolving conflicts.

NeoForge forked from Minecraft Forge in 2023, inheriting its broad mod compatibility while shifting toward a faster release cycle and cleaner API architecture. Many major mods have already migrated to NeoForge support, and new mods are increasingly targeting it as a primary platform. For players on Minecraft Java Edition 1.20.1 and newer, NeoForge is increasingly the standard choice for mod-heavy setups.

It's worth noting: NeoForge is Java Edition only. Bedrock Edition uses a different modding system entirely, so this process doesn't apply there.

What You'll Need Before You Start

Before downloading anything, confirm you have the following:

• Minecraft Java Edition installed and launched at least once
• Java — Minecraft 1.17 and later require Java 17 or newer; some newer versions require Java 21
• The official Minecraft Launcher or a supported third-party launcher (such as Prism Launcher, ATLauncher, or CurseForge)
• Enough free disk space — a base NeoForge installation is modest, but mods can add up quickly

The Java requirement is one of the most common stumbling blocks. If you're running an outdated Java version, NeoForge will either fail to install or fail to launch. Check your installed Java version by opening a terminal or command prompt and typing java -version.

Step-by-Step: Installing NeoForge with the Official Installer 🛠️

1. Download the NeoForge Installer

Go to the official NeoForge website at neoforged.net and navigate to the Downloads section. You'll see a list of available versions organized by Minecraft version. Select the version that matches the Minecraft version you intend to play — this is critical, as installers are not interchangeable across Minecraft versions.

Download the file labeled as the installer (typically a .jar file).

2. Run the Installer

With Java installed, you can usually double-click the .jar installer to launch it. If that doesn't work, open a terminal in the same folder and run:

java -jar neoforge-X.X.X-installer.jar 

Replace X.X.X with the actual version number of the file you downloaded.

The installer window will present three options:

For most users, Install client is the correct choice. Confirm the Minecraft installation directory shown is accurate — this should point to your .minecraft folder. Click OK and the installer will handle the rest.

3. Launch Minecraft with the NeoForge Profile

Open the official Minecraft Launcher. In the bottom-left, you'll now see a new profile (installation) in the dropdown — something like NeoForge 1.21.1 or whichever version you installed. Select it and hit Play.

The first launch will take longer than usual as NeoForge loads its libraries. A black or white screen for a moment is normal.

4. Add Mods

Once NeoForge is running, adding mods is straightforward:

1. Navigate to your .minecraft folder (on Windows: %appdata%.minecraft)
2. Open the mods folder (NeoForge creates this automatically)
3. Drop in mod .jar files — making sure each mod is built for your specific NeoForge and Minecraft version

Restart the game with the NeoForge profile selected, and your mods will load.

Installing NeoForge via Third-Party Launchers

Many players use launchers like Prism Launcher, ATLauncher, or the CurseForge app because they simplify profile management and make switching between mod setups much easier.

In Prism Launcher, for example, you create a new instance, select your Minecraft version, and choose NeoForge as the mod loader — no manual installer required. The launcher downloads and configures everything automatically.

This approach is particularly useful if you're:

• Managing multiple mod profiles (e.g., different modpacks)
• Sharing setups with friends
• Running modpacks downloaded from platforms like Modrinth or CurseForge

Variables That Affect Your Setup 🔧

Installation is rarely one-size-fits-all. Several factors meaningfully change what the right process looks like:

• Minecraft version: Not all NeoForge versions support all Minecraft releases. Mod availability also varies significantly by version — 1.20.1 has a much larger mod library than a freshly released version.
• Operating system: The .jar installer works across Windows, macOS, and Linux, but file paths and Java configurations differ. Linux users may need to set file permissions or configure Java manually.
• Java version installed: Mismatched Java versions are a leading cause of failed installations. Some mods also require specific Java builds.
• Launcher preference: The official launcher works but is relatively bare-bones for mod management. Third-party launchers offer more control but have their own learning curves.
• Mod load size: A few lightweight mods run fine on modest hardware. Large modpacks with hundreds of mods require significantly more RAM allocated to Minecraft — typically set within your launcher's Java arguments.

Common Installation Issues

"Java not found" error — Java isn't installed or isn't recognized. Install the correct version and ensure it's added to your system PATH.

Wrong Minecraft version selected — The installer defaults to your most recently played version. If that doesn't match your intended NeoForge version, change the directory path manually.

Mods not loading — Confirm the mod is built for NeoForge specifically (not Fabric or legacy Forge), and that its version matches your current Minecraft and NeoForge versions.

Crash on launch — Check the crash log in .minecraft/crash-reports. Mod conflicts, missing dependencies, and Java memory limits are the most common culprits.

The Setup Depends on Where You're Starting

NeoForge's installation is well-documented and genuinely accessible for most users — but how smooth the process feels depends heavily on your starting point. Someone running a clean, up-to-date Java installation on a standard Windows machine will have a different experience than someone managing multiple Minecraft versions on Linux with mixed Java environments.

The Minecraft version you want to play, the specific mods you're targeting, the launcher you prefer, and how much memory your system can allocate to the game all push the experience in different directions. The steps above are consistent — but which version to target and how to configure your environment are decisions shaped entirely by your own setup.