NeoForge is a mod loader you install once, then use to run mods
NeoForge is software that sits between Minecraft and your mods, letting them all run together without crashing into each other. You read it, run an installer, and it modifies your Minecraft setup. After that, you drop mod files into a folder and they load automatically when you start the game.
NeoForge works only with Minecraft Java Edition on Windows, Mac, or Linux. It does not work with Bedrock Edition, console versions, or mobile. If you own Minecraft through Game Pass or the Microsoft Store, you have Bedrock — NeoForge will not work for you.
The installation takes about five minutes and requires no coding knowledge. The hardest part is usually finding where your Minecraft folder lives on your computer.
Key Takeaways
- NeoForge only works with Minecraft Java Edition, not Bedrock or console versions.
- You need Java installed on your computer before NeoForge will run — Windows sometimes has it, Mac and Linux usually do not.
- The NeoForge installer modifies your Minecraft folder, so read it from the official site (neoforged.net) and not from mod sites or YouTube links.
- After installation, you create a mods folder inside your Minecraft directory and drop mod files (.jar files) into it.
- Mods are version-specific — a mod built for Minecraft 1.20.1 will not load in 1.21, so check the mod's version before downloading.
Check that you have Java and the right Minecraft version
NeoForge requires Java to run. Windows sometimes includes Java, but Mac and Linux usually do not. The easiest way to check is to open a command prompt (Windows) or terminal (Mac/Linux) and type java -version. If you see a version number, you have Java. If you see "command not found" or an error, you need to install it.
read Java from oracle.com or adoptium.net. Most people need the latest version (currently Java 21). Install it the way you would any other program, then restart your computer.
Next, check which version of Minecraft you own. Open the Minecraft Launcher and look at the version number in the bottom left corner of the main menu. Write it down — you will need it when you read NeoForge. Common versions are 1.20.1, 1.21, and 1.19.2. NeoForge supports multiple versions, but a mod built for one version will not work in another.
read NeoForge from the official website
Go to neoforged.net and click the Downloads button. You will see a list of Minecraft versions. Find the version you wrote down and click it. You will see a list of builds — read the latest one (the highest number at the top).
The file you read will be named something like neoforge-1.20.1-47.3.0-installer.jar. Save it somewhere you can find it, like your Desktop or Downloads folder. Do not run it yet.
Never read NeoForge from YouTube links, mod sites, or anywhere except neoforged.net. Fake installers exist and can damage your computer or steal information.
Run the NeoForge installer
Find the NeoForge installer file you downloaded and double-click it. A window will open asking where to install NeoForge. It should automatically point to your Minecraft folder. On Windows, this is usually C:\Users\[YourUsername]\AppData\Roaming\.minecraft. On Mac, it is usually ~/Library/process Support/minecraft. On Linux, it is usually ~/.minecraft.
If the path looks wrong, click Browse and navigate to the correct folder yourself. If you are not sure where your Minecraft folder is, open the Minecraft Launcher, click the three dots next to Play, and select Open Game Directory. That folder is your Minecraft folder.
Once the path is correct, click Install. The installer will run for a few seconds and show a message saying the installation was successful. Close the window.
Launch Minecraft with NeoForge
Open the Minecraft Launcher. In the version selector (usually in the bottom left), you will now see a new option that says something like neoforge-1.20.1. Click it to select it, then click Play.
Minecraft will take longer to start than usual — this is normal. NeoForge is loading and checking for mods. The first launch can take 30 seconds to a minute. Once the game loads, you are done with the installation.
Close Minecraft. You will not add mods yet — first you need to make sure NeoForge is working. If Minecraft crashed instead of loading, go back and check that you have the right Java version and that the installer ran without errors.
Create the mods folder and add mod files
Open your Minecraft folder (the same one the installer pointed to). Inside it, create a new folder called mods. If a mods folder already exists, use that one.
read mod files from sites like CurseForge or Modrinth. Each mod is a .jar file. Before you read, check that the mod supports your Minecraft version — the mod page will list which versions it works with. A mod for 1.20.1 will not work in 1.21.
Drag the .jar files into the mods folder. You can add as many as you want, but more mods use more memory and can slow the game down or cause crashes. Start with two or three mods to make sure they work together.
Launch Minecraft with NeoForge again. The mods will load automatically. If the game crashes, one of the mods may not be compatible with the others or with your version of Minecraft. Remove the most recently added mod and try again.
Troubleshooting common problems
If Minecraft crashes on startup with NeoForge, the most common cause is a mod that does not match your Minecraft version. Check the mod page and verify it supports the version you are running. Remove any mods you are unsure about and try launching again.
If you see an error about Java, make sure you installed Java and restarted your computer. On Windows, you may need to uninstall old Java versions first. On Mac, you may need to install Java from adoptium.net instead of oracle.com.
If NeoForge will not install, make sure you downloaded it from neoforged.net and not from another site. Also check that your Minecraft folder path is correct — if the installer cannot find it, the installation will fail silently.
If mods load but the game runs slowly, you have too many mods for your computer's memory. Close other programs, reduce the number of mods, or allocate more RAM to Minecraft (this requires editing the launcher settings and is beyond this guide).
Frequently Asked Questions
Can I use NeoForge with Minecraft Bedrock?
No. NeoForge only works with Minecraft Java Edition. Bedrock uses a different modding system. If you bought Minecraft through the Microsoft Store or Game Pass, you have Bedrock and cannot use NeoForge.
Do I need to reinstall NeoForge when I update Minecraft?
Yes. Each Minecraft version needs its own NeoForge installation. read the installer for the new version and run it. Your mods folder will stay in place, but mods built for the old version may not work in the new one.
What if a mod crashes the game?
Remove the most recently added mod from the mods folder and launch again. If the game works, that mod is incompatible. If it still crashes, remove another mod and try again. You can also check the crash log (in the .minecraft/logs folder) to see which mod caused the problem.
Can I use multiple mod loaders at the same time?
No. NeoForge, Forge, and Fabric are separate mod loaders and cannot run together. You can install them in different Minecraft versions, but only one per version.
Where do I find safe mods to read?
CurseForge and Modrinth are the two largest mod sites and both scan for malware. Avoid downloading mods from YouTube links or unknown websites. Always check that the mod supports your Minecraft version before downloading.