📖 概述

Sodium 是适用于 Minecraft 1.16+ 客户端的免费的强大渲染引擎暨优化模组，它在修复一些图形问题的同时大大提高了渲染性能。与其他以渲染为重点的模组相比，它与 Fabric 的模组生态系统具有广泛的兼容性，且不会影响游戏的画面，让你体验到原汁原味的方块游戏。

如果你原本使用 [OF] 高清修复 (OptiFine) 来优化 Minecraft，Sodium 通常可以提供进一步的改善，但你将缺失部分功能（如缩放、动态光源等），请点击此处查看替换功能列表。若想加载光影，你可以使用 Iris Shaders 。注意，此模组与高清修复、Fabric Rendering API（在0.6.0及以上版本已兼容，0.6.0以下版本可使用铟来解决）、Canvas 渲染器 和 VulkanMod 不兼容。

由于上述灰字所说的原因，请不要将此模组0.6.0及以上版本与铟一起使用。

此模组是作者们数千小时开发的成果，它的诞生要感谢像你这样的玩家。如果你想对他们的工作表示感谢，并在此过程中支持 Sodium 的开发，请考虑支持作者。

目录	Sodium 0.5.2	Sodium 0.4.1
	Sodium 大幅优化了游戏的渲染器，使其速度更快、效率更高，FPS 通常可提高 300% 或更多。	旧版本对比图

📥 安装指南

在安装 Sodium 之前，请务必阅读 Wiki 上的“驱动程序兼容性”部分。其中包含如何防止崩溃和其他性能问题的重要说明。

Sodium 是一个 Fabric 模组，这意味着它需要 Fabric Loader。如果你使用的是第三方启动器，它可能内置了自动安装模组加载器的功能。一旦安装了 Fabric Loader，你就可以像安装其他模组一样，将 Sodium 放入你的 mods 文件夹。

• 不确定你是否正确安装了模组？

  请检查 Minecraft 中的视频设置界面，其中应显示此模组全新改进的更改设置 UI（推荐使用 Reese的钠视频界面 改善配置界面）。

• 不确定如何配置模组？

  别担心，你可能不需要。默认情况下，Sodium 会启用系统支持的所有优化，尽可能为你带来最佳体验。一般来说，只有在遇到问题时，你才需要更改与性能和其他高级功能相关的视频设置。

• 需要更好的性能？

  根据设计，Sodium 只优化 Minecraft 的渲染代码。你还应安装作者的其他模组，如锂和磷来优化游戏的其他部分。这样做是为了让玩家可以挑选自己想要使用的模组，但作者通常建议你使用他们的全部模组。

🖥️ 驱动程序兼容性

Sodium 的许多问题都是由过时、不兼容或损坏的显卡驱动程序造成的。下面列出了已知驱动程序损坏的显卡，以及如何修复它们的兼容性问题。按照惯例，大多数问题只需升级显卡驱动程序即可解决。

英伟达图形处理器

由于最近的驱动程序更新，你在使用 NVIDIA GPU 时可能会遇到严重的性能和稳定性问题。你必须升级至 Sodium 0.5.0（及更高版本），或按照以下说明进行操作。

造成这一问题的原因是 NVIDIA 在检测到 Minecraft 时，强行启用了名为“线程优化 (Threaded Optimizations)”的软件。尽管名称如此，但这些优化只会在安装 Sodium 时导致严重的性能问题和崩溃。即使它们正常运行（这种情况很少见），也不会提高性能。

要解决这个问题，必须修改启动器和/或系统配置，防止 NVIDIA 驱动程序检测到 Minecraft 的存在。Windows 和 Linux 的检测逻辑不同，因此两种操作系统的操作步骤略有差异。

注意：在采取任何措施之前，你必须确保安装了最新的英伟达图形驱动程序（536.23 版本或更新）！

英特尔图形处理器

• 仅第四代（Intel HD 2500/4000）

  你必须安装 15.33.53.5161 或更新版本的驱动程序，因为 Windows 10 自动安装的驱动程序与 Sodium 不兼容，会导致游戏在启动时未响应或崩溃。你需要使用此处的说明来安装更新的驱动程序。

