How to Install Fabric Loader (Step by Step)

Installing Fabric takes one tool and a few clicks. Download the official Fabric installer from fabricmc.net, run it, pick the Minecraft version you want to mod, and let it install. A new profile appears in your launcher. Select it, launch the game once, and the mods folder is ready. Your vanilla installation stays completely intact.

What Fabric is

Fabric is a lightweight mod loader that injects itself into Minecraft at launch. It reads your mods folder and loads each mod before the game starts. Because it hooks into the launcher rather than modifying the game jar, you can switch between modded and vanilla anytime by picking a different profile.

Step by step

1. Download the Fabric installer

   Go to fabricmc.net, click Download, and grab the Installer JAR. It's a small Java program, around 1 MB.

2. Run the installer

   Double-click the JAR file, or from a terminal run java -jar fabric-installer-*.jar. A window opens.

3. Pick your Minecraft version

   In the installer, select the exact Minecraft version you plan to play. Older versions, current releases, and snapshots are all listed. Match this precisely—version mismatches are the top cause of crashes.

4. Choose install location

   The installer defaults to your .minecraft folder. For most setups, this is correct. If you use a custom installation, point the installer to it.

5. Install

   Click the Install button. The installer downloads loader files and writes a new profile to your launcher.

6. Select the Fabric profile

   Open your Minecraft launcher and find the new profile (usually named fabric-loader-X.Y). Click it to select it.

7. Launch once

   Click Play. Minecraft starts with the Fabric loader. Let it finish loading completely, then close the game. This creates the mods folder.

After this, your mods folder is ready at %appdata%\.minecraft\mods (Windows), ~/Library/Application Support/minecraft/mods (macOS), or ~/.minecraft/mods (Linux).

What the installer actually does

The Fabric installer does not modify your game jar. Instead, it:

1. Creates a new launch profile in your launcher
2. Downloads the Fabric loader files
3. Writes a fabric-loader-X.Y.json file into your launcher's version folder

When you launch that profile, the launcher starts the Fabric loader first, which loads your mods, and then starts the game normally. Because it's a separate profile, your vanilla profile is completely unaffected.

Official installer vs launcher support

You have two paths to get Fabric installed:

Both end the same way: a Fabric profile you select and launch from.

Files and folders

After installation, your setup looks like this:

.minecraft/
├── versions/
│   ├── 1.21/
│   ├── fabric-loader-1.21/  ← new profile
│   └── ...
├── mods/  ← created after first Fabric launch
└── launcher_profiles.json  ← updated with new profile

Common problems and fixes

• ✓Installer won't open: Java may not be installed or the JAR is associated with the wrong program. Install a current Java runtime from adoptium.net and try again.
• ✓No Fabric profile in the launcher: refresh the launcher (often File > Refresh) or restart it completely. The new profile should appear in the version dropdown.
• ✓Game crashes on startup: check the launcher log. Common causes are version mismatch (loader version doesn't match Minecraft version) or a mod incompatibility. Verify all mods target the same version.
• ✓Wrong Minecraft version selected: re-run the installer and pick the correct version. The installer can write multiple profiles, one per version you want to mod.
• ✓Mods folder doesn't appear: launch the Fabric profile and let the game fully load at least once. The folder is created on first run.

Next steps

Once Fabric is installed:

• Drop mod JARs into your mods folder
• Make sure all mods target the same Minecraft version
• Launch the Fabric profile and the mods load automatically

FAQ