How to Install Fabric API

Fabric API is not a mod itself. It is a library that most Fabric mods depend on to function. If you drop a Fabric mod into your mods folder and the game crashes or the mod does not load, missing Fabric API is the most common reason.

What You Need Before Starting

• Fabric Loader installed. Fabric API does nothing without the loader. If you have not set that up yet, follow the guide on how to install the Fabric Loader first, then come back here.
• Minecraft: Java Edition. Fabric only works on the Java Edition. It does not work on Bedrock, console, or mobile.
• The correct Minecraft version in mind. Fabric API releases are version-specific. A file built for 1.21.1 will not work in 1.20.4.

How to Install Fabric API

1. Go to the official Fabric API page on Modrinth. Search for “Fabric API” on Modrinth or CurseForge. The correct project is published by modmuss50 and has tens of millions of downloads. Do not grab a random result.
2. Select your Minecraft version. On Modrinth, use the version filter on the left side to pick the exact version you play. On CurseForge, use the “Game Version” filter. Get this right. The file name includes the version, for example fabric-api-0.100.1+1.21.1.jar.
3. Download the .jar file. Click the download button for the latest release matching your version. You get a single .jar file. That is correct.
4. Open your mods folder.
   • On Windows, press Win + R, type %appdata%\.minecraft\mods, and hit Enter.
   • On Mac, open Finder, press Cmd + Shift + G, and type ~/Library/Application Support/minecraft/mods.
   • On Linux, navigate to ~/.minecraft/mods.
   • If the mods folder does not exist yet, create it manually inside the .minecraft folder.
5. Move the .jar file into the mods folder. Just drag and drop it in. Nothing to extract or run.
6. Launch Minecraft using the Fabric profile. Open the Minecraft Launcher, select the Fabric profile from the dropdown, and hit Play. If you launch the default vanilla profile, Fabric API will not load.

Once the game loads, Fabric API is active. You will not see it listed as a mod in the main menu unless you also have a mod manager like Mod Menu installed. That is normal.

Common Mistakes and Troubleshooting

The game crashes immediately on launch

Open the crash report or the latest.log file in your .minecraft/logs folder. Look for a line that says something like “Could not find required mod.” That will tell you exactly which mod is missing a dependency. If Fabric API itself is listed, double-check that the .jar file is actually inside the mods folder and not sitting in your Downloads folder still.

Mods still say Fabric API is missing

You probably downloaded the wrong version. Check the file name. The numbers after the + sign in the file name are the Minecraft version. If your file says +1.20.4 but you are playing 1.21.1, that is the problem. Download the correct one and delete the old file.

There are two Fabric API files in the mods folder

Remove the older one. Having two versions of the same library causes conflicts. Keep only the one that matches your Minecraft version.

Fabric Loader is not installed, only Fabric API

These are two separate things. Fabric API is a mod file (a .jar in your mods folder). Fabric Loader is the actual mod loader that gets installed into the Minecraft Launcher. You need both. Neither works without the other.

The mods folder does not exist

This happens when Fabric Loader has never been launched. After installing the Fabric Loader, launch the game once with the Fabric profile. The game will create the mods folder automatically. Then close the game and add your mods.

Which Versions This Applies To

Fabric API works on Minecraft Java Edition starting from version 1.14. There are builds available for most versions up through the current release. Fabric is not available for Bedrock Edition, Windows 10/11 Edition, console editions, or Minecraft Education Edition.

If you are on an older version like 1.12.2 or 1.7.10, Fabric does not support those. For older versions, Minecraft Forge is the loader most mods use. For 1.16.5 and newer, you have the choice between Forge, Fabric, NeoForge, and Quilt depending on which mods you want to run.