• 第十代及以上（Intel UHD Graphics, Intel Xe Graphics）

  在部分电脑上可能会遇到这样的问题：在放置或破坏方块时，区块会“闪烁”。安装 GPU 的最新驱动程序即可解决此问题。

AMD 图形处理器

• Terascale 2（仅限 Windows）

  旧版本的 Sodium 无法在这些显卡上正常运作，导致出现一个虚空的世界，无法渲染任何区块或方块。你必须升级到 Sodium 0.4.10 或更新版本才能解决此问题。

  有关详细信息，请参阅 GitHub Issue 。

• Vega 56/64（仅限 Linux）

  在使用最新版本的 Mesa/Linux 时，游戏将无法正确渲染，且在尝试安装 Sodium 运行 Minecraft 时，你可能会遇到硬盘锁定或整个电脑崩溃的情况。

  作者不知道有什么可靠的方法可以解决此问题。你可以尝试使用 Zink 图形驱动程序（OpenGL-on-Vulkan 实现）和最新版本的 Mesa，但你可能会发现性能会大打折扣。

  有关此问题的更多信息，请参阅 GitHub Issue 。

📈 基准测试

以下性能对比由我们的社区提供，它们展示了 Sodium 如何提高各种电脑的帧率，无论速度快慢。许多玩家表示平均帧数提高了 250%~500%。

• AMD Ryzen 5 5600H / NVIDIA RTX 3050 Ti（34 fps → 253 fps）[快 7.4 倍]

• AMD Ryzen 5 5600 / NVIDIA RTX 3070 Ti（62 fps → 516 fps）[快 8.3 倍]

• Intel Xeon E5-1620v3 / AMD RX 6400（52 fps → 216 fps）[快 4.1 倍]

• AMD Ryzen 3450U / AMD Vega 8 Graphics（49 fps → 118 fps）[快 2.4 倍]

• Intel Core i5-11400 / Intel UHD 730 Graphics（39 fps → 110 fps）[快 2.8 倍]

• Intel Core i3-4170 / NVIDIA GeForce GT 710（38 fps → 86 fps）[快 2.2 倍]

• Intel Celeron G5900 / Intel UHD Graphics 610（62 fps → 155 fps）[快 2.5 倍]

✅ 硬件兼容性

此模组仅支持具有与 OpenGL 4.6 兼容的最新驱动程序的显卡。大多数在过去 12 年中发布的显卡都是兼容的。其中包括以下硬件：

• INTEL HD Graphics 500 系列（Skylake）或更新

• NVIDIA GeForce 400 系列（Fermi）或更新

• AMD Radeon HD 7000 系列（GCN 1）或更新

在某些情况下，旧版显卡也可以使用（只要它们拥有支持 OpenGL 3.3 的最新驱动程序），但它们不受官方支持，且可能与未来版本的 Sodium 不兼容。

不支持使用 OpenGL 转译层（如 GL4ES、ANGLE 等）的安卓设备，它们很可能无法与 Sodium 兼容。这些转译层没有实现所需的功能，且存在无法解决的底层驱动程序错误。

如果遇到问题，请确保你的图形驱动程序是最新的。过时的驱动程序通常是导致大多数崩溃、渲染错误和性能问题的元凶。

⚙️ 技术细节

那么，Sodium 究竟是如何工作的呢？显然，作者不能只说游戏神奇地变快了，而不提供一些解释。下面的列表试图涵盖一些最重要的变化，这些变化是性能提升的原因，但并不完整或详尽地介绍了 Sodium 的所有功能。

• 作者将 Minecraft 的世界渲染代码全部替换为基于现代渲染技术的自有实现。在区块渲染方面，作者使用了几何体批处理和绘制传递合并技术，从而大大降低了渲染世界时的 CPU 开销。Sodium 不仅仅是一个优化模组……它更像是一个渲染引擎；

• 作者为世界几何图形使用了一种更为紧凑的格式，这使区块所使用的显存减少了约 40%。此外，作者还使用了第二次剔除，以消除背对镜头（但仍在镜头视角内）的几何图形，这样 GPU 就无需处理隐藏的几何图形。这些优化措施大大降低了显存带宽需求，而这正是游戏的最大瓶颈之一；

