Before you start

Check the mod’s page for a file matching your Minecraft and NeoForge versions. The mod, Minecraft, and loader versions must match. Download files from the project page or a trusted platform.

Install NeoForge

  1. Open the official NeoForge website and download the installer matching your Minecraft version.
  2. Run the installer and choose the Client installation.
  3. Open the Minecraft launcher, select the NeoForge profile it created, and launch the game once. Then close the game.

Add a mod

  1. Download the file made for NeoForge and the same Minecraft version as your profile.
  2. Open the game directory used by that profile. If you use a third-party launcher or separate instance, open that instance’s directory.
  3. Put the downloaded file (usually a .jar file) in the mods folder without extracting it. Create the folder if it does not exist.
  4. Relaunch Minecraft with the NeoForge profile and check that the mod loads.

Check the mod page to see whether an additional dependency is required, and only install a version compatible with your game.

Installing a mod on a server

Requirements vary by mod. Some must also be installed on the server; others are client-side only. Check the mod page and ask the administrator which loader and files are needed. If server installation is required, the server must use a compatible NeoForge version.

Was this guide helpful?Find more tips in the help center.Explore the wiki