Guide · Minecraft · Game

Minecraft mods: loaders, safe downloads and how to install them

Forge, NeoForge, Fabric or Quilt, Modrinth or CurseForge: how Minecraft Java mods work, where to get them safely, and how to install them.

· tamaMinecraft

A Minecraft mod is a file that changes what the game can do: a new machine, a recipe viewer, a minimap, a faster renderer. Mojang’s own download page describes Java Edition as “the original PC-only version, known for extensive mod support, custom servers, and advanced gameplay mechanics”. To use mods you need three things that agree with each other: a Minecraft version, a mod loader for that version, and mod files built for both.

Nobody here has installed a pack for this guide. Every step, version and warning below comes from the official pages of Mojang, the four loaders, Modrinth, CurseForge and the mods themselves, checked on October 20, 2026.

Java Edition mods and Bedrock add-ons

This guide is about Minecraft: Java Edition. Mojang puts the split simply: “Java Edition is ideal for PC players who want mods and custom servers, while Bedrock Edition is best for cross-platform play on console, PC, or mobile.” Bedrock has its own system, called add-ons. Microsoft’s creator documentation says add-ons “allow players to transform the look of their worlds and even change the behavior of entities”, and they come as .mcpack or .mcworld files. Microsoft presents add-ons as customization for Minecraft: Bedrock Edition, so this guide leaves them out.

What a mod loader does

Vanilla Minecraft does not load mods by itself. CurseForge describes a Vanilla profile as “the unmodified version of Minecraft. No modloader is used, and mods are not supported.” A mod loader is the layer that loads the mod files from your mods folder into the game. Each mod is built for a specific loader, and many mods publish a separate file for each loader they support. The CurseForge app lists the loader types in plain terms: a Forge profile “supports only Forge-compatible mods and modpacks”, and the same goes for Fabric, NeoForge and Quilt.

The four loaders are Forge, NeoForge, Fabric and Quilt.

Forge

Forge’s file server lists builds back to Minecraft 1.1. It offers an installer for the newest build, which on October 20, 2026 is 66.0.13 for Minecraft 26.3, dated October 16, 2026. The page asks visitors to allow its ads, which it calls “Forge’s main source of income”. For its history and a walk through the installer, read the Minecraft Forge guide.

NeoForge

NeoForge is a fork of Forge. Its team says it “was officially announced (ahead of schedule) on July 12, 2023”, and nearly everyone from the original Forge team joined it. Some mods publish separate Forge and NeoForge files. Its builds are numbered after the Minecraft version: the NeoForged Maven lists 26.3.0 builds for Minecraft 26.3. NeoForge exists for 1.20.1, but the NeoForge user guide recommends Forge on that version “since it had longer support for Minecraft 1.20.1”, and recommends NeoForge only on 1.20.2 and newer.

Fabric

Fabric Loader is, in Fabric API’s words, “the (mostly) version-independent mod loader that powers Fabric”. Fabric officially supports “releases 1.14 and above”, and Fabric’s version list includes Minecraft 26.3. Most Fabric mods need a second file: “Most mods will also require you to install Fabric API into the mods folder.” Fabric API describes itself as “the library for essential hooks and interoperability mechanisms for Fabric mods”, and it is a mod you download like any other.

Quilt

Quilt calls itself “an open-source, community-driven modding toolchain for Minecraft” and describes Quilt Loader as “compatible with all your favourite Fabric mods”. There is one caveat on its site: for Minecraft 1.20.6 and later, mods written with Quilt’s own libraries “may need extra work to be ported”, while “Fabric mods for these versions will work fine.” Quilt’s version list also includes 26.3.

Which loader for which Minecraft version

Pick the loader your mods are built for.

Loader support, from the Forge, NeoForge, Fabric and Quilt official pages, October 20, 2026
Loader Newest Minecraft version listed What the official pages say
Forge 26.3 Build 66.0.13, dated October 16, 2026. NeoForge’s guide recommends Forge for 1.20.1.
NeoForge 26.3 Recommended by its team for 1.20.2 and newer.
Fabric 26.3 Supports releases 1.14 and above. Most mods also need Fabric API.
Quilt 26.3 Loads Fabric mods. Quilt-only mods for 1.20.6 and later may need extra porting.

Minecraft version numbers changed in 2026. Mojang now numbers releases by year: “version numbers in the year 2026 will begin with ’26′”, followed by the release number and then the patch number. Minecraft Java Edition 26.3, the Wilderness Bound drop, came out on September 15, 2026. To write mods rather than install them, start from the Mod Generator linked on NeoForge’s homepage or from Fabric’s developer documentation.

Where to download Minecraft mods safely

Fabric’s documentation gives the short rule: “The majority of authors publish their mods to Modrinth and CurseForge.” It adds that these sites “check that the mods are what they say they are, and that they do not contain malicious code”, and that you can report a bad mod there. NeoForge’s guide says the same: “We generally recommend you get your mods on CurseForge or Modrinth.”

Modrinth

Modrinth is a mod host with its own launcher, the Modrinth App. The app page says you can “install, uninstall, and update mods with a single click”, and that it can import instances from the launcher you used before. It runs on Windows, Mac and Linux.

