What Is NeoForge? The Minecraft Mod Loader Explained (2026)

What Is NeoForge? The Minecraft Mod Loader Explained (2026)

NeoForge is a mod loader for Minecraft Java Edition. It is the layer that sits between the vanilla game and your mods, patching the game so that dozens of separately written mods can run at the same time without colliding. It started in 2023 as a fork of Minecraft Forge, and it is maintained by most of the people who used to maintain Forge.

Quick answers to the things people usually want:

• Is NeoForge the same as Forge? No. Same ancestry, two separate projects, and from Minecraft 1.20.2 onward the mods are not interchangeable.
• Is NeoForge open source? Yes, under the GNU Lesser General Public License v2.1.
• Which Minecraft versions? The oldest NeoForge builds target 1.20.1, and the split from Forge became real at 1.20.2. It has shipped for every release since, including the current 26.x versions.
• Is it free? Yes. No licence key, no paid tier.
• Which should I install? Whatever your modpack asks for. For a fresh build on a current Minecraft version, NeoForge.

What Is NeoForge?

Vanilla Minecraft has no plugin system. If two mods both want to add a new item, both need to write into the same internal registry, and the vanilla code has no idea either of them exists. That is the problem a mod loader solves.

NeoForge patches the game, gives mods a registry system to claim IDs from, and provides an event bus so a mod can react to a block being broken or a player joining without editing the code that fires the event. It also handles the mod loading order, dependency checks, and the client to server handshake that verifies both sides are running the same set of mods.

The part that trips people up: NeoForge adds no content. Install it on its own and the game still looks like vanilla. What you get is a stable place for mods to attach, which is why every modded server you have ever joined is running a loader of some kind underneath the pack.

Where NeoForge came from

Forge had been the default Minecraft modding API since 2011. In July 2023 the team behind it split. The Discord the Forge community used was rebranded to NeoForged on 12 July 2023, and almost the whole development team moved across, including cpw, one of the longest serving Forge developers. The project published its reasoning at the time and committed to written governance and to routing donations through Open Collective rather than to one individual.

The first NeoForge builds for Minecraft 1.20.1 were close to Forge. From 1.20.2 the two codebases diverged for real, and they have been separate ever since.

Is NeoForge the Same as Forge?

No. They share a common ancestor and most of the same vocabulary, but since Minecraft 1.20.2 they are two separate projects with separate builds, separate APIs, and separate mod files. A mod compiled for NeoForge will not load on a Forge server of the same Minecraft version, and the reverse holds too.

People phrase this question a few different ways, "is forge and neoforge the same", "is neoforge and forge the same", and the answer does not change. You cannot treat one as a drop in replacement for the other.

The quickest practical test is to open the mod jar and look inside META-INF. A Forge mod carries mods.toml. A NeoForge mod carries neoforge.mods.toml. Different filename, different loader, and that is what the loader itself checks at startup.

One myth worth killing: Forge is not abandoned. It still publishes builds for the current Minecraft release. What actually changed is where the mod authors went. Most mods and packs written for 1.20.2 and newer target NeoForge, so on modern versions the Forge side of the ecosystem is much thinner even though the loader itself is still being updated.

If you want the two compared feature by feature, including how to check which loader a specific mod supports before you download it, that is covered in Forge vs NeoForge.

Are Forge Mods Compatible With NeoForge?

On Minecraft 1.20.1, mostly yes. NeoForge was still close enough to Forge at that point that Forge mods generally loaded.

On Minecraft 1.20.2 and newer, no. The APIs diverged and the metadata filename changed. A Forge jar dropped into a NeoForge mods folder normally fails during mod loading, and the log names the file that caused it.

How to check before you download:

• Modrinth and CurseForge both tag every file with its loader. Filter by loader first, then by Minecraft version.
• Plenty of authors publish for both. They appear as two separate downloads, not one file that works everywhere.
• If you already have the jar, look for mods.toml or neoforge.mods.toml inside META-INF.

Mixing loaders in one mods folder is one of the standard reasons a modded server refuses to boot, and the fix is almost always removing a single wrong jar rather than anything clever.

Is NeoForge Open Source?

Yes. NeoForge is released under the GNU Lesser General Public License v2.1. The source lives in the neoforged/NeoForge repository on GitHub, and the licence file there states that NeoForge and all its parts in that repository are licensed under the GNU Lesser General Public License v2.1, with the SPDX identifier LGPL-2.1-only.

There is no paid edition and nothing to activate. Development is funded by donations through Open Collective, which the project set up when it formed so that money reaching the project pays the people contributing to it.

For a server operator the practical effect is that you can download it, run it, modify it and redistribute it, which is why modpack authors can ship the installer inside a pack and why control panels can offer NeoForge as a one click install option.

