Magnesium is a free and open-source optimization mod for the Minecraft client that improves frame rates, reduces micro-stutter, and fixes graphical issues in Minecraft.

⚠️ Magnesium has had a lot of time to shape up lately, but the mod is still alpha software. You may run into minor graphical issues or crashes while using it.

If you are using the CurseForge client, you can continue to find downloads through our CurseForge page.

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.

Support is not provided for setting up build environments or compiling the mod. We ask that users who are looking to get their hands dirty with the code have a basic understanding of compiling Java/Gradle projects. The basic overview is provided here for those familiar.

• JRE 8 or newer (for running Gradle)
• JDK 8 (optional)
  • If you neither have JDK 8 available on your shell's path or installed through a supported package manager (such as SDKMAN), Gradle will automatically download a suitable toolchain from the AdoptOpenJDK project and use it to compile the project. For more information on what package managers are supported and how you can customize this behavior on a system-wide level, please see Gradle's Toolchain user guide.
• Gradle 6.7 or newer (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.

Sodium uses a typical Gradle project structure and can be built by simply running the default build task. After Gradle finishes building the project, you can find the build artifacts (typical mod binaries, and their sources) in build/libs.

Tip: If this is a one-off build, and you would prefer the Gradle daemon does not stick around in memory afterwards, try adding the --no-daemon flag to ensure that the daemon is torn down after the build is complete. However, subsequent builds of the project will start more slowly if the Gradle daemon is not available to be re-used.

Build artifacts ending in dev are outputs containing the sources and compiled classes before they are remapped into stable intermediary names. If you are working in a developer environment and would like to add the mod to your game, you should prefer to use the modRuntime or modCompile configurations provided by Loom instead of these outputs.

Much like Sodium, Magnesium is licensed under GNU LGPLv3, a free and open-source license. For more information, please see the license file.