Each Modrinth project page shows which loaders and Minecraft versions every file supports, and whether the mod runs on the client, the server or both. In May 2024 Modrinth disclosed that a mod called “Windows Borderless” was approved with one clean file, and later versions contained credential and token stealers. A user report led staff to decompile the mod and take it down.

CurseForge

CurseForge offers its Minecraft mods on the website and in its own desktop app. The CurseForge blog describes the check each Minecraft mod file goes through: the jar is decompiled, its classes are hashed to catch known malicious files, and new code goes through static analysis. Files that look risky are rejected or “escalated for manual review”.

CurseForge also names a gap in that check. Its May 14, 2026 safety post says: “We cannot scan or verify modpack files sent to you by your friends and imported via the CurseForge app.” It lists the warning signs: “oddly named files, unexpected executables, or overrides that seem unrelated to the pack itself”.

Mods from anywhere else

Fabric’s FAQ notes that some authors publish on their own websites or in a GitHub repository. The risk is the sites that copy them. Fabric’s guide warns: “There are a lot of websites that claim to have mods for Minecraft, but are actually just malware sites.” It suggests a check with Windows Defender or VirusTotal, and then adds: “do not rely entirely on those methods”. When you are unsure about a site, its advice is to ask others or “rely only on trusted sources, such as Modrinth and CurseForge”.

Launchers: the official one or a mod manager

You can mod the game with the official Minecraft Launcher, which Mojang says gives you “mod support” among other things. With it, you install the loader yourself and copy mod files into a folder, as the steps below show. The official launcher “does not offer functionality to automatically install” modpacks, so packs need a third-party launcher.

Prism Launcher runs several Minecraft setups, “each with its own settings, mods, and configurations”, and “interfaces directly with Modrinth and CurseForge”. Quilt’s install page lists ATLauncher, BakaXL, CurseForge, Modrinth App, MeshMC, MultiMC, Prism Launcher, Technic and GDLauncher, with the note that a listing “isn’t an endorsement by The Quilt Project”. Prism is one of these, and the Prism Launcher setup guide runs from install to the first modded instance.

How to install Minecraft mods step by step

With the official launcher and Fabric

These steps come from the Fabric documentation for Windows. Fabric has separate pages for macOS and Linux.

  1. Download the Fabric Installer from fabricmc.net. The Windows .exe does not need Java installed, because it uses the Java that comes with the Minecraft Launcher.
  2. Close Minecraft and the Minecraft Launcher.
  3. Run the installer, select your Minecraft version and click Install. Make sure Create Profile is checked.
  4. Download the mods you want, plus Fabric API, for the same Minecraft version.
  5. Move the .jar files into the mods folder: %appdata%\.minecraft\mods on Windows, ~/Library/Application Support/minecraft/mods on macOS, or ~/.minecraft/mods on Linux.
  6. Open the Minecraft Launcher, select the Fabric profile and click Play.

With the official launcher and NeoForge

The NeoForge client guide assumes you already have the right Java installed. Unlike the Fabric .exe, NeoForge “requires you to install Java yourself”.

  1. Close the Minecraft Launcher.
  2. Download the installer .jar from neoforged.net.
  3. Make sure Install client is selected and click Proceed.
  4. In the launcher, open the Installations tab and click New Installation.
  5. Name it, select the NeoForge version, and set the game directory to a separate folder outside the standard .minecraft folder.
  6. Click Install and start the profile once. A mods folder appears in that game directory, and that is where your mod files go.

The guide gives a reason for the separate folder: it keeps “the mods isolated from the vanilla game”.

With the CurseForge app

CurseForge’s support article on custom profiles has seven steps:

  1. Open the Minecraft section in the CurseForge app.
  2. Click Create.
  3. Name the profile, select a Minecraft version and choose a modloader version.
  4. Go to My Modpacks and click the new profile.
  5. Click Add More Content.
  6. Install the mods, resource packs or maps you want.
  7. Click Play.

With Prism Launcher or the Modrinth App

Both launchers download mods from inside the app: the Modrinth App page says you can “install, uninstall, and update mods with a single click”. The Sodium page adds that a third-party launcher “probably has built-in functionality to automatically install mod loaders”. For Prism, the full click path is in the Prism setup guide.

Match the Minecraft version, the loader and Java

A version or loader mismatch is a common cause of failed installs. CurseForge states the rule: “Each mod file and each profile are set to run on a specific Minecraft version”, and “the mod and the profile must be compatible with the same modloader”. In its app, a profile that does not match a mod’s version and loader cannot even be selected. Fabric’s install steps make the same check: download mods that “work on the version of Minecraft you want to play on”.

Create’s newest file on Modrinth, dated April 21, 2026, is for Minecraft 1.21.1. Check the newest version of your most important mod first, and build the rest of the list around it.

Java is the third part to match. The first 26.x release, 26.1, requires Java 25, according to Mojang’s release notes. Check the release notes of your version. The official launcher brings its own Java. You only install Java yourself for tools that need it, such as the NeoForge installer or the Fabric .jar installer.

