这个模组是数千小时开发的成果，而这一切多亏了像你这样的玩家才得以实现。 如果你想对我的工作表示感谢，并在此过程中支持Sodium的开发，那么可以考虑请我喝杯咖啡。

Sodium是一款针对Minecraft客户端的强大优化模组，它能大幅提升帧率并改善微卡顿现象，同时修复Minecraft中的许多图形问题。

与其他专注于渲染的模组不同，它在更广泛的模组生态系统中拥有广泛的兼容性。而且它在不影响游戏外观的前提下做到了这一点，让你拥有原汁原味的方块游戏体验。

现在，有了最新版本的Sodium，你可以在所有你喜欢的平台上使用同一个模组。与旧版本分支（如Xenon、Embeddium等）相比，你可以让游戏速度比以前快23%之多！[1]

📥 安装指南

Sodium可用于多种模组加载器，但为了获得最简单和轻量化的体验，我们推荐使用Fabric Loader。如果你使用的是第三方启动器，它可能有内置功能来自动安装模组加载器。一旦你安装好了模组加载器，你只需像安装其他东西一样将Sodium放入你的mods文件夹即可。

不确定是否正确安装了模组？ 查看Minecraft中的视频设置界面，这里应该会显示我们全新改进的用于更改设置的用户界面。

不确定如何配置模组？ 别担心，你可能不需要配置。默认情况下，Sodium会启用你系统支持的所有优化，为你提供最佳体验。通常只有在遇到问题时，你才需要更改与性能及其他高级功能相关的视频设置。

还想要更高的性能？ 从设计上来说，Sodium仅优化Minecraft的渲染代码。你还应该安装我们的其他模组，比如Lithium（适用于MC 1.15+）和Phosphor（适用于MC

✅ 硬件兼容性

我们仅对拥有与OpenGL 4.5或更新版本兼容的最新驱动程序的显卡提供官方支持。过去12年发布的大多数显卡都能满足这些要求，包括以下几种：

• 英特尔HD Graphics 500系列（Skylake）或更新版本
• 英伟达GeForce 400系列（Fermi）或更新版本
• AMD Radeon HD 7000系列（GCN 1）或更新版本

几乎所有已经与Minecraft兼容（Minecraft要求OpenGL 3.3）的显卡也应该能与Sodium一起使用。 但我们的团队无法确保与较旧显卡的兼容性或提供相关支持，并且它们可能无法与Sodium的未来版本一起使用。

如果你遇到问题，你应该确保你的显卡驱动是最新的。 过时的显卡驱动通常是大多数崩溃、渲染错误和性能问题的原因。

使用OpenGL转换层（如GL4ES、ANGLE、GLonD3D12等）的安卓设备（以及一些Windows on ARM设备）不受支持，并且很可能无法与Sodium一起使用。这些转换层未实现所需功能，并且存在无法解决的底层驱动程序错误。

🐛 如何报告问题

请使用问题跟踪器报告错误、崩溃和其他问题。确保你包含正在使用的模组信息，并附上你拥有的任何崩溃/日志文件。

❓ 常见问题

我们在这里有一个简短的维基页面，包含一些最常见的问题。很有可能，你的问题已经在这里有答案了。

注意： 使用Sodium模组时你所看到的性能水平会因确切的硬件和软件配置而异。对于本页面提供的所有性能比较，我们使用的是一台集成显卡的电脑，我们认为这能代表普通玩家的情况。

硬件配置： 英特尔酷睿i7 - 1165G7（4核/8线程，最高4.70 GHz）搭配英特尔Xe Graphics（96 EU，最高1.30 GHz），2x16 GB DDR4 - 3200。 软件配置： Fedora 41，Linux 6.12.4，Mesa 24.3.4，Prism Launcher 9.1，OpenJDK 21.0.7运行时（由发行版打包），Fabric Loader 0.16.10。

[^1] 在Minecraft 1.21.1和NeoForge 21.1.128上，使用Sodium 0.6.9和Embeddium 1.0.15（撰写本文时的最新版本）进行测量，使用默认设置，禁用垂直同步和帧率限制，渲染距离为24个区块。

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.

Sodium is a powerful optimization mod for the Minecraft client, which greatly improves frame rates and micro-stutter, while fixing many graphical issues in Minecraft.

Unlike other rendering-focused mods, it boasts wide compatibility with the wider modding ecosystem. And it does so without compromising on how the game looks, giving you that authentic block game feel.

And now, with the latest version of Sodium, you can use the same mod on all of your favorite platforms. Compared to older forks (Xenon, Embeddium, etc.,) you can turbo-charge your game to be as much as 23% faster than before![1]

📥 Installation Guide

Sodium is available for multiple mod loaders, but we recommend using Fabric Loader 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 (for MC 1.15+) and Phosphor (for MC

✅ 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. 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 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. More likely than not, your question already has an answer here.

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.

[^1] As measured with Sodium 0.6.9 and Embeddium 1.0.15 (latest as of time of writing) on Minecraft 1.21.1 and NeoForge 21.1.128, using default settings with V-Sync and frame rate limits disabled, at a render distance of 24 chunks.