How to Install the Fabric Loader for Minecraft

Learn how to install the Fabric Loader for Minecraft Java Edition, add Fabric API, and get your mods running in minutes with this step-by-step guide.

Fabric is a lightweight mod loader for Minecraft Java Edition. It installs fast, supports a huge range of mods, and stays up to date with new Minecraft versions quicker than most alternatives. Here is exactly how to get it running.

What You Need Before You Start

  • Minecraft Java Edition already installed and launched at least once.
  • Java installed on your computer. For Minecraft 1.17 and newer you need Java 17 or later. For 1.16.5 and older, Java 8 works. The official Minecraft launcher bundles its own Java, but the Fabric installer needs Java available system-wide to run as a .jar file.
  • The Fabric Installer, downloaded from the official Fabric site (fabricmc.net). Always grab it from there, not from random mirrors.
  • Fabric API, which most Fabric mods depend on. This is a separate download from Modrinth or CurseForge, not part of the installer.

Fabric only works with Java Edition. It does not work with Bedrock Edition, Windows 10/11 Edition, or any console version.

How to Install the Fabric Loader

  1. Download the Fabric Installer. Go to fabricmc.net and click the Download Installer button. You will get a file named something like fabric-installer-1.0.x.jar.
  2. Run the installer. On Windows, you can double-click the .jar file if Java is properly installed. If nothing happens, open a command prompt in the folder and run java -jar fabric-installer-1.0.x.jar (replace the filename with whatever you downloaded).
  3. Pick your Minecraft version. In the installer window, use the Minecraft Version dropdown to choose the version you play. Leave the Loader Version on the latest option unless you have a specific reason to change it.
  4. Check the install location. The default path points to your standard .minecraft folder. If you use a custom launcher or profile folder, change this to match. Leave “Create profile” checked.
  5. Click Install. The installer downloads the Fabric loader files and sets up a new profile in your Minecraft launcher. It takes about 10 to 30 seconds.
  6. Open the Minecraft Launcher. In the launcher, click the Installations tab or the profile selector in the bottom left. You should see a new profile called “fabric-loader-X.X.X-1.XX.X” or similar. Select it.
  7. Launch Minecraft once with Fabric before adding any mods. This lets the loader initialize and creates the mods folder inside your game directory. Close the game once it loads the title screen.

For a more detailed walkthrough with screenshots, see the Fabric Loader installation guide on this site.

Adding Fabric API and Your Mods

The Fabric Loader on its own does not add any mods. You need to put mod files into the mods folder manually.

  1. Find your mods folder.
    • Windows: Press Win + R, type %appdata%\.minecraft\mods, press Enter.
    • Mac: Open Finder, press Cmd + Shift + G, enter ~/Library/Application Support/minecraft/mods.
    • Linux: Navigate to ~/.minecraft/mods.

    If the mods folder does not exist yet, create it yourself or launch Fabric once first.

  2. Download Fabric API. Search for “Fabric API” on Modrinth (modrinth.com) or CurseForge. Make sure you pick the version that matches your Minecraft version exactly, for example 1.21.4 mods will not work in 1.21.1. Download the .jar file.
  3. Drop Fabric API into the mods folder. Just copy the .jar file in. Do not unzip it.
  4. Add your other mods the same way. Each mod is a single .jar file. Put them all in the mods folder. Always match the mod version to your Minecraft version and check that each mod says it supports Fabric (not Forge or NeoForge).
  5. Launch Minecraft using the Fabric profile. If any mod fails to load, you will usually see an error screen listing which mod caused the problem and why.

Common Mistakes and Troubleshooting

Game crashes on launch with no error screen

Check your Java version first. Open a terminal and run java -version. If you are playing 1.18 or newer and Java says version 8, that is your problem. Install Java 17 or 21 and try again.

Mods are not loading even though they are in the folder

Make sure you launched with the Fabric profile, not the vanilla profile. In the launcher, the profile name should include “fabric-loader”. Also confirm each mod file ends in .jar, not .zip or anything else.

“Missing dependency” error at launch

Most Fabric mods require Fabric API. If you see a message about a missing library or dependency, adding Fabric API to your mods folder usually fixes it. Some mods also depend on other specific libraries, which the error screen will name.

Mixing Fabric and Forge mods

Fabric and Forge are separate mod loaders. Fabric mods do not work with Forge and vice versa. Check the mod page before downloading to confirm it supports Fabric. If you want to use Forge mods, you need a separate Forge profile. The same applies to NeoForge.

Wrong Minecraft version

A mod built for 1.20.1 will not load in 1.20.4. Always read the mod page and download the file labeled for your exact version. When in doubt, stick to one Minecraft version and only download mods that match it.

The installer will not open

Right-click the .jar file and choose “Open with” then pick Java. If that option is missing, Java may not be installed or associated with .jar files. Install Java from adoptium.net and try again.

Which Minecraft Versions and Editions Does Fabric Support?

Fabric supports Minecraft Java Edition starting from version 1.14. Most active mod development happens on the latest few releases, so you will find the most mods available for recent versions like 1.20.x and 1.21.x. Older versions like 1.16.5 and 1.18.2 still have decent mod libraries if you prefer staying on a specific release.

Fabric does not support Bedrock Edition, Pocket Edition, or any console version of Minecraft. If you want performance improvements on Java Edition without a full mod setup, OptiFine installs differently and does not use Fabric.

Fabric is also an alternative to Quilt, which is a fork of Fabric and can run most Fabric mods. They are compatible in most cases but are still separate loaders.

Leave a Reply

Your email address will not be published. Required fields are marked *