How to Install Fabric Mods in Minecraft

Fabric is a lightweight mod loader that lets you run mods alongside vanilla Minecraft without modifying the base game. This guide walks through installing Fabric, setting up your mods folder, and adding mods so they load automatically.

Prerequisites

Before starting:

• Minecraft Java Edition installed and launched at least once
• Java 17 or newer installed (Java 21 recommended for current Minecraft)
• An internet connection
• Fabric mods downloaded (as JAR files)

Check your Java version by opening a terminal and running java -version.

Step 1: Install Fabric Loader

Follow the Fabric loader installation guide to:

1. Download the official Fabric installer from fabricmc.net
2. Run it and pick your Minecraft version
3. Select the new Fabric profile in your launcher
4. Launch once so the mods folder is created

After this step, you have a working Fabric installation and a mods folder ready for mods.

Step 2: Get the Fabric API

Most Fabric mods depend on the Fabric API, a shared library. Download it:

1. Go to fabricmc.net/use/api
2. Find the version matching your Minecraft version
3. Download the JAR
4. Move it to your mods folder

Step 3: Download and add mods

1. Download mod JARs

   Find mods on sites like Modrinth or CurseForge. Download the JAR file that matches your Minecraft version.

2. Move to mods folder

   Drag each JAR into your mods folder. Don't unzip them—they stay as JAR files.

3. Launch Fabric

   Open Minecraft, select the Fabric profile, and click Play.

4. Verify mods loaded

   In the main menu, go to Mods. You should see your mods listed. If a mod doesn't appear, check its version matches your Minecraft release.

After launch, all mods in your folder load automatically.

Organizing your mods folder

Keep your mods folder clean:

.minecraft/mods/
├── fabric-api-X.X.X.jar
├── mod-name-1.jar
├── mod-name-2.jar
├── mod-name-3.jar
└── (all mods here)

Delete a mod by removing its JAR. No configuration needed, just relaunch.

Handling mod conflicts

Some mods conflict with each other. Signs of conflict:

• Crash on launch with a specific mod loaded
• Game freezes or lags unusually
• One mod's features don't work

To find the culprit:

1. Remove all mods except one
2. Relaunch to confirm it works alone
3. Add mods back one at a time
4. When a crash happens, you've found the conflict

Check the mod's documentation—the author often lists known conflicts.

Version matching explained

This is the most common failure point:

If Minecraft is 1.21 but a mod only supports 1.20.1, it won't load. Always check the mod's download page for supported versions.

Common problems and solutions

• ✓Mod doesn't appear in mod list: double-check it's in the correct mods folder (path above) and you launched the Fabric profile, not vanilla.
• ✓Crash with "cannot find class": Fabric API is missing or wrong version. Download the correct API version for your Minecraft release.
• ✓Version error in logs: your Minecraft, Fabric, API, or mod target different versions. All must match exactly.
• ✓Mod loads but crashes when used: likely a conflict with another mod. Disable others and test in isolation.
• ✓Performance is very slow: you may have too many mods for your hardware. Try disabling the most demanding ones.

Adding Terminus

Terminus is a Fabric mod that runs alongside other mods. To install it:

1. Follow all steps above to set up Fabric and Fabric API
2. Download Terminus from your account dashboard
3. Drop the Terminus JAR in your mods folder
4. Launch Fabric

Terminus loads like any other Fabric mod. Configure it in-game from the mods menu.

FAQ