How to install Fabric mods for Minecraft
Match every file to the same Minecraft Java version, install Fabric Loader, add declared dependencies and place the JARs in the correct instance's mods folder.
- Difficulty
- Beginner
- Edition
- Java Edition
- Typical time
- 15 minutes
- Updated
- August 25, 2026
Before you start
Fabric mods are for Minecraft: Java Edition. Decide which Minecraft version and launcher instance you will use before downloading anything. A mod built for another edition, loader or version line may not start.
- 01EditionMinecraft Java Edition
- 02Game versionThe exact version used by your instance
- 03LoaderFabric, not Forge or NeoForge
- 04JavaThe version required by that game and mod
- 05DependenciesEvery mod listed as required
Back up important worlds before changing a modded instance. A client-only mod is usually not world data, but testing changes in a copy is still good practice.
Install Fabric Loader
- 01
Close Minecraft and its launcher
This avoids changing a profile while the game is still using it.
- 02
Get the official Fabric installer
Choose the installer appropriate for your operating system from Fabric's official site.
- 03
Select the game version
Pick the same Minecraft version your mods support and leave profile creation enabled for the official launcher.
- 04
Complete installation
Open the launcher again and confirm a Fabric profile is available.
Follow the current official instructions in the Fabric Loader installation guide. Third-party launchers have their own instance setup.
Choose trustworthy, compatible mods
Read the mod's own release page before downloading. Confirm the JAR is for Fabric, Minecraft Java Edition and your version. Then check whether it requires Fabric API, another library or a companion mod.
A file being a .jar does not prove compatibility or safety. Prefer the developer's official website or a profile the developer links directly. Do not rename a JAR to make it look compatible.
Fabric's official Installing Mods guide also emphasizes trusted sources, the correct game edition, matching versions and the correct loader.
Place JARs in the correct mods folder
For the default Minecraft location, the usual folders are:
- WINWindows
%appdata%\.minecraft\mods - MACmacOS
~/Library/Application Support/minecraft/mods - LNXLinux
~/.minecraft/mods
Launchers that manage separate instances commonly use a different folder for each instance. Open the instance's directory from that launcher instead of assuming the default path. Create a folder named mods if the correct instance does not already contain one.
Copy the mod JAR and every required dependency JAR into that folder. Do not extract them.
Launch the Fabric profile and verify
Select the Fabric profile or instance and start Minecraft. Fabric Loader checks declared dependencies before the game completes startup. Read its message carefully: it usually names the missing mod, incompatible version or requirement.
Once the game opens, test the mod in a safe environment. Some client-side mods activate automatically; others add a settings screen or keybind. Use that mod's own documentation rather than guessing.
Fix common Fabric startup problems
| Problem | What to check |
|---|---|
| Missing dependency | Install the exact mod or API named by Fabric Loader for the same game version. |
| Wrong Minecraft version | Replace the mod with a build that explicitly supports the running version. |
| Wrong loader | Use a Fabric build; Forge and NeoForge releases are not interchangeable. |
| Wrong Java version | Use the Java runtime required by that Minecraft and mod release. |
| Duplicate or conflicting files | Remove old versions and add mods back in small groups to isolate the issue. |
| Wrong instance folder | Open the active instance directory from your launcher and inspect its own mods folder. |
Do not bypass declared dependencies as a first fix. Their version ranges are part of the compatibility information supplied by the mod author.
Example: installing current Cipher mods
The three official Cipher releases demonstrate why dependency checks matter:
- AEAntiEffectFabric Loader; no Fabric API or HUB
- BCBetterChatFabric Loader + Fabric API + Cipher HUB 1.0.0+
- HUBCipher HUBFabric Loader + Fabric API
For BetterChat, all JARs must belong to the same 1.21.x or 26.1+ release line.
Common questions
Where is the mods folder?
It is usually inside the active Minecraft or launcher instance directory. Default operating-system paths are listed above.
Do all Fabric mods require Fabric API?
No. Check each mod's declared dependencies. AntiEffect does not require it; BetterChat and Cipher HUB do.
Should I unzip a mod JAR?
No. Place the JAR itself in the mods folder unless that mod's official instructions explicitly say otherwise.