About Fabric
Fabric is a lightweight modding toolchain for Minecraft: Java Edition, and it's the foundation a lot of popular mods are built on, Sodium included. When a mod tells you to "install Fabric" first, this is what it means.
The word "Fabric" gets used loosely, but it actually covers a few separate parts. Knowing which is which will save you a lot of confusion later, so here's the short version.
Fabric Loader vs Fabric API
Fabric Loader is the mod loader, the program that plugs into Minecraft and loads your mods when the game starts. It's built to be mostly independent of any single Minecraft version, which is a big part of why Fabric is usually ready for a new Minecraft update so fast. The loader doesn't have to be rebuilt from the ground up every time Mojang ships a patch.
Fabric API is a different thing entirely. It's a shared library of features that mod developers build against, and it's packaged as a mod you drop into your mods folder. Most Fabric mods expect it to be there. It's tied to specific Minecraft versions, so its version number changes on its own schedule, separate from the loader.
The loader runs your mods. Fabric API is a library many of those mods lean on. You set the loader up once with an installer, then add Fabric API alongside your other mods.
Two more names come up if you read around: Fabric Loom and Yarn. Loom is a Gradle plugin developers use to build mods, and Yarn is a set of open mappings that make Minecraft's code readable to work with. Both live on the development side. Neither is something you install to play.
Why players use Fabric
Speed is the big draw. Fabric tends to support a new Minecraft version within a few days of release, so the performance and technical crowd leans on it heavily. Plenty of well-known mods are Fabric-first, and some are Fabric-only.
It also stays out of the way. With only the loader installed, Minecraft plays exactly like vanilla: nothing changes until you start adding mods. That keeps your setup clean and makes conflicts less likely down the line.
Supported Minecraft versions
Fabric has supported Minecraft since 1.14, and it's kept pace with releases through the current 26.2. In practice, the latest Fabric Loader covers a very wide range of versions, though support for any specific Minecraft version ultimately depends on the Loader and Fabric API builds available for it, so it's always worth checking that a build exists for the exact version you want to play.
Fabric API is the piece you match to your Minecraft version. A build made for 26.2 is meant for 26.2, and using the wrong one is a classic cause of crashes. When you download Fabric API, confirm its version lists your Minecraft version.
Do you need Fabric API?
Most of the time, yes. The majority of Fabric mods list it as a dependency and won't load without it. A few mods are deliberately written to run without it (some performance and speedrunning mods go this route), but they're the exception. Running more than a mod or two? Just install Fabric API and skip the guesswork.
Here's the catch people miss: Fabric API doesn't come with Fabric Loader. Installing the loader does not install the API. They're two separate downloads and two separate steps.
Fabric vs Forge and NeoForge
Fabric, Forge, and NeoForge are all mod loaders, and they don't mix. A Fabric mod won't run on Forge, and a Forge mod won't run on Fabric. Each mod is built for one loader, and you run one loader per Minecraft profile.
Fabric is the lightweight, fast-updating side of things, and it dominates performance mods and smaller technical mods. Forge has been around far longer and carries a deep catalog of big content and tech mods. NeoForge is a newer fork of Forge that much of that community has shifted to. There's no outright winner: what usually decides it is which loader your mods are made for.
Client-side and server-side
Fabric runs on both the client and dedicated servers. Individual mods vary: some are client-only, which is common for visual and performance mods, some are server-only, and some have to be on both sides to work. A mod's page normally spells out which it needs.
Joining someone else's server usually means you only install what that server asks for. Client-side mods like Sodium don't go on the server at all.
Keeping Fabric updated
Moving to a new Minecraft version is a two-part job. You install the newer Fabric Loader through the installer, then update your mods (Fabric API included) to builds made for that version. Swapping the loader while leaving old mods in place won't work, and that mismatch is behind a lot of "my game won't launch after updating" posts. Update the loader and the mods together and you'll avoid most of it.
How to Download Fabric for Minecraft
Fabric arrives as an installer rather than a file you drop into a folder, and two things decide which one you want: your Minecraft version, and whether you're on Windows, macOS, or Linux. The download isn't quite the same across them.
Windows users get a .exe installer that doesn't need Java set up separately, because it uses the Java that already ships with the Minecraft Launcher. Every platform can also use the universal .jar installer, but that one needs Java installed on your system to run. On top of the loader, most mods will want Fabric API, which you grab separately from Modrinth or CurseForge as a normal mod file.
Open the Download section on this page to pick up the installer. The row there leads to fabricmc.net, which is the only place the loader itself is published. Fabric API and the mods you add afterwards come from trusted sources like Modrinth or CurseForge. New to mods in general? Our guide to installing Minecraft mods walks through the wider process.
How to Install Fabric for Minecraft
These steps are for the official Minecraft Launcher. If you use a third-party launcher, check its own docs; many of them can install Fabric for you automatically.
Installing Fabric on Windows
- Close Minecraft and the Minecraft Launcher.
- Open the Download section on this page and follow it through to the installer, taking Download for Windows for the
.exe.
- Open the installer, choose your Minecraft version, make sure Create Profile is ticked, and click Install.
- Open the Minecraft Launcher, pick the Fabric profile from the dropdown in the bottom-left, and hit Play.
Installing Fabric on macOS
- Make sure Java is installed: the universal installer needs it.
- Close Minecraft and the Minecraft Launcher.
- Take the universal
.jar installer from the Download section, using the Download installer (Universal/.JAR) option.
- Run it. If macOS says it can't verify the file, go to System Settings → Privacy & Security and choose Open Anyway.
- Select your Minecraft version, keep Create Profile ticked, and click Install.
- Open the Minecraft Launcher, select the Fabric profile from the dropdown, and click Play.
Installing Fabric on Linux
- Make sure Java is installed.
- Close Minecraft and the Minecraft Launcher.
- Fetch the universal
.jar installer from the Download section and run it.
- Choose your Minecraft version, keep Create Profile ticked, and click Install.
- Launch the game through the new Fabric profile.
Where Fabric mods go
Mods are .jar files, and they go in your mods folder inside the Minecraft directory:
- Windows:
%appdata%\.minecraft\mods
- macOS:
~/Library/Application Support/minecraft/mods
- Linux:
~/.minecraft/mods
Paste any of those into your file explorer's address bar to jump straight there. Don't see a mods folder? Run the game once through the Fabric profile and it'll create one. Then drop your mods (and Fabric API) inside.
How to know Fabric is working
Start Minecraft through the Fabric profile and check the bottom of the main menu. Next to the Minecraft version, you'll see a line for Fabric Loader. That's the sign it's running. If you want an in-game list of everything you've installed, add the Mod Menu mod, which isn't included by default.
Common installation problems
If the game crashes on launch or won't start after you add mods, run through these:
- Missing Fabric API. Mods failing to load, with logs pointing at missing classes, usually means Fabric API isn't in the mods folder.
- Version mismatch. Every mod, plus Fabric API, has to match the Minecraft version you're launching. A mod for 1.21.8 might not run on 1.21.11.
- Wrong loader. Fabric mods only work on Fabric. A Forge or NeoForge mod won't load in a Fabric setup.
- Wrong profile. Double-check you're launching the Fabric profile and not vanilla.
Still stuck? The crash report and latest log will usually name the mod that's causing it, and our guide to mods that will not load covers how to read them.