**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](https://caffeinemc.net/donate).

---

Sodium is a powerful rendering engine and optimization mod for Minecraft 1.16+ which greatly improves performance and graphical quality. It boasts great compatibility with the wider 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

Sodium is available for multiple mod loaders, but we recommend using [Fabric Loader](https://fabricmc.net/use) for the most simple and lightweight experience. If you are using a third-party launcher, it probably has built-in functionality to automatically install mod loaders. Once you have installed your mod loader, you can simply place Sodium into your _mods folder_ like anything else. **Not sure if you installed the mod correctly?** Check your _Video Settings_ screen in Minecraft, which should show our new and improved user interface for changing settings. **Not sure how to configure the mod?** Don't worry, you probably don't need to. By default, Sodium will enable all optimizations which are supported on your system, giving you the best experience possible. You should generally only change video settings related to performance and other advanced features if you are experiencing issues. **Need even more performance?** By design, Sodium only optimizes the rendering code of Minecraft. You should also install our other mods, such as [Lithium](https://modrinth.com/mod/lithium) (for MC 1.15+) and [Phosphor](https://modrinth.com/mod/phosphor) (for MC <1.19), 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](https://modrinth.com/user/jellysquid3).

✅ 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: - INTEL HD Graphics 500 Series (Skylake) or newer - NVIDIA GeForce 400 Series (Fermi) or newer - AMD Radeon HD 7000 Series (GCN 1) or newer **Nearly all graphics cards that are already compatible with Minecraft (which requires OpenGL 3.3) should also work with Sodium.** But our team cannot ensure compatibility or provide support for older graphics cards, and they may not work with future versions of Sodium. **If you are running into problems, you should [make sure that your graphics drivers are up-to-date](https://github.com/CaffeineMC/sodium/wiki/Driver-Compatibility).** Out-of-date graphics drivers are often the reason for most crashes, rendering bugs, and performance issues. Android devices (and some Windows-on-ARM devices) which use OpenGL translation layers (such as GL4ES, ANGLE, GLonD3D12 etc) are not supported and will very likely not work with Sodium. These translation layers do not implement required functionality and they suffer from underlying driver bugs which cannot be worked around. # 🐛 How to Report Issues Please use the [issue tracker](https://github.com/CaffeineMC/sodium/issues) linked at the top of the page to report bugs, crashes, and other issues. Make sure you include information about the mods you are using, and attach any crash/log files you have. # ❓ Frequently Asked Questions We have a short wiki with some of the most frequently asked questions [here](https://github.com/CaffeineMC/caffeine-meta/wiki/FAQ). More likely than not, your question already has an answer here. # ⚙️ Technical details So, how exactly does Sodium work? We obviously cannot just say that the game is magically faster without providing some kind of explanation. The following list tries to cover some of the most significant changes which are responsible for our performance improvements, but it's not complete or exhaustive of everything Sodium does. - We replace all of Minecraft's world rendering code with our own implementation that is built upon modern rendering techniques. For chunk rendering, we make use of _geometry batching_ and _draw pass consolidation_, which greatly reduces the amount of CPU overhead involved in rendering the world. Sodium isn't just an optimization mod... it's more like a rendering engine. - We use a much more compact format for world geometry, which allows for up to a ~40% reduction in the amount of video memory used by chunks. Additionally, we make use of a second culling pass to eliminate geometry which is facing away from the camera (but still within the camera's view) so that the GPU does not need to process hidden geometry. Together, these optimizations reduce video memory bandwidth requirements significantly, which is one of the game's biggest bottlenecks. - We use a fully-rewritten system for generating chunk geometry, including the biome colorization, lighting, and shading passes. This is often much faster than the vanilla code, which helps to make chunk loading faster and less CPU-intensive. ([before](https://streamable.com/3taw22), [after](https://streamable.com/4pesh2)) - We use a custom threading implementation which ensures chunk updates are better able to take advantage of multi-core CPUs, which greatly reduces the lag spikes that are caused by placing/breaking blocks. ([before](https://streamable.com/lm5sp5), [after](https://streamable.com/nsdl0r)) - We've written many optimizations for vertex building and transformation, which helps to speed up immediate-mode rendering. This noticeably improves performance in heavy scenes, such as when many entities are visible. - We've made numerous improvements to how the game manages memory and allocates objects, which in turn reduces memory consumption and lag spikes caused by garbage collector activity. - Animated textures which are not visible in the world are not updated, speeding up texture updating on most hardware (especially AMD cards.) Many people are used to performance optimization meaning that the game will look worse, but in our case, we actually improve the graphical fidelity of Minecraft in most situations. - Biome colors for blocks and fluids are smoothed across block faces, providing greatly improved graphical quality that is significantly less computationally intensive. ([comparison](https://cdn.modrinth.com/data/AANobbMI/images/6b0e58705156ba67a6d97a74b9f9ac05da69f502.webp)) - Smooth lighting now works correctly on fluids and other special blocks ([comparison](https://cdn.modrinth.com/data/AANobbMI/images/d84313e6f57dc9e7896961dbd2dfc2689d482758.webp)) We also fix a number of graphical issues with block shading ([comparison](https://cdn.modrinth.com/data/AANobbMI/images/56c4599efcb529a19aed0e118caad4178d7fd540.webp)) which helps to make everything look smoother.

Rudimentary

v1.0 (First Accurate Version)

vA1 (Initial Alpha)