Sodium | Big FPS Gains for the Minecraft Client

If your frame rates collapse the moment you load into a big modpack or a dense forest, you are exactly who Sodium was built for. This optimization mod targets the Minecraft client itself, pushing frame rates up and cutting micro-stutter while fixing a long list of graphical bugs. It has been downloaded around 187 million times, and it does all that without changing how the game looks. Even better, the default setup enables every optimization your system supports, so most players never touch a single setting.

How Sodium Improves Frame Rates and Micro-Stutter

Sodium rebuilds how Minecraft renders the world. The stock renderer leaves performance on the table, and this mod reworks that pipeline for much better frame rates and far less micro-stutter. It also fixes many graphical issues vanilla players run into. The scope is deliberate, since Sodium only optimizes rendering code by design, so nothing about how the game plays or looks changes, keeping that authentic block game feel. Exact performance depends on your hardware and software setup.

Because it sticks to rendering, the developers recommend pairing it with more mods from their collection. Lithium and Phosphor optimize other parts of the game, like game logic and lighting, and the project page spells out which one fits your release. For even more gains, our Entity Culling post covers a companion mod that stops the game rendering entities you cannot see.

Compatibility With Mods and Resource Packs

Performance mods have a reputation for breaking half the modpack they touch. Sodium boasts wide compatibility with the wider modding ecosystem instead, so it slots into big packs without drama. A newer Config API also lets other mods add their own option pages to Sodium's settings screen, with boolean, integer, and enum options.

Resource packs come with one caveat. Packs that replace Minecraft's internal core shaders are unsupported, and the project wiki is blunt that compatibility with any alternative renderer is impossible. Those packs can also tank your FPS, since making a single opaque block transparent swaps the shader for every solid block and disables early-fragment-test optimizations. Packs built for the classic all-in-one performance mod need small companion mods for their extras. No Fog removes fog, Continuity adds connected textures, and Gamma Utils pushes brightness past the normal cap.

Video Settings and Config Files

The first thing you will notice after installing is the rebuilt video settings interface. Sodium replaces the stock screen with a new, cleaner interface for changing settings. Out of the box it enables everything your system supports, so you probably do not need to configure anything. Only dig into performance settings if you are chasing a problem.

Under the hood sit three config files, and the wiki says editing them is rarely necessary. sodium-options.json stores everything configurable in the settings UI, and deleting it regenerates defaults at next launch. sodium-mixins.properties controls the runtime patches Sodium applies, which is advanced territory, though it can rescue a mod conflict by disabling something like the cloud patches with one line. sodium-fingerprint.json identifies your installation so machine-specific options reset cleanly when configs move between computers, and modpack authors can exclude it since it harmlessly regenerates. Our Mod Menu post covers a handy companion for browsing and tweaking mods in-game.

How to Install Sodium

Sodium runs on Fabric, NeoForge, and Quilt, and the team recommends Fabric for new users because it is lightweight and simple.

1. Install a mod loader. Most third-party launchers can add one for you from a settings menu. If yours cannot, download Fabric Loader from the official Fabric site and run the installer.
2. New to loaders? Our Fabric loader guide covers the whole setup.
3. Download Sodium from the official project page and drop the jar into your mods folder like any other mod.
4. Start the game and open Video Settings. If the new Sodium interface shows up there, the mod loaded correctly.
5. Update your graphics drivers if anything breaks. Sodium needs drivers compatible with OpenGL 4.5 or newer, and NVIDIA drivers older than 536.23 are known-broken, with a launch check you cannot disable. Grab drivers straight from NVIDIA, AMD, or Intel, never through Windows Update or a vendor assistant utility.

Most desktop graphics cards from the past 12 years qualify. The official minimums are Intel HD Graphics 500 Series, NVIDIA GeForce 400 Series, or AMD Radeon HD 7000 Series or newer, and nearly any card that already runs Minecraft should cope. Android and Windows-on-ARM devices relying on OpenGL translation layers like GL4ES or ANGLE are the exception, unsupported and prone to severe performance issues.

For crashes and rendering bugs, the team's official Discord server is the recommended place for technical support.

Sodium FAQ

Does Sodium need to be installed on the server too?

No. Sodium is a client-side mod, and the project lists server-side support as unsupported. Install it on your own game only.

Do I need to configure Sodium after installing?

No. Defaults enable every optimization your system supports. Three config files exist for special cases, but the wiki says modifying them is rarely necessary.

Can I use shaders with Sodium?

Yes. The popular shader loader built for Sodium bundles it, so installing that single mod gives you both the optimizations and shader support in one go.

Is Sodium still being updated?

Yes. The latest update landed in July 2026, and the team's support policy gives current releases the newest features and fixes while older branched versions get slower maintenance updates. It is a volunteer project with no warranty, so support depends on available time.

Sodium is about as close to a must-have as mods get, and setup takes minutes. If you are brand new to modding, our full guide to installing Minecraft mods covers the basics, and our shader installation guide takes you from a smooth client to a fully shaded one.

Screenshots: IMS · via Modrinth