Skip to content

LWJGL Compatibility

JellySquid edited this page Jan 28, 2025 · 6 revisions

LWJGL Compatibility

Sodium requires that launchers use the same version of LWJGL which Minecraft itself is designed for (more information). However, in some cases, third-party launchers may decide to use the incorrect version of LWJGL, which causes unpredictable behavior, crashes, and other difficult issues.

If you received an error at startup about an incompatible version of LWJGL being used, then read below as to how you can correct the issue for your specific launcher.

Recommended: Change the LWJGL version used by your launcher

MultiMC (and Prism Launcher)

This issue usually occurs on accident when you edit an existing instance to change the version of Minecraft it is using, as the launcher fails to correctly modify the version of LWJGL that is then used.

To resolve this, right-click the instance in your launcher, choose "Edit...", and then choose "Versions" in the sidebar. For the entry labeled "LWJGL 3", click "Change version..." and ensure the version which Sodium asks for is selected. If you still cannot resolve the issue, please ask for help on our official Discord server.

Feather Client

The Feather Client is not supported, and it is currently not possible for users to solve this issue, as it is a bug in their launcher. The only solution is to use another launcher, such as the Modrinth Launcher, which is lightweight and easy to use.

Advanced users only: Allow the game to start even with mismatched libraries

If you are certain the startup error is not indicative of a problem, then you can disable the check by adding the JVM argument -Dsodium.checks.issue2561=false. For more information, please see the documentation about Disabling Bug Checks.