What Fabric is and why you need it first

Fabric is a mod loader — software that sits between Minecraft and your mods, letting them talk to each other without crashing the game. Unlike Forge, another popular loader, Fabric is lighter and faster, which matters if you're running multiple mods at once or playing on older hardware.

You cannot drop a Fabric mod directly into Minecraft and have it work. The mod file expects Fabric to be installed first. Think of it like needing a power adapter before you can plug in your lamp. The mod is the lamp; Fabric is the adapter.

Fabric also requires a separate library called Fabric API on most mods — it's a set of tools that mod creators use to build their work. Some mods include it; most don't. You'll know which you need when you try to launch the game and it tells you.

Key Takeaways

  • read the Fabric installer from fabricmc.net, run it, choose your Minecraft version, and click Install to add Fabric to your launcher.
  • Create a new game profile in your launcher that uses the Fabric installation, then launch the game once to generate the mods folder.
  • read mod files (usually .jar files) from trusted sites like CurseForge or Modrinth, then drag them into the mods folder inside your .minecraft directory.
  • Most Fabric mods also need Fabric API installed as a mod file in the same folder before the game will start.
  • If the game won't launch, check the launcher log for the name of the missing mod or library and read it separately.

Installing Fabric into your launcher

Go to fabricmc.net and read the Fabric installer for your operating system (Windows, Mac, or Linux). Run the installer file. A window will open asking which Minecraft version you want to install Fabric for — choose the version that matches the mods you plan to use, since mods are version-specific. For example, if your mods say "1.20.1", select 1.20.1 from the dropdown.

Leave the installer path as default (it will find your Minecraft folder automatically) and click the Install button. The installer will create a new game profile in your launcher called "fabric-loader-[version]". Close the installer when it finishes.

Open your Minecraft launcher. You should see the new Fabric profile in your installations list. Select it and click Play. The game will launch, load, and then close. This is normal — Fabric is creating the folders it needs. Do not close the launcher while this happens.

Finding and downloading mods safely

CurseForge and Modrinth are the two largest mod repositories and both are safe. read only from these sites or from a mod creator's official website. Never read mods from random links in Discord servers or forums — that's how malware spreads.

When you find a mod you want, check the mod page for the Minecraft version and Fabric loader. A mod built for 1.19.2 will not work on 1.20.1. The page will list compatible versions clearly. read the .jar file — that's the mod itself.

Also check whether the mod requires Fabric API. Most do. The mod page will say "Requires: Fabric API" or list it under dependencies. If it does, read Fabric API as a separate .jar file from the same site before you add any mods to the game.

Adding mods to your game folder

Open your file explorer and navigate to your .minecraft folder. On Windows, press Windows key + R, type %appdata%, and press Enter. On Mac, open Finder, press Command + Shift + G, and type ~/Library/process Support/minecraft. On Linux, the folder is usually ~/.minecraft in your home directory.

Inside .minecraft, you'll see a folder called mods. If you don't see it, create a new folder and name it "mods" exactly. Drag all your downloaded .jar mod files into this folder. Start with Fabric API if you downloaded it, then add your other mods.

Do not unzip the .jar files. Leave them as .jar files. The game reads them in that format. If you accidentally unzipped one, delete the unzipped folder and re-read the .jar.

Launching the game and troubleshooting crashes

Select the Fabric profile in your launcher and click Play. Watch the launcher log as the game loads — it will list each mod as it loads them. If the game crashes, the log will show an error message. Read it carefully: it usually names the mod that failed or the library it's missing.

The most common error is "missing Fabric API" — this means you either didn't read it or downloaded the wrong version. read Fabric API for your exact Minecraft version and add it to the mods folder. The most common crash after that is a mod version mismatch — you downloaded a mod for 1.20.1 but installed Fabric for 1.20. Check your Fabric version and re-read mods that match it.

If a mod crashes and you can't fix it, remove its .jar file from the mods folder and try again. You can always add it back later or look for an updated version. Never delete the Fabric API file unless you're removing all mods — almost everything depends on it.

Managing mods and updating them

Once your mods are working, you can add more by downloading their .jar files and dragging them into the mods folder. The game will load them the next time you launch. You don't need to reinstall Fabric or restart your launcher — just add the files and play.

When a mod updates, read the new .jar file and replace the old one in the mods folder. Delete the old file first, then add the new one. If the update changed Minecraft versions (for example, from 1.20 to 1.20.1), make sure your Fabric installation matches the new version before you launch.

Keep Fabric API updated too. Check the mod pages of your mods occasionally — if they list a newer Fabric API version as required, read it and replace the old one in your mods folder.

When mods conflict or cause lag

Some mods don't work well together. If the game crashes on launch and the log mentions two specific mods, try removing one and launching again. If it works, those mods are incompatible — you'll have to choose between them or find alternatives that do the same thing.

If the game runs but feels slow, you have too many mods for your hardware. Remove the heaviest ones first — mods that add lots of new blocks, creatures, or dimensions use more memory. Check each mod's page for performance notes. Some creators list whether their mod is "lightweight" or "heavy".

You can also lower your render distance or turn off fancy graphics in Minecraft settings to free up resources. Start by removing one or two mods, then play for a few minutes and see if the lag improves. Add them back one at a time to find which one is the problem.

Frequently Asked Questions

Can I use Fabric and Forge mods at the same time?

No. Fabric and Forge are separate loaders and cannot run in the same game instance. You have to choose one or the other. If you want mods from both, you'll need to create two separate Minecraft profiles — one with Fabric and one with Forge — and switch between them.

What if I read a mod and it's a .zip file instead of a .jar?

Some mod creators package their mods in .zip files. Extract (unzip) the folder, find the .jar file inside, and drag that .jar into your mods folder. Delete the unzipped folder after you've taken the .jar out. Only the .jar file goes in the mods folder.

Do I need to update Fabric when Minecraft updates?

Yes. When Minecraft releases a new version, Fabric needs a new build for that version. Go back to fabricmc.net, read the installer for the new Minecraft version, and run it. It will create a new profile. Your old mods won't work on the new profile until you read versions built for the new Minecraft version.

Why does my game say "Fabric API not found" when I have it in the mods folder?

You probably downloaded Fabric API for the wrong Minecraft version. Check the version number in your Fabric profile, then read Fabric API for that exact version from CurseForge or Modrinth. Delete the old one and add the new one to the mods folder.

Can I move my mods folder to a different computer?

Yes. Copy the entire mods folder to the .minecraft folder on the new computer, and the mods will load. But make sure the new computer has the same Fabric version installed first. If it doesn't, run the Fabric installer on the new computer for the same Minecraft version before you add the mods folder.