Fabric Installation Walkthrough for Minecraft Clients
Most modern Minecraft clients ship as Fabric mods. The Fabric installation process is straightforward, but a few small mistakes can cause hours of troubleshooting. This walkthrough covers the full setup with attention to those mistakes.
Short version
Install Fabric Loader for your Minecraft version, download the client .jar, place it in the mods folder, launch the Fabric profile. Verify the file hash before running anything. If something does not load, check the mods folder path and the profile selection first.
Before you start
Have the following ready:
- A clean Minecraft installation or one you can restore if needed.
- The Minecraft version you want to use (for example 1.21.1).
- A downloaded client file from its official source.
- A SHA-256 hash value for verification.
Step 1 — Install Fabric Loader
Go to the Fabric website and download the Fabric Installer for your operating system. Run the installer. Choose your Minecraft version from the drop-down. Leave "Create Profile" checked. Click Install.
The installer creates a new launcher profile named fabric-loader-<version>.
You do not need to replace the vanilla profile — Fabric runs alongside it.
Step 2 — Verify the client file
Before running anything, compute the SHA-256 hash of the client file and compare it against the value listed on the client page under Security Verification. If the hashes differ, do not run the file.
Windows PowerShell:
Get-FileHash -Algorithm SHA256 "C:\path\to\client.jar"macOS or Linux:
sha256sum ~/Downloads/client.jarFull guide: hash verification.
Step 3 — Locate the mods folder
The Minecraft directory differs per operating system:
| OS | Mods folder path |
|---|---|
| Windows | %appdata%\.minecraft\mods |
| macOS | ~/Library/Application Support/minecraft/mods |
| Linux | ~/.minecraft/mods |
If the mods folder does not exist, create it. On macOS and Linux, folder names
are case-sensitive — Mods and mods are different folders.
Step 4 — Place the client file
If the file you downloaded is a .zip archive, extract it first. Then place the .jar file
directly into the mods folder. The .jar must be at the top level of the folder
— not inside a subfolder.
A common mistake: extracting a .zip and moving the containing folder into mods.
That results in the mods folder containing a folder, not a .jar, and Fabric will not load
the client.
Step 5 — Launch the Fabric profile
Open the Minecraft launcher. In the profile dropdown, select the Fabric profile created by the installer. Confirm the version matches the client file. Click Play.
On first launch, the client may take additional time to initialize. This is normal — the client is loading its modules and configuration.
Step 6 — Confirm the client loaded
Once you are in the main menu, look for two indicators:
- The client's watermark in a corner of the screen.
- A response when you press the client's default keybind.
If neither appears, use the in-game mod list (usually reachable from the main menu) to confirm the client is listed. If it is not listed, Fabric did not load the file.
Common mistakes
- Using the vanilla profile. If the launcher is on the vanilla profile, no mods load.
- Wrong Minecraft version. A client built for 1.21.5 will not load on 1.21.1 even if the file name looks similar.
- Missing Fabric API. Many clients require Fabric API. Install it in the same folder.
- Multiple clients in one profile. Two clients loading in the same profile often conflict. Use separate profiles.
- Skipped hash verification. Always verify before running.
When something goes wrong
Check the log file at .minecraft/logs/latest.log. Search for ERROR
or Exception. The first error message usually identifies the failing component.
For a detailed troubleshooting guide, see troubleshooting.