How to Install Fabric and Sodium in 2026 (Step by Step)
Quick answer: Fabric is a lightweight mod loader, and Sodium is a Fabric-only FPS mod by JellySquid (CaffeineMC) that rewrites how Java Edition renders the world. Together they are the standard performance setup. Download the Fabric installer, launch the game once to create the mods folder, then drop the Fabric API and Sodium jars into it and launch the Fabric profile. The whole job takes about ten minutes.
You can go from a stuttering vanilla game to a smooth modded one in about ten minutes. This guide shows how to install Fabric and Sodium on Java Edition in 2026, with exact version numbers and download links that were checked on October 22, 2026. You need a copy of Minecraft Java Edition and a Microsoft account that owns it. Everything here runs on the client only, and every file comes straight from the projects’ own servers.
What the three downloads do
The installer comes from the Fabric project’s own download page. It is a universal .jar file: run it with Java and it installs Fabric Loader 0.19.5 (the current stable release) into your launcher, then adds a new profile called fabric-loader. You run this file exactly once.
Official build · v1.1.2 · Official download
Fabric API is the library most Fabric mods are built on top of. Sodium’s own file lists no dependencies, so it will start without it, but the moment you add a second mod you will almost certainly need it. Each Fabric API file is built for one Minecraft version, so match it to yours: 0.164.0+26.3 for Minecraft 26.3, 0.141.6+1.21.11 for 1.21.11.
Minecraft 26.3 · Fabric · v0.164.0+26.3 · Official download
Sodium 0.9.2 is the FPS mod itself, built for Fabric. It replaces the vanilla render engine with a faster one, and that replacement is where the extra frames come from. Files are version-specific: the one linked here is for Minecraft 26.3. If you are on 1.21.x, grab the matching file from the Sodium versions page on Modrinth instead. If you are weighing Sodium against OptiFine first, our Sodium vs OptiFine head-to-head for 2026 settles the question.
Minecraft 26.3 · Fabric · v0.9.2 · Official download
Pick your Minecraft version first
Minecraft 26.3 is the current release, published on September 15, 2026. Pick it unless you have a concrete reason not to. The reason to pick 1.21.11 instead is a modpack or server that has not moved to the new year-based version numbering yet. Mod support on 1.21.x is broader today, while 26.3 gets the new content and the newest mod releases.
| Minecraft version | Fabric API | Sodium | Java (the launcher installs it for you) |
|---|---|---|---|
| 26.3 (current) | 0.164.0+26.3 | 0.9.2 | Java 25 |
| 1.21.11 | 0.141.6+1.21.11 | 0.8.15-beta.1 | Java 21 |
All three columns have to match the same game version. A Sodium file built for 26.3 will not load on 1.21, and the game will tell you so with an “incompatible mod set” crash. On Java: you do not need to install anything by hand for the game itself. The launcher downloads the right bundled runtime automatically, Java 25 for 26.x and Java 21 for 1.21.x. You only need a separate JDK if the installer .jar refuses to open on your machine.
How to install Fabric and Sodium, step by step
Run the Fabric installer. Double-click the file you downloaded, or run
java -jar fabric-installer-1.1.2.jarfrom a terminal. Keep the Client tab selected, choose your Minecraft version from the dropdown (26.3), leave the loader version on the latest stable, and press Install. When it finishes, the launcher gains a new profile named fabric-loader.Launch that profile once, then close the game. This first launch downloads the loader libraries and creates the mods folder. Nothing modded happens yet.
Download Fabric API and Sodium for your exact Minecraft version using the buttons above.
Open your mods folder. On Windows, press Win+R, type
%appdata%\.minecraft, and open the mods folder inside it. On macOS it lives at~/Library/Application Support/minecraft/mods; on Linux at~/.minecraft/mods. Our full Java Edition mod install guide walks through these folder locations in more detail.
Move both .jar files into mods. Do not unzip them. Minecraft reads mods straight from the .jar.
Back in the launcher, pick the fabric-loader profile from the Profiles dropdown and press Play.
Check that it worked. Load a world and press F3. The debug screen lists the mods you are running, and Sodium shows up there. Then open Options, then Video Settings. Sodium adds its own option pages (Quality, Advanced, Performance). If those pages are present, Sodium is doing the rendering.
Fabric is the loader Sodium was built for. If you are unsure which loader fits your plans overall, our 2026 comparison of Forge, Fabric, and NeoForge lays out the trade-offs for each.
Why Sodium boosts FPS
The vanilla game rebuilds and uploads chunk meshes in ways that waste CPU time, and that waste caps your frame rate long before your GPU breaks a sweat. Sodium rewrites that chunk pipeline: it culls hidden geometry more aggressively, builds meshes on multiple threads, and uploads them to the GPU in bigger, cheaper batches. The practical result is that the gains scale with render distance. At 16 to 32 chunks you will see the biggest jump; at very short render distances the difference is smaller because the renderer was never the bottleneck there.
What to install next
Sodium handles the renderer. Lithium speeds up the game logic and FerriteCore cuts memory use, and the three are the classic trio that people run together. Our list of 8 FPS mods that actually work in 2026 covers the full stack and which ones play nice with Sodium. For shaders, Sodium does not include them on its own: you need Iris, which plugs into Sodium’s rendering pipeline. Iris takes its own jar in the mods folder plus shader packs, so treat it as a separate install.
Mistakes that cost people an afternoon
Launching the vanilla profile by accident and wondering where the mods went. The launcher remembers your last profile, so check the dropdown before every launch.
Putting the jars in Downloads instead of the mods folder. The game only reads the mods folder.
Mixing versions: Fabric API for 26.3 with Sodium for 1.21. Match everything to the same game version.
Double-clicking the installer and having WinRAR or another archive tool open it instead of Java. Right-click the file, choose Open with, and pick Java.
Renaming the jar files or unzipping them. Leave the file names exactly as downloaded.
Troubleshooting
The game crashes before the title screen. This is almost always a version mismatch. Confirm each jar matches your Minecraft version, then empty the mods folder and add mods back one at a time to find the culprit.
“Incompatible mod set” on launch. The Fabric API file does not match the game version. Download the right one from the version table above.
No Sodium pages in Video Settings. You launched the vanilla profile. Switch to fabric-loader and launch again.
The installer will not open. Your system has no Java runtime registered for .jar files. Install a current JDK (Eclipse Temurin is a common pick) and try again, or open a terminal and run it with java -jar directly.
FPS barely improved. Sodium speeds up rendering; if your world was already sitting at your frame cap, nothing changes. Check Options, then Video Settings, then Performance, and lower the render distance a few notches as a test, then tune from there.
Download only from official sources
The Fabric installer comes from the Fabric project (fabricmc.net, served from their own Maven) and the two mod files come from Modrinth, where the projects publish their own releases. All three files are free. Any site that asks you to pay, complete a survey, or run a separate “installer” for these mods is a scam copy. Never type your Mojang or Microsoft password anywhere except the official launcher. The download buttons above point at the exact files on the official servers, and each link was checked on October 22, 2026.
Frequently asked questions
Does Sodium work with Forge?
No official Forge version exists. CaffeineMC, the team behind Sodium, ships it for Fabric and for NeoForge, and since 0.6 it is one codebase with both loader targets. This guide covers the Fabric path, which is the one most tutorials and modpacks use.
Is Fabric free?
Yes. Fabric, Fabric API, and Sodium are all free and open source. Nobody should charge you for any of these files.
Can I use Sodium on Bedrock, consoles, or phones?
No. Sodium is Java Edition only. Bedrock has no mod loaders of this kind.
Which Java version do I need?
The launcher handles this for the game: Java 25 for 26.x, Java 21 for 1.20.5 through 1.21.x. You only touch Java yourself if the installer .jar will not open on your machine.
Will Sodium get me banned from servers?
Sodium is client-side rendering code, not a cheat. Some servers restrict which mods players can use, so check the rules of the server you play on.
How do I update everything later?
Re-run the installer when a new loader comes out, download newer Fabric API and Sodium files built for your Minecraft version, and swap the old jars out of the mods folder. Delete the old versions rather than stacking them, or you will get duplicate-mod errors.