• 作者使用完全重写的系统来生成区块几何图形，包括生物群系着色、光照和阴影处理。这通常比原版代码要快得多，有助于加快区块加载速度，降低对 CPU 的消耗（前、后）；

• 作者使用自定义线程实现，确保区块更新能更好地利用多核 CPU，从而大大减少因放置/破坏方块而造成的延迟峰值（前、后）；

• 作者为顶点构建和转换编写了许多优化程序，有助于加快即时模式渲染的速度。这明显改善了复杂场景中的性能，如大量实体可见时；

• 作者对游戏管理内存和分配对象的方式进行了大量改进，减少了内存消耗和垃圾回收器活动导致的延迟峰值；

• 世界中不可见的动画纹理将不会更新，加快了大多数硬件（尤其是 AMD 显卡）的纹理更新速度。

很多人习惯于认为“性能优化=游戏画面更糟”，但实际上，Sodium 在大多数情况下都提高了 Minecraft 的图形保真度。

• 在多个方块面上平滑过渡方块和流体的生物群系颜色，大大提高了图形质量，并显著降低了计算密集度；

• 平滑光照现在可以在流体和其他特殊方块上正常生效。作者还修复了方块着色的一些图形问题，有助于让一切看起来更加平滑。

生物群系过渡改进	流体渲染改进	水下光照改进	方块阴影改进
Sodium 改进了生物群系过度，在每个区块中使用渐变，使效果看起来更平滑。	Sodium 实现了所有流体的平滑光照，修复了 Minecraft 中一个长期存在的问题。	Sodium 修复了水下光照流畅性方面的许多图形问题。	Sodium 大大改进了方块的阴影，修复了许多错误，同时使方块的阴影看起来更平滑、更一致。

🐛 如何报告问题

请使用页面顶部相关链接的GitHub 问题反馈报告漏洞、崩溃和其他问题。请确保包含你使用的模组的相关信息，并附上任何崩溃或日志文件。

❓ 常见问题

此模组有一个简短的维基百科，其中包含一些最常见的问题。你的问题很可能已经在这里找到了答案。

• 你们所有模组的最新版本在哪里？

  你可以在作者的网站上查看官方模组列表和最新下载地址。

• 你的所有模组都相互兼容吗？

  是的，作者甚至建议你一起使用。之所以将它们分成多个模组，是为了让玩家可以自由选择如何改进他们的游戏。

• 整合包策略是什么？

  本模组目前采用 PolyForm Shield License 1.0.0 许可证（原文）。在大多数情况下，这意味着你可以在你的整合包中自由发布这些模组，只要你注明出处即可。

• 你们的版本支持策略是什么？

  作者通常只发布最新版本的 Minecraft（作者的主线分支），因为移植到旧版本需要大量的时间和资源。作者不太可能为超过六个月的游戏版本或已被取代的次要版本提供任何支持。

• 如何检查模组是否已加载？

  查看安装了哪些模组的最简单、最常用的方法是使用游戏内模组菜单。不过，你也可以查看日志文件的开头（如下示例），了解 Fabric 加载了哪些模组。

[15:48:51] [main/INFO]: Loading for game Minecraft 1.17.1
[15:48:51] [main/INFO]: [FabricLoader] Loading 11 mods:
- fabric-api-base@0.3.0+a02b446313
- fabric-rendering-data-attachment-v1@0.1.5+a02b446313
- fabric-rendering-fluids-v1@0.1.13+a02b446313
- fabric-resource-loader-v0@0.4.7+b7ab612113
- fabricloader@0.11.6
- hydrogen@0.3
- java@16
- lithium@0.7.4
- minecraft@1.17.1
- sodium@0.3.0+build.5

• Modrinth 是什么？
  

  Modrinth 是一个用于托管 Minecraft Mod 的替代平台。它通常更易于使用，并为开发者提供了更好的工具。

  在可能的情况下，作者建议玩家使用 Modrinth 或 GitHub 检查最新版本。

