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 (for MC 1.15+) and 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.

Android devices (and some Windows-on-ARM devices) which use OpenGL translation layers (such as GL4ES, ANGLE, GLonD3D12 etc) are not supported and will have severe performance issues.

We only provide official support for desktop graphics cards which have up-to-date drivers 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 desktop 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. Out-of-date graphics drivers are often the reason for most crashes, rendering bugs, and performance issues.

🐛 How to Report Issues

Please use the issue tracker 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.

Note: The level of performance you see while using the Sodium mod will vary depending on exact hardware and software configuration. For all performance comparisons provided on this page, we used a computer with integrated graphics which we believe to be representative of the casual player.

Hardware configuration: Intel Core i7-1165G7 (4c/8t, up to 4.70 GHz) with Intel Xe Graphics (96 EUs, up to 1.30 GHz), 2x16 GB DDR4-3200. Software configuration: Fedora 41, Linux 6.12.4, Mesa 24.3.4, Prism Launcher 9.1, OpenJDK 21.0.7 runtime (as packaged by distribution), Fabric Loader 0.16.10.