CaffeineMC /sodium
A high-performance rendering engine replacement for Minecraft, which greatly improves frame rates and reduces micro-stutter
★ 5,853⑂ 992👁 78⑃ 753● 3,125▤ 103
+1
日增长
5,853
stars
992
forks
78
watchers
753
prs
3,125
issues
103
releases
README
Sodium
Sodium is a powerful rendering engine and optimization mod for the Minecraft client which improves frame rates and reduces
micro-stutter, while fixing many graphical issues in Minecraft.
This mod is the result of thousands of hours of development, and is made possible thanks to players like you. If you
would like to show a token of your appreciation for my work, and help support the development of Sodium in the process,
then consider buying me a coffee.
---
📥 Downloads
Stable builds
The latest stable release of Sodium can be downloaded from our official Modrinth and
CurseForge pages.
Nightly builds (for developers)
We also provide bleeding-edge builds ("nightlies") which are useful for testing the very latest changes before they're
packaged into a release. These builds are primarily intended for other mod developers and users with expert skills, and do
not come with any support or warranty.
For a complete listing of available nightly builds, please see the wiki page. We also have a Maven repository for including Sodium in your development workspace or build process, for which you can also find documentation on our wiki.
🖥️ Installation
Since the release of Sodium 0.6.0, both the _Fabric_ and _NeoForge_ mod loaders are supported. We generally recommend
that new users prefer to use the _Fabric_ mod loader, since it is more lightweight and stable (for the time being.)
For more information about downloading and installing the mod, please refer to our Installation Guide.
🙇 Getting Help
For technical support (including help with mod installation problems and game crashes), please use our
official Discord server.
📬 Reporting Issues
If you do not need technical support and would like to report an issue (bug, crash, etc.) or otherwise request changes
(for mod compatibility, new features, etc.), then we encourage you to open an issue on the
project issue tracker.
Please note that while the issue tracker is open to feature requests, development is primarily focused on
improving compatibility, performance, and finishing any unimplemented features necessary for parity with
the vanilla renderer.
💬 Join the Community
We have an official Discord community for all of our projects. By joining, you can:
- Get installation help and technical support for all of our mods
- Get the latest updates about development and community events
- Talk with and collaborate with the rest of our team
- ... and just hang out with the rest of our community.
✅ Hardware Compatibility
We only provide official support for graphics cards which have up-to-date drivers that are compatible with OpenGL 4.5
or newer. Most graphics cards released in the past 12 years will meet these requirements, including the following:
- AMD Radeon HD 7000 Series (GCN 1) or newer
- NVIDIA GeForce 400 Series (Fermi) or newer
- Intel HD Graphics 500 Series (Skylake) or newer
Nearly all graphics cards that are already compatible with Minecraft (which requires OpenGL 3.3) sTop issues
#3754Window presentation is broken (black screen) in some cases on Windows/NVIDIA30 comments · 2026-06-22#2740Custom particles from Polytone are not animated22 comments · 2024-09-09#2550Game crashes at startup with GetFileVersionInfoSizeW failed, error=12720 comments · 2024-06-17#3098[<1.21.11] Stuck pixels appearing when on fire on the right top and the left top when Sodium installed18 comments · 2025-04-05#3694Flickering visible on distant animated blocks17 comments · 2026-05-31#3543Bug Report: Block Entities Render Above Camera and Follow Camera Movement When Using Valkyrien Skies + Sodium + Litematica + Indium (1.20.1)16 comments · 2026-03-15#3323Players experience a drop in frames per second when viewing simplified Chinese signage in 1.21.1014 comments · 2025-11-06#2789Transparent textures appear as opaque when using the OBJ model loader14 comments · 2024-10-02
Latest release
Sodium 0.9.2 for Minecraft 26.3 mc26.3-0.9.2 2026-09-15Sodium 0.9.2 is a release for Minecraft 26.3. It's based on the recently released Sodium 0.9.2. Iris is not yet compatible. If you want to use Iris, don't update Sodium until Iris receives an update. - Port to 26.3 (3902) - Re-enable "Fullscreen Resolution" control on Linux (3843) - Fix a memory leak caused by recreating resources in the F3 display - Fix issues with falling blocks