Sodium is a free and open-source optimization mod for the Minecraft client which improves frame rates and reduces micro-stutter while fixing many graphical issues in Minecraft.

The latest releases of Sodium are published to our official Modrinth and GitHub release pages. These releases are considered by our team to be suitable for general use, but they are not guaranteed to be free of bugs and other issues.

For more information about downloading and installing the mod, you can read our installation guide on Modrinth. It also contains information about any currently known compatibility issues, which are often useful to read.

You can report bugs and crashes by opening an issue on our issue tracker. Before opening a new issue, use the search tool to make sure that your issue has not already been reported and ensure that you have completely filled out the issue template. Issues that are duplicates or do not contain the necessary information to triage and debug may be closed.

Please note that while the issue tracker is open to feature requests, development is primarily focused on improving hardware compatibility, performance, and finishing any unimplemented features necessary for parity with the vanilla renderer.

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.

We only provide support for graphics cards which have up-to-date drivers for OpenGL 4.6. Most graphics cards which have been released since year 2010 are supported, such as the...

• AMD Radeon HD 7000 Series (GCN 1) or newer
• NVIDIA GeForce 400 Series (Fermi) or newer
• Intel HD Graphics 500 Series (Skylake) or newer

In some cases, older graphics cards may also work (so long as they have up-to-date drivers which have support for OpenGL 3.3), but they are not officially supported, and may not be compatible with future versions of Sodium.

Devices which need to use OpenGL translation layers (such as GL4ES, ANGLE, 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.

Sodium uses a typical Gradle project structure and can be compiled by simply running the default build task. The build artifacts (typical mod binaries, and their sources) can be found in the build/libs directory.

We recommend using a package manager (such as SDKMAN) to manage toolchain dependencies and keep them up to date. For many Linux distributions, these dependencies will be standard packages in your software repositories.

• OpenJDK 17
  • We recommend using the Eclipse Temurin distribution, as it's known to be high quality and to work without issues.
• Gradle 8.2.1 (optional)
  • The Gradle wrapper is provided in this repository can be used instead of installing a suitable version of Gradle yourself. However, if you are building many projects, you may prefer to install it yourself through a suitable package manager as to save disk space and to avoid many different Gradle daemons sitting around in memory.
  • Typically, newer versions of Gradle will work without issues, but the build script is only tested against the version specified by the wrapper script.

Except where otherwise stated, the files in this repository are provided under the terms of the GNU LGPLv3, a free and open-source license. For more information, please see the license file.

When submitting pull requests to this repository, it is assumed that you are licensing your contribution under the GNU LGPLv3, unless you state otherwise.