A moderation message is optional, but it can be used to communicate problems with a project's team members. The body is also optional and supports markdown formatting!
GNU Lesser General Public License v3.0 only
Featured versionsSee all
Sodium is a free and open-source rendering optimization mod for Minecraft 1.16+ which greatly improves frame rates and stuttering while fixing many graphical issues. It boasts wide compatibility with the Fabric mod ecosystem when compared to other rendering-focused mods, and it does so without compromising on how the game looks, giving you that authentic block game feel.
📥 Installation guide
Make sure you have the latest version of Fabric Loader installed. Afterwards, all you need to do is simply drop the mod into your mods folder. No other mods or downloads are required in order to use Sodium. You do not need to create new worlds in order to take advantage of the mod.
Not sure if you installed the mod correctly? Try checking your Video Settings screen in Minecraft, which should show our new and improved user interface for changing settings.
Out of the box, Sodium will enable all optimizations which are supported on your system, meaning no additional configuration is needed. You should generally only change video settings related to performance and other advanced features if you are experiencing issues.
➡️ Note: By design, Sodium only optimizes the client rendering code. You should also install our other mods, such as Lithium and Phosphor, to optimize the other parts of your game. This is done so that players can pick and choose which mods they want to use, but we generally recommend using our entire collection.
The following performance comparisons have been contributed by our community, and show how Sodium can improve frame rates for a wide range of computers, whether fast or slow. Many of our players report a 250% to 500% increase in average frame rates.
- AMD Ryzen 5 2600 / AMD Radeon RX 580 (before 88 fps, after 418 fps)
- Intel Core i3-6100U / Intel HD Graphics 520 (before 17 fps, after 73 fps)
- AMD Ryzen 7 3700X / NVIDIA RTX 3080 (before 61 fps, after 251 fps)
- AMD Ryzen 3 3200G / AMD Vega 8 Graphics (before 58 fps, after 173 fps)
- Intel Core i5-3330 / NVIDIA GeForce GT 1030 (before 36 fps, after 89 fps)
- Intel Core i7-10700K / NVIDIA GTX 1660 SUPER (before 81 fps, after 256 fps)
- Intel Core i7-1165G7 / NVIDIA GeForce MX450 (before 45 fps, after 156 fps)
Even for very slow or unusual machines, people often report significant improvements.
- AMD Athlon II M300 / ATI Mobility Radeon HD 4500/5100 (before 9 fps, after 47 fps)
- Nintendo Switch / ARMv8 Quad-Core CPU / NVIDIA Tegra X1 (before 37 fps, after 108 fps)
Sodium is mostly stable at this point, but it does not yet contain support for the Fabric Rendering API, which a small number of mods currently use. If you try to use these mods with Sodium, your game may crash or behave unexpectedly.
We try to ensure compatibility with most graphics cards that have up-to-date drivers for OpenGL 4.6 Core, which covers most graphics cards released after mid-2010.
- INTEL HD Graphics 500 Series (Skylake) or newer
- NVIDIA GeForce 400 Series (Fermi) or newer
- AMD Radeon HD 7000 Series (GCN 1) or newer
Older graphics cards may also work (so long as they have up-to-date drivers for at least OpenGL 3.3 Core), but hardware requirements are subject to change in future releases.
If you encounter issues with Sodium, you should make sure that your graphics drivers are up-to-date, as this is the most often the culprit of poor performance, crashes, and rendering bugs.
⚙️ Technical details
Of course, we can't just say that the game is magically faster without providing some kind of explanation. This list tries to cover some of the most significant changes which are responsible for performance improvements, but it's not complete or exhaustive of everything Sodium does.
A modern OpenGL rendering pipeline for chunk rendering that takes advantage of multi-draw techniques, allowing for a significant reduction in CPU overhead (~90%) when rendering the world. This can make a huge difference to frame rates for most computers that are not bottle-necked by the GPU or other components. Even if your GPU can't keep up, you'll experience much more stable frame times thanks to the CPU being able to work on other rendering tasks while it waits.
Vertex data for rendered chunks is made much more compact, allowing for video memory and bandwidth requirements to be cut by almost 40%.
Nearby block updates now take advantage of multi-threading, greatly reducing lag spikes caused by chunks needing to be updated. (before, after)
Chunk faces which are not visible (or facing away from the camera) are culled very early in the rendering process, eliminating a ton of geometry that would have to be processed on the GPU only to be immediately discarded. For integrated GPUs, this can greatly reduce memory bandwidth requirements and provide a modest speedup even when GPU-bound.
Plentiful optimizations for chunk loading and block rendering, making chunk loading significantly faster and less damaging to frame rates. (before, after)
Many optimizations for vertex building and matrix transformations, speeding up block entity, mob, and item rendering significantly for when you get carried away placing too many chests in one room.
Many improvements to how the game manages memory and allocates objects, which in turn reduces memory consumption and lag spikes caused by garbage collector activity.
Many graphical fixes for smooth lighting effects, making the game run better while still applying a healthy amount of optimization. For example, take this before and after of a white concrete room in vanilla, or this comparison while underwater.
Smooth lighting for fluids and other special blocks. (comparison)
Smooth biome blending for blocks and fluids, providing greatly improved graphical quality that is significantly less computationally intensive. (comparison)
Animated textures which are not visible in the world are not updated, speeding up texture updating on most hardware (especially AMD cards.)
... and much more, this list is still being written after the initial release.
🐛 Reporting Issues
Please use the issue tracker linked at the top of the page to report bugs, crashes, and other issues.
❓ Frequently Asked Questions
We have a short wiki with some of the most frequently asked questions here. More likely than not, your question already has an answer here.