Mod loader (Minecraft)

A mod loader is the doorman that decides which mods get into your Minecraft party. A mod for the wrong doorman waits outside.

The short answer

A Minecraft mod loader is the software layer that loads mods into the game and gives them a shared set of hooks. The common choices for Java Edition are Fabric, NeoForge and Forge [1][3][6]. Mods are built for one loader and one Minecraft version, so a Fabric mod does not run on NeoForge and the other way round (our assessment from the different mod metadata files [1][3][6]). Paper is a different kind of server: it runs plugins, and its documentation states that it does not support Fabric or Forge mods [7].

How it works

1. Fabric. Fabric is split into the Fabric Loader, which loads your mod and calls its entry point, and the Fabric API, an optional library with common helpers. The API is intentionally kept small so that Fabric can move to new Minecraft versions faster [2]. A mod describes itself in fabric.mod.json in the root of its JAR [1]. Many mods still list it as a requirement, so check each mod page (our assessment).
2. NeoForge. NeoForge describes its mods in neoforge.mods.toml under META-INF, a TOML file that also controls how the mod is loaded [3]. The project began as a fork; it says that the latest Minecraft version at that time was 1.20.1, and that it dropped its 1.20.1 builds after a short while to focus on newer versions [5].
3. Forge. Forge uses a mods.toml file for the same purpose [6]. The NeoForge documentation itself recommends using Forge on Minecraft 1.20.1 because it had longer support there, and NeoForge only on 1.20.2 and newer [4].
4. Version match. Loader, Minecraft version and Java version have to line up. NeoForge's documentation lists Java 17 for Minecraft 1.20.2 to 1.20.4 and Java 21 from 1.20.5 [4].
5. Server versus client. NeoForge's and Forge's guides tell you to test mods in a dedicated server environment, including client-only mods, which should do nothing on the server [3][6].
6. Paper and plugins. Paper says it does not support Fabric or Forge mods and that you must find plugin replacements. It also warns that hybrid servers trying to support both are fundamentally flawed and not recommended [7]. Mods that add new blocks or items cannot be loaded by Paper [7].

A project example

Our own notes show why this matters (inventory as of 14 to 16 Oct 2026). They describe ASHBOUND as a Minecraft 1.20.1 Fabric project, so its mods target Fabric. Our Survival Scoreboard mod exists in two variants, one of them marked NeoForge, and both variants are paused with no current server test recorded. Fixing a bug in one variant does not automatically fix the other, which is why our notes say to align later fixes between the variants deliberately. For 1.20.1, the NeoForge docs even point you to Forge instead [4], so the loader choice is a version choice too.

Checklist

• Decide the Minecraft version first, then the loader [4][5].
• Open the mod's page and check which loader and version it names [1][3][6].
• Install Fabric API on a Fabric server if a mod asks for it [2].
• Match the Java version to the Minecraft version [4].
• Do not mix loaders on one server; use Paper only with plugins [7].
• Test every mod on a dedicated server before you invite players [3][6].