• 你的模组的 Forge 版本在哪里？

  现已在1.21.x支持NeoForge（计划将其反向移植到1.20.1），对于尚未支持的Minecraft/加载器版本，你可以使用非官方 Forge 版：

• Beddium（1.21 Forge）

• 氙 (Xenon)（1.20.1 (Neo)Forge）

• Embeddium（(Neo)Forge/Fabric）

• 铷 (Rubidium)（停更，1.16.5 - 1.20.1 (Neo)Forge）

• 镁 (Magnesium / Sodium Reforged)（停更，1.16.5/1.18 Forge）
  

• 卤素 (Halogen)（停更，1.16.5 Forge；是三合一的移植）

• 氯 (Chlorine)（停更，1.16.5 Forge）

但作者的模组不以任何官方身份支持 Forge。原因多种多样，仅举几例：

• 作者是一群利用业余时间工作的志愿者，维护另一个版本的模组需要更多的时间和精力，这不是作者所能提供的。正如其他人所指出的，当人们要求与 Forge 兼容时，他们并不只是要求与他们所选择的模组加载器兼容，而是要求与他们全部的 200 多个模组兼容；

• Forge 作为一个平台，对支持那些试图修补游戏代码的模组毫无兴趣，相反，它坚持要成为一个 API，让其他模组可以在此基础上进行构建。鉴于作者模组的性质，这不幸导致了他们开发模组所依赖的许多工具在 Forge 上根本无法使用（或支持不力）；

• Forge 的开发者对作者个人（JellySquid）总是不屑一顾，并一有机会就对他充满敌意，而且丝毫不努力挽救与作者的关系，甚至不承认错误。这并没有让作者感到特别受欢迎，而且给作者的印象是，除了他自己之外，这几乎是一场为所有人而进行的艰苦战斗。

虽然许可证允许其他人使用作者的源代码并将其移植到 Forge，但作者通常并不支持尝试这样做的人。

这在过去曾被指出是他们的虚伪（因为如果作者不想要移植，为什么还要使用自由和开源的许可证）。

新的许可证禁止了竞争性的移植，详见此 Issue 的讨论。作者已澄清像 Angelica、Vintagium 之类的旧版移植不构成竞争性。

但事实上，作者只是希望那些移植他们模组的人能够以负责任的方式行事。

通常情况下，有人会尝试做最起码的工作来移植作者的模组，把“Forge”字样钉在作者为自己起的名字旁边，然后发布到网上，却不打算提供支持，甚至不打算合理地维护它。这无意中会导致作者的声誉受到损害，因为移植会腐烂，问题会不断积累，最终作者会面对大量用户就与他们无关的问题向他们寻求帮助。

如果你这样做的目的是为了向新用户介绍你喜欢玩的 Mod，而你却没有付出努力或承担相应的责任，那么你只会自掘坟墓，让潜在用户望而却步，再也不敢尝试该模组了。

因此，当我们谈及责任时，作者要求你：

• 让他们知道，哪怕只是在作者的收件箱里发一封短笺；

• 原创，除非获得作者的书面许可，否则不要盗用他们的名称或图标；

• 更新任何对作者官方论坛或资源的引用，以免用户在出现问题时被引向他们；

• 适当披露你提供的是作者模组的非官方移植，并注明他们的工作。

☕ 维护信息

原作者 Jellysquid3 曾于 2023/09/18 在 Github 主页上声明不再维护此模组，后于 2023/12/09 删除此信息。鉴于此，此模组应该会继续有增强或新功能。模组于 2024/04/07 更改许可证为 PolyForm Shield License。

🌐 关于本地化

• Sodium 0.3.0 及以上版本：支持自定义翻译，本地化文件可以在 Crowdin 或者 Modrinth 下载；

• Sodium 0.3.0 以下版本：B 站专栏 | 作者：law4x 和 GitHub | 作者：7777777_4547。

📱FCL/移动端设备 Java 版

• 请使用修改版本的钠（已停更）或支持钠的渲染器（例如LTW，MG等），请注意，任何移动端设备不受到支持，优先向所使用的渲染器开发者提交反馈。