Check these two as well:

  • Client or server. Modrinth marks each project with where it runs. Sodium is a client mod and is not supported on servers. Biomes O’ Plenty is required on both sides, so a server and every player need it.
  • Updates. Mojang’s numbering article notes that Minecraft prompts you to update to the latest version by default. A loader profile is made for the one Minecraft version you selected when you installed the loader. Before any loader or mod update, “Always backup your world”: copy the world folder from saves to a safe place first.

Single mods or a modpack

A modpack is a collection “of mods and associated configuration files”, in the words of the NeoForge client guide. The CurseForge app lists modpacks under Browse, with filters for loader, game version and category, and installs a pack with one click on Install. The Modrinth App downloads and plays the modpacks hosted on Modrinth. Because the pack installs as one unit, you do not match each mod’s version and loader yourself.

CurseForge’s article on customizing modpacks says you must turn on Allow content management for this profile to add mods to a downloaded pack, and while it is on, “the modpack cannot be updated or changed to another version”. If you want to pick each mod yourself, build a custom profile instead.

Example Minecraft mods

This guide does not rank mods. Below are ten example mods, each described in its own words, with what Modrinth listed on October 20, 2026.

Example mods, from their Modrinth pages, October 20, 2026
Mod Its own summary Newest Minecraft version Loaders for that version
Just Enough Items (JEI) View Items and Recipes 26.3 Fabric, NeoForge
Create Aesthetic Technology that empowers the Player 1.21.1 NeoForge
Sodium A high-performance rendering engine replacement for Minecraft 26.3 Fabric, NeoForge
Iris Shaders A modern shader pack loader for Minecraft 26.3 Fabric, NeoForge
Jade Shows information about what you are looking at 26.3 Fabric, NeoForge, Quilt
AppleSkin Food/hunger-related HUD improvements 26.3 Fabric, NeoForge
Mouse Tweaks Enhances inventory management by adding various functions to the mouse buttons 26.3 Fabric, Forge, NeoForge
JourneyMap Real-time map used for mapping in-game or your browser as you explore 26.3 Fabric, Forge, NeoForge, Quilt
Xaero’s Minimap Displays a map of the nearby world terrain, players, mobs, entities 26.3 Fabric, Forge, NeoForge, Quilt
Biomes O’ Plenty Adds 50+ unique biomes 26.3 Fabric, Forge, NeoForge

Just Enough Items

JEI’s page calls it “an item and recipe viewing mod for Minecraft, built from the ground up for stability and performance”. Hover over an item and press R for its recipes, or U for its uses. Keys, search prefixes and a full install are in the JEI review.

Create

Create’s README calls it “a mod offering a variety of tools and blocks for Building, Decoration, and Aesthetic Automation”. Its machines are built from animated parts that work together, and its in-game guide, Ponder, explains each mechanic. The main project runs on Forge and NeoForge. The README links a separate Fabric port by another team.

Sodium and Iris

Sodium’s page calls it “a powerful optimization mod for the Minecraft client”. It recommends Fabric Loader “for the most simple and lightweight experience”, and says it “only optimizes the rendering code of Minecraft”. For more, it points to the team’s other mods, such as Lithium, which its page calls a “game logic optimization mod”. Iris is a shader loader that its page says is “intended to be compatible with existing OptiFine shader packs”. Shader packs for Iris have their own Minecraft shaders guide.

Jade, the Waila successor

Jade calls itself a “Hwyla/Waila fork for Minecraft 1.16+” that “shows information about what you are looking at”. How Waila became Hwyla, Jade and WTHIT is told in the Waila article.

Small helpers

AppleSkin adds food and hunger information to the HUD. Mouse Tweaks changes what the mouse buttons do in inventories. JourneyMap and Xaero’s Minimap both draw a map of the area you explore, and Xaero’s page mentions waypoints “which help you find the locations you’ve marked”. On Fabric, Mod Menu “adds a mod menu to view the list of mods you have installed”.

When the game crashes: conflicts and crash reports

When the game crashes, it writes a crash report that “can help you find the cause of the crash”. Reports are stored in the crash-reports folder in the game directory, for example %appdata%\.minecraft\crash-reports on Windows. For third-party launchers, check their documentation for the location.

How to read one, from Fabric’s crash report guide:

  • The ---- Minecraft Crash Report ---- section is “the most important section”, because its stack trace “can usually contain references to the mod that caused the crash”.
  • The first mod named in the stack trace is the first suspect. With many mods involved, “the mod that caused the crash may not be the mod that is at fault”.
  • The -- System Details -- section shows your Java version and memory, and on Fabric a list of every installed mod.
  • Upload the report to a paste site and send the link to the mod author, on their issue tracker or Discord.

When there is no clue at all, use a binary search, as the NeoForge FAQ suggests. Move half of your mods to another folder, keeping each mod’s dependencies with it, and start the game. If the problem stays, repeat with the mods that are still in place. If it goes, swap in the mods you set aside last and repeat. Continue until you find the faulty mod. Visual problems are often caused by outdated graphics drivers.

Before you add or update anything in a world you care about, back it up. If an update goes wrong, delete the updated world, go back to the old loader and mod versions, and copy the backup into saves.

Sources