Which Minecraft Versions Does NeoForge Support?

The oldest published NeoForge builds target Minecraft 1.20.2, and it has shipped for every Minecraft release since, through the end of the 1.21 line and into the current numbering.

That numbering is worth a note if you have been away for a while. The 1.21 line ended with 1.21.11 in December 2025. The next release was 26.1 in March 2026, then 26.1.1, 26.1.2, and 26.2 in June 2026. So "1.21.11 is the newest Minecraft" is out of date, and any guide still saying so was written before the change.

NeoForge build numbers track the Minecraft version they are built against. A build starting 21.1 targets Minecraft 1.21.1. A build starting 26.2 targets Minecraft 26.2. When someone tells you to install NeoForge 21.1.x, they have told you the Minecraft version at the same time.

Java version by Minecraft version

The wrong Java build is a common reason a NeoForge server dies on startup. Minecraft declares a required Java major version for every release:

Modded servers are stricter about this than vanilla, because pack authors and mod authors compile against a specific runtime. Match what the pack asks for rather than installing the newest JDK you can find. There is a fuller version map in Minecraft server Java version requirements.

Is NeoForge Better Than Forge?

For a new server on a current Minecraft version, NeoForge is the practical default. That is where the mod authors are publishing, that is what the large kitchen sink packs target, and that is where the API work is happening.

For an existing pack the question mostly does not apply. RLCraft is Forge on 1.12.2 and is not moving. Vault Hunters 3rd Edition is Forge on 1.18.2. If you are running one of those, your loader was chosen for you years ago, and swapping it is not a decision you get to make without rebuilding the pack.

The useful way to think about it: NeoForge is not better in the abstract, it is better supported on the versions people are building for now.

NeoForge vs Fabric

The old rule of thumb was that Fabric was the only way to get Sodium and Iris. That is no longer true. Both Sodium and Iris now list NeoForge among their supported loaders on Modrinth, and both publish builds for Minecraft 26.2, so shader and performance choice is much less of a deciding factor than it used to be.

Pick based on what your pack targets first, and on which loader the mods you actually want are published for second. There is a longer breakdown in Fabric vs NeoForge.

Which Modpacks Use NeoForge?

Loader and version taken from each pack's CurseForge listing. Note that some pack names ship in more than one flavour, Better MC in particular, so check the loader tag on the exact file you are downloading rather than the pack name.

Rule of thumb: packs targeting 1.20.2 or newer are almost always NeoForge. Packs on 1.20.1 and older are Forge or Fabric, and the pack page tells you which.

How to Install NeoForge on a Server

If you are installing a modpack, skip this. The pack's server files already contain the correct NeoForge version, and you run the pack's own start script. This is for a bare loader install.

1. Download the installer jar for your Minecraft version from the NeoForge project files at neoforged.net.
2. In your server directory, run java -jar neoforge-<version>-installer.jar --installServer.
3. Set your heap size and any other JVM flags in the user_jvm_args.txt file the installer creates.
4. Start the server with ./run.sh on Linux or run.bat on Windows. The first run stops immediately, which is expected.
5. Open eula.txt, change eula=false to eula=true, and start it again.

Players connecting to the server need the same NeoForge version on their client, plus the same mods, unless a mod is explicitly server side only.

Common NeoForge Questions

Can I run NeoForge mods on a Forge server? No. A 1.21.1 NeoForge mod will not load on a 1.21.1 Forge server. They are separate loaders reading separate metadata.

Can I convert an existing Forge server to NeoForge? Not in place. You are changing loader and replacing every mod, so treat it as building a new pack. Back up the world first. Whether the world survives depends on whether the mods that created its blocks and items exist on the NeoForge side at compatible versions, and that is worth testing on a copy before you touch the live server.

Does NeoForge work with OptiFine? No. OptiFine's own download page lists Forge compatibility for its builds and does not mention NeoForge at all. Use Iris for shaders and Sodium or Embeddium for performance instead. That swap is covered in OptiFine and NeoForge compatibility.

Where do I download NeoForge? The official site is neoforged.net. Mods for it are on Modrinth and CurseForge.

Why do my mods load fine locally but not on the server? Usually a version mismatch between the NeoForge build on the client and the one on the server, or a client only mod sitting in the server's mods folder. The startup log names the mod either way.

NeoForge Server RAM Requirements

Heap size is only half the story. A large kitchen sink pack spends most of its tick budget on a single thread, so single core performance matters as much as the RAM figure, and chunk generation on a fresh world will be the heaviest thing the server ever does. Give yourself headroom above the pack's stated minimum rather than sizing exactly to it.

If you need somewhere to put a NeoForge server without sorting out the Java version, the heap flags and the restart script yourself, our Minecraft hosting plans handle the loader install and let you pick the version.