Blog
How to Install Fabric and Your First Mods
Install the Fabric loader, add Fabric API, then drop Sodium, Lithium, and ModMenu into your mods folder. A clear zero-to-modded walkthrough for beginners.
What does installing Fabric actually mean?
Installing Fabric means swapping vanilla Minecraft for a version that can read mods. The Fabric loader adds a new profile to your launcher, and that profile knows how to scan a mods folder and run whatever jars it finds. You are not editing the game files by hand. You point an installer at a Minecraft version, it builds the profile, and from then on adding a mod is as simple as moving a file.
That is the whole mental model. Loader on the bottom, a library in the middle, your mods on top.
What you need before you start
Nothing exotic. You need the official Minecraft launcher (or any launcher that supports custom profiles), a Minecraft version you actually want to mod, and a few minutes. Pick your version now and stick to it, because everything downstream has to match it.
How to install the Fabric loader
Run the Fabric installer, point it at your Minecraft version, and let it create the profile. Open your launcher afterward and a new Fabric entry appears in the profile dropdown. That is the loader done.
Download the Fabric installer
Grab the installer from the official Fabric project. It is a tiny program that does one job: write a new profile into your launcher.
Select your Minecraft version
In the installer, choose the same Minecraft version you decided on earlier. Leave the loader version on the latest stable build unless you have a reason not to.
Install and confirm
Run it. When it finishes, open your launcher and check the profile list. A "fabric-loader" entry for your version means it worked.
Add Fabric API, the library nearly every mod needs
Fabric API is the shared toolkit most Fabric mods are built against. Download the build that matches your Minecraft version and drop it straight into the mods folder. Without it, the majority of mods have nothing to hook into and quietly refuse to start, so it goes in before anything else.
Where is the mods folder? It lives inside your Minecraft directory. If it is not there yet, launch the Fabric profile once and close the game, or just create a folder named mods next to your saves and resourcepacks folders.
Your first three mods
Drop these into the same mods folder and you go from playable to genuinely better in one move. None of them need configuration to start paying off.
The starter trio
BeginnerThree jars that upgrade frame rate, smoothness, and control with zero setup.
- Sodium: a rendering rewrite that usually multiplies your frame rate, the biggest smoothness upgrade you can install from a single file
- Lithium: optimizes the game's internal logic (mob AI, physics, ticking) so the world runs lighter without changing how it behaves
- ModMenu: adds an in-game Mods button so you can see what is loaded and tweak each mod's settings without leaving the game
Want the full beginner kit beyond these three? See essential Fabric mods every player should have.
If you are aiming for visuals next, add Iris alongside Sodium and you can run shader packs without OptiFine. Performance base first, eye candy second.
Launch and verify it worked
Start Minecraft on the Fabric profile, open the new Mods button on the title screen, and confirm Fabric API plus your three mods are all listed. If the menu is there and the count looks right, you are modded. If something is missing, the cause is almost always a version mismatch.
- Launcher is set to the Fabric profile, not vanilla
- Fabric API is sitting in the
modsfolder - Every mod jar targets your exact Minecraft version
- ModMenu lists each mod you added
Zero to modded at a glance
| Step | What you do | Where it goes |
|---|---|---|
| 1 | Install the Fabric loader | Adds a launcher profile |
| 2 | Add Fabric API | mods folder |
| 3 | Add Sodium, Lithium, ModMenu | mods folder |
| 4 | Launch on the Fabric profile | Verify in ModMenu |
When a mod refuses to load
The game booting straight into vanilla usually means it could not load your jars and gave up. Work through the obvious causes before reinstalling anything.
Hand-managing jars, versions, and the mods folder is fine for a small setup. When the list grows and you would rather not babysit compatibility, a desktop client like Terminus keeps the loader, library, and mods aligned for you and ships a launcher, so the version-matching is handled before you ever press play.
FAQ
Almost certainly. Fabric API is the shared library most Fabric mods are built against. Install it first, before anything else, or your other jars will refuse to load and the game falls back to vanilla.
Nine times out of ten it is a version mismatch or a missing Fabric API. Every jar in your mods folder has to target the exact Minecraft version your Fabric profile runs. Mix a 1.21 mod into a 1.20 profile and it silently drops out.
Start with Sodium for frame rate, Lithium for smoother server-side logic, and ModMenu so you can see and configure everything from inside the game. Three jars, an instant upgrade, nothing to learn.
Yes. Once Fabric and Fabric API are in place, add Iris alongside Sodium and you can load shader packs without touching OptiFine. Build the performance base first, then layer the visuals on top.
Get Terminus
Loader, library, and mods kept in sync, with no manual jar shuffling.