NeoForge
NeoForge is a free, open-source mod loader for Minecraft Java Edition and the modern successor to Forge. Born in 2023 from a split within the original Forge development team, NeoForge has since become the default choice for content-heavy modpacks on Minecraft 1.20.2 and newer, covering everything from installation and versioning to mod compatibility and performance optimization.
Overview NeoForge:
What Is NeoForge?
NeoForge is a mod loader for Minecraft Java Edition. That means it is a software that sits between the game and your mods, loading them reliably and making sure they work together. It serves the same core purpose as Forge or Fabric, but with a modernized approach to both governance and codebase.
The project was founded on July 12, 2023, when the majority of the original Forge development team, including lead maintainer cpw, left to start a new project after ongoing internal conflicts with Forge founder LexManos. Rather than starting from scratch, they forked Forge’s existing code and built on top of it, which is why the transition from Forge to NeoForge is much smoother than switching to an entirely different loader. The new project is governed by a Steering Council instead of a single person, meaning development decisions are made transparently as a team.
Since its founding, NeoForge has grown rapidly. By 2025, almost all major new modpacks (including All the Mods 10, Better MC 5, and All the Mons) had adopted NeoForge as their loader of choice. For Minecraft versions from 1.20.2 onward, NeoForge is the recommended mod loader for the Forge-style ecosystem.
How to Install NeoForge
Installation works similarly to Forge: download an installer, run it, and a new launcher profile is created automatically. There are two paths: client or server, with slightly different steps for each.
Installing NeoForge on the Client
Before installing, make sure you have the correct version of Java. NeoForge requires Java to be installed manually (unlike vanilla Minecraft, which bundles its own Java runtime):
- Minecraft 1.20.2 to 1.20.4 → Java 17
- Minecraft 1.20.5 to 1.21.11 → Java 21
- Minecraft 26.1 and newer → Java 25
You can verify your Java version by opening a terminal and running java -version. The first number after ‘version’ must match the version required for your target Minecraft release.
Once Java is in order, the installation itself only takes a few minutes:
- Visit neoforged.net and download the installer for your Minecraft version.
- Run the downloaded .jar file: the NeoForge installer window opens.
- Select Install client and confirm the path points to your .minecraft folder.
- Click Proceed: the installer downloads the necessary files and creates a new launcher profile.
- Open the Minecraft Launcher, select the NeoForge profile, and launch.
- A mods/ folder is created automatically on first launch: this is where all your mod .jar files go.
Installing NeoForge on a Server
Setting up a NeoForge server follows the same installer logic, but with a server target instead of a client one:
- Download the installer from neoforged.net for your desired Minecraft version.
- Create a new, empty folder for the server files.
- Run the installer and select Install server, pointing it to that empty folder.
- Once installation finishes, start the server once using run.bat (Windows) or run.sh (macOS/Linux): it will exit after generating config files.
- Open eula.txt and change eula=false to eula=true to accept Mojang’s terms.
- Start the server again: a mods/ folder now appears where you can place your mod files.
Note:All players connecting to a NeoForge server must have the same mods installed on their client as the server requires. Purely client-side mods (like performance or visual mods) can usually be kept local without needing to match the server.
NeoForge vs. Forge – What’s the Difference?
NeoForge and Forge share the same roots:
- the same modding system (FML)
- the same conventions
- the same mods/ folder structure
From a player’s perspective, the experience of installing and using NeoForge feels nearly identical to Forge. The key differences are under the hood and in where the community’s attention has shifted.
NeoForge brings a modernized codebase, faster update cycles, and open community governance. For new Minecraft versions since the 2023 split, NeoForge consistently receives updates faster than Forge and has attracted the majority of active mod developers. Almost all major tech and content mods, including Create, Mekanism, Applied Energistics 2, Just Enough Items (JEI), and Botania, now have official NeoForge builds.
Compatibility with Forge Mods
Whether a Forge mod runs on NeoForge depends entirely on the Minecraft version:
- 1.20.1: NeoForge maintains nearly full compatibility with Forge mods from that version; both loaders were still very close at that point
- 1.20.2 & newer: NeoForge and Forge are separate ecosystems
The safest rule: always check the mod page on CurseForge or Modrinth. Both platforms clearly list which loader and Minecraft version each file supports. Never copy a NeoForge-only .jar into a Forge server or vice versa on 1.20.2+.
There is also a compatibility layer called ‘Sinytra Connector’ that allows some Fabric mods to run on NeoForge, but it is experimental and not a substitute for a native NeoForge build.
NeoForge vs. Fabric
NeoForge and Fabric are two fundamentally different philosophies. They can’t be mixed: mods built for one loader do not run on the other, and you install exactly one loader per Minecraft instance.
| NeoForge | Fabric | |
| best for | heavy content modpacks (200+ mods, tech, magic) | performance mods, lightweight setups, QoL |
| update speed | fast, but not as fast as Fabric | usually available within days of a new MC version |
| RAM usage | higher | lower |
| mod library | Create, Mekanism, AE2, Botania, JEI, ATM10 | Sodium, Iris, Lithium, Terralith |
| mod cross-compatibility | rich inter-mod API (energy, fluids, items) | smaller shared API; isolated ecosystems |
NeoForge is designed for large-scale content modding. Its API is rich and deep, enabling mods to modify the game at a fundamental level: energy systems, fluid networks, custom machines, new dimensions, and complex inter-mod compatibility (e.g. a Mekanism pipe connecting to an Applied Energistics storage system). This power comes at a cost: NeoForge starts slower and consumes more RAM than Fabric, which matters most on lower-end machines or very large modpacks.
Fabric is lightweight and minimalist by design. It updates to new Minecraft versions within days of release, runs leaner, and is the go-to choice for performance mods like Sodium, Iris, and Lithium. It works well for smaller, curated mod lists and players who want an improved vanilla experience without dramatically changing the game.
NeoForge Versions Explained
NeoForge uses a version number that directly encodes the Minecraft version it targets, so you never have to guess which installer matches your game. Always match the NeoForge version to your exact Minecraft version. Mixing versions, even within the same minor release, can cause crashes or missing mod behavior.
| Minecraft version | NeoForge version (example) | Required Java |
| 1.20.2 to 1.20.4 | 20.2.x to 20.4.x | Java 17 |
| 1.20.5 to 1.21.11 | 20.5.x to 21.11.x | Java 21 |
| 26.1 & newer | 26.1.0.x | Java 25 |
For Minecraft versions up to 1.21.11, NeoForge followed a three-part scheme where the first two numbers mirror the Minecraft minor and patch version. NeoForge 21.1.x, for example, targets Minecraft 1.21.1, with the last number being the NeoForge release iteration. Starting with Minecraft 26.1 (the first Minecraft version to use calendar-based versioning), NeoForge adopted the same pattern: NeoForge 26.1.0.x for Minecraft 26.1.
Note:While NeoForge technically exists for Minecraft 1.20.1, the NeoForge team itself recommends using Forge on that version, as Forge had longer and more stable support for 1.20.1 specifically. NeoForge is recommended from 1.20.2 onward.
NeoForge Mods – Where to Find Them
NeoForge mods are distributed as .jar files, just like Forge mods. The two main trusted platforms are curseforge.com and modrinth.com. Both clearly label each file with the required loader and Minecraft version. Only download mods from these or other reputable sources to avoid corrupted files and security risks.
To install a NeoForge mod:
- Download the correct .jar for your NeoForge and Minecraft version.
- Place it in the .minecraft/mods/ folder (client) or the server’s mods/ folder.
- Start the game or server: NeoForge loads all mods in that folder automatically.
- If a mod requires a dependency (such as a library mod), download and install that as well.
For modpacks, use the CurseForge App or Modrinth Launcher. These tools install the correct NeoForge version, all required mods, and all configuration files in one step, no manual file management needed.
NeoForge Performance Mods
OptiFine, the long-time performance and shader mod, does not support NeoForge and has fallen significantly behind on modern Minecraft versions. The good news: a set of specialized, open-source mods now covers and exceeds everything OptiFine offered, with better mod compatibility and faster update cycles. The following mods all have native NeoForge builds and can be safely combined.
Rendering & FPS Mods
These are client-side mods that improve frame rates, reduce stutter, and add shader support. They’re basically the NeoForge equivalents of what OptiFine used to provide on Fabric.
- Sodium (now available natively on NeoForge): rewrites Minecraft’s rendering pipeline with a multi-draw approach and multithreaded chunk updates; the single biggest FPS improvement available; on CPU-limited setups, it can double or triple frame rates
- Embeddium: an established NeoForge port of Sodium with a focus on mod compatibility; a stable alternative if you encounter issues with the native Sodium build
- Embeddium Extra: adds OptiFine-style video settings (animation toggles, fog density, sky colors) on top of Embeddium
- Oculus / NeOculus: NeoForge port of Iris; brings full shader pack support (SEUS, Complementary, BSL) while running on Embeddium’s rendering engine instead of OptiFine
- ImmediatelyFast: optimizes GUI rendering, maps, and particle draw calls; noticeably reduces frame drops in modpacks with complex interfaces
Server & RAM Optimization Mods
These mods target server-side performance (tick time (TPS), mob AI, chunk loading, and memory usage) and most work equally well in single-player.
- Canary: NeoForge port of Lithium; accelerates block updates, collision calculations, random ticks, and mob AI without changing gameplay; typically 20-40% reduction in MSPT on loaded servers
- FerriteCore: optimizes how Minecraft stores block states and model data in memory; reduces RAM usage by 30-40% in heavy modpacks
- ModernFix: reduces RAM consumption and cuts modpack startup time by 10-30 seconds through smarter class loading and texture handling
- ServerCore: bundles async chunk I/O, smarter mob caps, and a lag-spike smoother; especially effective on servers with 6+ CPU cores
- Adaptive Performance Tweaks: monitors tick time in real time and dynamically throttles heavy systems (mob AI, hopper scans, item despawn) to keep TPS stable at 20
Tip:For most NeoForge servers, combining Canary, FerriteCore, and ModernFix already delivers a noticeable stability improvement with minimal setup. Add ServerCore if you run a public server with many players.
FAQ
No, NeoForge started as a fork of Forge in 2023 and shares its roots, but they are now separate mod loaders with separate ecosystems. On Minecraft 1.20.2 and newer, their mods are not interchangeable unless a mod author explicitly publishes builds for both.
On Minecraft 1.20.1, NeoForge has near-full compatibility with Forge mods. On 1.20.2 and newer, NeoForge and Forge are separate: always check the mod’s page on CurseForge or Modrinth to confirm it lists NeoForge support for your specific Minecraft version.
No, OptiFine doesn’t support NeoForge and hasn’t kept up with modern Minecraft versions. Use Embeddium (or native Sodium) for rendering performance and Oculus for shader support instead. They are faster, open-source, and better-compatible with other mods.
Yes, Sodium now has native NeoForge support. If Sodium is not yet available for a specific NeoForge version, Embeddium (a dedicated NeoForge port of Sodium) covers the same functionality and is updated regularly.
It depends on your Minecraft version: Java 17 for MC 1.20.2 to 1.20.4, Java 21 for MC 1.20.5 to 1.21.11, and Java 25 for Minecraft 26.1 and newer. You can check your current Java version by running java -version in a terminal.
CurseForge and Modrinth are the two main trusted platforms. Both clearly label each file with the required loader (NeoForge, Forge, or Fabric) and Minecraft version. Always verify both before downloading.
Yes, NeoForge has full server support. The installer offers a dedicated server installation option, and players connecting to a NeoForge server need the same required mods installed on their client.
ForgeForward: Start Your NeoForge Server with GPORTAL
NeoForge is where Minecraft modding is heading: faster updates, an active developer community, and the largest library of modern content mods. Whether you are building a compact setup with a handful of mods or running a full 300-mod kitchen-sink pack like All the Mods 10, NeoForge gives you the foundation to do it. So, Ready to play? Rent a Minecraft server from GPORTAL, select NeoForge as your pre-installed server type, and you’re up and running in minutes. The best? No manual setup required! What are you waiting for?