Sodium 0.9.0-beta.3 版本适配 Minecraft 26.2-rc-1，更新至 Minecraft 26.2，并新增异步遮挡剔除功能。

这是首个实验性支持 Vulkan 图形 API 的版本。如需启用，请在视频设置中选择“图形 API”选项。

• 更新至 Minecraft 26.2
• 将全部渲染逻辑迁移至 Mojang 的 Blaze3D API
• 新增异步图剔除与帧无关任务调度（#2887）
• 优化部分视频选项的界面呈现与文字表述（#3700）

Sodium 0.9.0-beta.3（适用于 Minecraft 26.2-rc-1）更新至 Minecraft 26.2，并新增异步遮挡剔除功能。

这是首个实验性支持 Vulkan 的版本。如需启用，请在视频设置中选择“图形 API”选项。

• 更新至 Minecraft 26.2
• 将全部渲染逻辑迁移至 Mojang 的 Blaze3D API
• 新增异步图剔除与帧无关任务调度（#2887）
• 优化部分视频选项的界面呈现与文字表述（#3700）

Sodium 0.9.0-beta.2 版本适配 Minecraft 26.2-rc-1，更新至 Minecraft 26.2，并新增异步遮挡剔除功能。

这是首个实验性支持 Vulkan 的版本。如需启用，请在视频设置中选择“图形 API”选项。

• 更新至 Minecraft 26.2
• 将全部渲染逻辑迁移至 Mojang 的 Blaze3D API
• 新增异步图剔除与帧无关任务调度（#2887）
• 优化部分视频选项的界面呈现与文字表述（#3700）

Sodium 0.9.0-beta.1（适用于 Minecraft 26.2-rc-1）更新至 Minecraft 26.2，并新增异步遮挡剔除功能。

这是首个实验性支持 Vulkan 的版本。如需启用，请在视频设置中选择“图形 API”选项。

• 更新至 Minecraft 26.2
• 将全部渲染逻辑迁移至 Mojang 的 Blaze3D API
• 新增异步图剔除与帧无关任务调度（#2887）

概览

Sodium 0.8.12-alpha.4 是将现代版 Sodium 0.8 回溯适配至 Minecraft 1.21.1 的版本。本次实验已正式进入 Alpha 阶段。我们对该分支的长期支持力度，将取决于实际测试效果、运行稳定性以及其与生态系统的兼容整合程度。随着本版本被更广泛地使用、各类异常行为被陆续发现并收到社区反馈，其整体质量预期将持续提升。

• 显著提升了世界渲染性能（部分设备最高提升达 +115%）；
• 大幅优化了复杂模型透明物体的渲染效果，尤其在水下时表现更佳；
• 视频设置菜单中的用户体验获得大量改进；
• 降低了世界区块更新时的延迟与微卡顿现象；
• 实体渲染速度略有提升，尤其体现在透明生物与粒子效果上；
• 进一步增强了硬件及模组兼容性；
• ……以及诸多其他 Bug 修复与功能改进。

使用与测试本版本

本版本包含 Config API 等接口的回溯适配，以及一系列跨版本通用约定，旨在帮助模组更便捷地与 Sodium 协同工作。该发布系列的更新节奏不同于当前面向 Minecraft 26.1 和 1.21.11 的正式版本，Alpha/Beta 版本编号规则亦不一致。模组开发者可于 我们的 Maven 仓库 获取 Config API 等相关构件。

欢迎参与本版本的测试工作，协助协调模组兼容性问题，并在 我们的 Discord 服务器 中提交反馈。#testing-builds 频道内的对应帖子中提供了更详细的信息，请将您遇到的问题在此帖中报告。

截至本版本发布时已知的不兼容项：

• 钠：树叶剔除（sodiumleafculling）无法正常工作；
• C²M 引擎（C2ME）最新版可正常工作；
• 创世航空（Create Aeronautics）无法正常工作；
• 隐匿面纱（Veil）已有适配更新，勾魂眼（Sableye）已提供补丁但尚未发布正式更新；
• 鸢尾花（Iris）已在 Discord 提供可用的测试构建版；
• 更多剔除（More culling）最新版可正常工作；
• Voxy 无法正常工作；
• 方块实体优化（EBE）的动画效果无法正常工作。

Alpha 系列更新日志

• 修复 BufferBuilderMixin 在启用 requireOverwriteAnnotations 时与 Iris 的 MixinBufferBuilder_SeparateAo 冲突的问题（#3658）；
• 通过使构建脚本更贴近 1.21.11 所用版本，潜在修复了发布流程中的问题；
• 修复配置界面损坏导致无法正常显示的问题；
• 撤销“更新纹理光照坐标计算以匹配原版（#3311）”这一改动——该改动误被应用于 1.21.1 版本。

概览

Sodium 0.8.12-alpha.4 是将现代版 Sodium 0.8 向后移植至 Minecraft 1.21.1 的版本。该实验性分支现已正式进入 Alpha 阶段。我们对该分支的长期支持力度，将取决于实际测试结果、其运行稳定性以及与生态系统的整合程度。随着使用范围扩大、各类异常行为被发现并收到更多反馈，本版本的质量预计将持续提升。

• 显著提升世界渲染性能（部分电脑最高提升达 +115%）；
• 大幅优化复杂模型透明物体的渲染效果，尤其在水下时表现更佳；
• 对视频设置菜单中的用户体验进行了大量改进；
• 降低世界区块更新时的延迟与微卡顿现象；
• 略微加快实体渲染速度，尤其对透明生物与粒子效果更为明显；
• 提升硬件兼容性与模组兼容性；
• ……以及众多其他 Bug 修复与功能优化。

使用与测试本版本

本版本包含 Config API 等向后移植组件及通用规范，旨在帮助模组更便捷地跨多个 Minecraft 版本与 Sodium 进行交互。本发布系列的更新节奏不同于当前面向 Minecraft 26.1 和 1.21.11 的正式版本，Alpha/Beta 编号规则亦不一致。模组开发者可在 我们的 Maven 仓库 获取相关构件（例如 Config API）。

欢迎参与本版本的测试工作，协助协调模组兼容性问题，并在 我们的 Discord 服务器 中提供反馈。#testing-builds 频道内的置顶帖中提供了更多信息，请在该帖中报告您遇到的任何问题。

本版本已知不兼容项：

• sodiumleafculling 不可用；
• C2ME 最新版可用；
• Create Aeronautics 不可用；
• Veil 已发布适配更新，Sable 提供了补丁但尚未发布正式更新；
• Iris 在 Discord 中提供了可用的测试构建版；
• More culling 最新版可用；
• Voxy 不可用；
• EBE 动画不可用。

Alpha 系列更新日志

• 修复 BufferBuilderMixin 与 Iris 的 MixinBufferBuilder_SeparateAo 在启用 requireOverwriteAnnotations 时的冲突问题（#3658）；
• 通过使构建脚本更贴近 1.21.11 所用版本，潜在解决发布流程中的问题；
• 修复损坏的配置界面，使其正常显示；
• 撤销“更新纹理光照坐标计算以匹配原版（#3311）”这一改动，因其被误应用于 1.21.1 版本。

Sodium 0.8.12 修复了若干漏洞，新增了一些功能，并优化了内存占用。此外，还对光照系统进行了多项改进。

本次更新引入了帧率（FPS）百分位数显示功能，能更准确地反映你真正关心的帧率表现：

• 中位数（标记为 p50）表示排除卡顿帧后的典型帧率；
• 第98百分位数与第99.5百分位数则分别体现卡顿帧与严重卡顿帧的帧率；
• 而 Minecraft 默认显示的平均帧率，容易被少数卡顿帧显著拉低，即使其余时间帧率相当高，导致该平均值无法真实反映你绝大多数时间所观察到的实际帧率。

新增一项“按最近点排序实体面片”的可选功能，可正确渲染具有特定类型几何结构（否则会因排序错误而显示异常）的相似半透明实体。该选项默认关闭，因其会对性能造成一定影响。

本次更新还包含多项崩溃修复，以及若干针对性优化，避免在特定场景下长期持有大量内存分配：

• 避免在进行大量面片分割时创建的大内存分配被持续持有；
• 修复因面片分割后重用 BSP 节点所导致的缓冲区溢出问题；
• 修复 BaseBiForest 中错误的适用性检测逻辑，该问题会导致渲染距离大于32时出现错误渲染；
• 实现可选的 FPS 百分位数显示功能（#3633，#3642）；
• 修复平面流体光照过暗的问题（#3620）；
• 显著降低直接排序回退路径下的内存消耗；
• 修复“增强模式”与常规模式下流体塑形的相关问题；
• 通过在粒子渲染中执行统一变量绑定，修复 #3612 问题（#3637）；
• 修复 #3603 问题（光源周围环境光遮蔽与天空光等级计算错误）（#3631）；
• 新增“按最近点排序实体面片”选项（#3635）；
• 修复 Minecraft 的 CompactVectorArray#getZ 方法返回错误值的问题，该问题曾导致部分模组渲染异常（#3643）；
• 调整全亮方块仅发射方块光、不发射天空光（#3640）；
• 重构 ImprovedItemModelBuilder，以提升与模组的兼容性（#3648）；
• 修复损坏的配置界面，使其能正常显示；
• 修复雾效闪烁问题（#3666）。

Sodium 0.8.12 修复了若干漏洞，新增了一些功能，并优化了内存占用。此外，还对光照系统进行了多项改进。

本次更新引入了一种全新的 FPS 百分位数显示方式，能更准确地反映你真正关心的帧率信息：

• 中位数（标记为 p50）表示排除掉卡顿帧后的典型帧率；
• 第 98 和第 99.5 百分位数则分别表示卡顿帧与严重卡顿帧的帧率；
• 而 Minecraft 默认显示的平均帧率，容易被少数卡顿帧显著拉低，即使其余时间帧率相当高，导致该平均值并不能真实反映你大部分时间所看到的实际帧率。

新增一项可选设置：按实体四边形（quad）距摄像机最近点进行排序，可正确渲染具有特定几何结构（否则会因排序错误而显示异常）的相似半透明实体。该选项默认关闭，因其会对性能造成一定影响。

此外，本次更新还包含多项崩溃修复，以及若干针对性优化，以避免在特定场景下长期持有大块内存分配：

• 避免在大量四边形分割操作发生时创建并持续持有大内存块；
• 修复因重用 BSP 节点而导致四边形分割时发生的缓冲区溢出问题；
• 修复 BaseBiForest 中错误的适用性检测逻辑，该问题会导致渲染距离大于 32 时出现错误的光影效果；
• 实现可选的百分位数 FPS 显示功能（#3633，#3642）；
• 修复平面流体光照过暗的问题（#3620）；
• 显著降低直接排序回退路径下的内存消耗；
• 修复“增强模式”与常规模式下流体形状渲染的问题；
• 通过在粒子渲染中执行统一变量（uniform）绑定，修复 #3612 问题（#3637）；
• 修复 #3603 问题（光源周围环境光遮蔽与天空光等级计算错误）（#3631）；
• 新增“按最近点排序实体四边形”选项（#3635）；
• 修复 Minecraft 的 CompactVectorArray#getZ 方法返回错误值的问题，该问题曾导致部分模组渲染异常（#3643）；
• 修改全亮方块（fullbright blocks）仅发射方块光，不再发射天空光（#3640）；
• 重构 ImprovedItemModelBuilder，提升与其他模组的兼容性（#3648）；
• 修复损坏的配置界面，使其能正常显示；
• 修复雾效闪烁问题（#3666）。

Sodium 0.8.12 修复了若干漏洞，新增了一些功能，并优化了内存占用。此外，该版本还对光照系统进行了多项改进。

本次更新引入了全新的 FPS 百分位数显示功能，能更准确地反映你真正关心的帧率信息：

• 中位数（标记为 p50）表示排除卡顿帧后的典型帧率；
• 第 98 和第 99.5 百分位数则分别反映卡顿帧与严重卡顿帧的帧率；
• 而 Minecraft 默认显示的平均帧率，可能仅因少数几帧严重卡顿就被大幅拉低，即使其余时间帧率非常高，导致该平均值无法真实体现你绝大多数时间所看到的实际帧率。

新增的“按最近点排序实体面片”选项，可正确渲染具有特定类型几何结构（否则会因排序错误而显示异常）的相似半透明实体。由于该功能会对性能造成一定影响，因此默认处于禁用状态。

此外，本版本还包含多项崩溃修复，以及针对特定场景下避免长期持有大块内存分配的优化调整。

• 修复通过 FluidModel 直接获取流体贴图时的动画异常（#3630）
• 避免在大量面片分割操作发生时持续持有由此产生的大块内存分配
• 修复因面片分割后重用 BSP 节点而导致的缓冲区溢出问题
• 修复 BaseBiForest 中错误的适用性检测逻辑，该问题会导致渲染距离大于 32 时出现错误渲染
• 修复启动后检查未实际执行的问题，并修复重复模块提示对话框（#3624）
• 实现可选的百分位数 FPS 显示功能（#3633、#3642）
• 修复平面流体光照过暗的问题（#3620）
• 显著降低直接排序回退路径下的内存消耗
• 修复“增强模式”与常规模式下流体建模的相关问题
• 通过在粒子渲染中执行统一变量绑定，修复 #3612 问题（#3637）
• 修复 #3603（光源周围环境光遮蔽与天空光等级计算错误）（#3631）
• 新增“按最近点排序实体面片”选项（#3635）
• 修复 Minecraft 的 CompactVectorArray#getZ 方法返回错误值的问题，该问题曾导致部分模组渲染异常（#3643）
• 调整全亮方块仅发射方块光、不发射天空光（#3640）
• 修复使用特定资源包时，云朵在树叶后方不可见的问题
• 重构 ImprovedItemModelBuilder 以提升模组兼容性，并修复 Beta 3 版本引发的崩溃（#3648）
• 修复损坏的配置界面，使其正常显示
• 修复雾效闪烁问题（#3666）

Sodium 0.8.12 修复了若干漏洞，新增了一些功能，并优化了内存占用。此外，该版本还对光照系统进行了多项改进。

本次更新引入了全新的 FPS 百分位数显示功能，能更准确地反映你真正关心的帧率信息：

• 中位数（标记为 p50）表示排除掉卡顿帧后的典型帧率；
• 第 98 和第 99.5 百分位数则分别表示卡顿帧与严重卡顿帧的帧率；
• 而 Minecraft 默认显示的平均帧率，容易被少数卡顿帧拉低，即使其余时间帧率非常高，也会导致平均值无法真实反映你绝大多数时间所看到的实际帧率。

新增一项可选设置：按实体四边形（quad）距摄像机最近点进行排序，可正确渲染具有特定类型几何结构（否则会因排序错误而显示异常）的相似半透明实体。该选项默认关闭，因其会对性能造成一定影响。

此外，本版本还包含多项崩溃修复，以及若干针对特定场景下避免大块内存长期驻留的优化调整。

• 修复通过 FluidModel 直接获取流体贴图时的动画异常（#3630）
• 避免在大量四边形拆分操作发生时创建并长期持有大块内存
• 修复因四边形拆分后重用 BSP 节点所导致的缓冲区溢出问题
• 修复 BaseBiForest 中错误的适用性检测逻辑，该问题会导致渲染距离大于 32 时出现错误渲染
• 修复启动后检查未实际执行的问题，并修正重复模块对话框（#3624）
• 实现可选的百分位数 FPS 显示功能（#3633、#3642）
• 修复平面流体光照过暗的问题（#3620）
• 大幅降低直接排序回退路径下的内存消耗
• 修复“增强模式”与常规模式下流体形状渲染的问题
• 通过在粒子渲染中执行统一变量（uniform）绑定，修复 #3612（#3637）
• 修复 #3603（光源周围环境光遮蔽与天空光等级计算错误）（#3631）
• 新增按最近点排序实体四边形（Entity Quads）的选项（#3635）
• 修复 Minecraft 的 CompactVectorArray#getZ 方法返回错误值的问题，该问题曾导致部分模组渲染异常（#3643）
• 调整全亮方块仅发射方块光，不再发射天空光（#3640）
• 修复使用特定资源包时，云层在树叶后方不可见的问题
• 重构 ImprovedItemModelBuilder，提升模组兼容性，并修复 Beta 3 版本中引发的崩溃（#3648）
• 修复损坏的配置界面，使其能正常显示
• 修复雾效闪烁问题（#3666）

Sodium 0.8.12-beta.4 修复了若干漏洞，新增了一些功能，并优化了内存占用。此外，该版本还对光照系统进行了多项改进。

本次发布新增了帧率（FPS）百分位数显示功能，能更准确地反映你真正关心的帧率表现：

• 中位数（标记为 p50）表示排除卡顿帧后的典型帧率；
• 第98百分位数和第99.5百分位数分别表示卡顿帧与严重卡顿帧的帧率；
• 平均值（即 Minecraft 默认显示的 FPS）易受少数卡顿帧拖累，即使其余时间帧率很高，也会导致平均 FPS 无法真实反映你绝大多数时间所看到的实际帧率。

新增一项可选设置：按实体面片（quad）上距离摄像机最近的点进行排序，从而正确渲染具有特定几何结构、否则会因排序错误而显示异常的相似半透明实体。该选项默认关闭，因其会带来一定性能开销。

漏洞修复包括多个崩溃问题修复，以及针对特定场景中避免长期持有大块内存分配的改动：

• 修复通过 FluidModel 直接获取流体贴图时动画异常的问题（#3630）
• 避免在大量面片分割操作发生时创建并长期持有大块内存分配
• 修复因面片分割导致 BSP 节点复用引发的缓冲区溢出问题
• 修复 BaseBiForest 中错误的适用性检测逻辑，该问题会导致渲染距离大于 32 时出现错误渲染
• 修复启动后检查未实际执行的问题，并修复重复模块对话框（#3624）
• 实现可选的 FPS 百分位数显示功能（#3633、#3642）
• 修复平面流体光照过暗的问题（#3620）
• 显著降低直接排序回退路径下的内存消耗
• 修复“增强模式”与常规模式下流体形状生成的相关问题
• 通过在粒子渲染中执行统一变量（uniform）绑定，修复 #3612 问题（#3637）
• 修复 #3603 问题（光源周围环境光遮蔽（AO）与天空光等级计算错误）（#3631）
• 新增“按最近点排序实体面片”的选项（#3635）
• 修复 Minecraft 的 CompactVectorArray#getZ 方法返回错误 Z 值的问题，该问题曾导致部分模组渲染异常（#3643）
• 调整全亮方块（fullbright blocks）仅发射方块光，不再发射天空光（#3640）
• 修复使用特定资源包时云朵在树叶后方不可见的问题
• 重构 ImprovedItemModelBuilder，提升模组兼容性，并修复 beta 3 版本中的崩溃问题（#3648）

欢迎参与本版本的测试，并在我们的 Discord 服务器中提供反馈。

Sodium 0.8.12-beta.4 修复了若干漏洞，新增了一些功能，并优化了内存使用。此外，还对光照系统进行了多项改进。

本次发布新增了 FPS 百分位数显示功能，能更准确地反映你真正关心的帧率信息：

• 中位数（标记为 p50）表示排除掉卡顿帧后的典型帧率；
• 第 98 和第 99.5 百分位数则分别反映卡顿帧与严重卡顿帧的帧率；
• 而 Minecraft 默认显示的平均帧率，即使整体帧率很高，也可能因少数卡顿帧被显著拉低，导致其无法真实代表你大部分时间所观察到的实际帧率。

新增的“按实体四边形最近点排序”选项，可正确渲染具有特定几何结构、否则会因排序错误而显示异常的同类半透明实体。该选项默认关闭，因其会对性能造成一定影响。

漏洞修复包括多个崩溃问题修复，以及若干针对特定场景下避免大内存占用的改动：

• 修复通过 FluidModel 直接获取流体贴图时的动画异常（#3630）；
• 避免在大量四边形拆分时产生的大内存分配被长期持有；
• 修复因四边形拆分后重用 BSP 节点导致的缓冲区溢出；
• 修复 BaseBiForest 中错误的适用性检测逻辑，该问题会导致渲染距离大于 32 时出现错误渲染；
• 修复启动后检查未实际执行的问题，并修复重复模块对话框（#3624）；
• 实现可选的百分位数 FPS 显示功能（#3633、#3642）；
• 修复平面流体光照过暗的问题（#3620）；
• 显著降低直接排序回退路径下的内存消耗；
• 修复“增强模式”与常规模式下流体形状渲染的问题；
• 通过在粒子渲染中执行统一变量绑定，修复 #3612（#3637）；
• 修复 #3603（光源周围环境光遮蔽与天空光等级计算错误）（#3631）；
• 新增按最近点排序实体四边形的选项（#3635）；
• 修复 Minecraft 的 CompactVectorArray#getZ 返回错误值的问题，该问题曾导致部分模组渲染异常（#3643）；
• 修改全亮方块仅发射方块光、不发射天空光（#3640）；
• 修复特定资源包下云朵在树叶后不可见的问题；
• 重构 ImprovedItemModelBuilder，提升模组兼容性，并修复 beta 3 版本中的崩溃问题（#3648）。

欢迎参与本次版本的测试，并在我们的 Discord 服务器中提供反馈。

Sodium 0.8.12-beta.3 修复了若干漏洞，新增了一些功能，并优化了内存占用。此外，该版本还对光照系统进行了多项改进。

本次发布新增了 FPS 百分位数显示功能，能更准确地反映你真正关心的帧率表现：

• 中位数（标记为 p50）表示排除掉卡顿帧后的典型帧率；
• 第 98 和第 99.5 百分位数则分别表示卡顿帧与严重卡顿帧的帧率；
• 而 Minecraft 默认显示的平均帧率，即便整体帧率很高，也可能因少数卡顿帧被显著拉低，导致其无法真实反映你绝大多数时间所观察到的实际帧率。

新增的“按最近点排序实体面片”选项，可正确渲染具有特定类型几何结构（否则会错误排序）的相似半透明实体。该选项默认关闭，因其会对性能造成一定影响。

漏洞修复方面，包含多个崩溃问题修复，以及若干针对性调整，以避免在特定场景下长期持有大块内存分配：

• 避免在大量面片分割发生时创建并持续持有大块内存；
• 修复因面片分割导致 BSP 节点复用而引发的缓冲区溢出问题；
• 修复 BaseBiForest 中错误的适用性检测逻辑，该问题会导致渲染距离大于 32 时出现错误渲染；
• 实现可选的百分位数 FPS 显示功能（#3633，#3642）；
• 修复平面流体光照过暗的问题（#3620）；
• 大幅降低直接排序回退路径下的内存消耗；
• 修复“增强模式”与常规模式下流体形状生成的相关问题；
• 通过在粒子渲染中执行统一变量绑定，修复 #3612（#3637）；
• 修复 #3603（光源周围环境光遮蔽与天空光等级计算错误）（#3631）；
• 新增“按最近点排序实体面片”选项（#3635）；
• 修复 Minecraft 的 CompactVectorArray#getZ 方法返回错误 Z 值的问题，该问题曾导致部分模组渲染异常（#3643）；
• 调整全亮方块仅发射方块光、不发射天空光（#3640）；
• 重构 ImprovedItemModelBuilder，以提升与模组的兼容性（#3648）。

欢迎参与本版本的测试，并在我们的 Discord 服务器中提供反馈！

Sodium 0.8.12-beta.3 修复了若干漏洞，新增了一些功能，并优化了内存占用。此外，该版本还对光照系统进行了多项改进。

本次发布新增了帧率（FPS）百分位数显示功能，能更准确地反映你真正关心的帧率表现：

• 中位数（标记为 p50）表示排除卡顿帧后的典型帧率；
• 第98百分位数与第99.5百分位数则分别表示卡顿帧与严重卡顿帧的帧率；
• 默认情况下 Minecraft 显示的平均帧率，可能因极少数卡顿帧而被显著拉低，即便其余时间帧率相当高，导致其无法真实反映你大多数时间所看到的实际帧率表现。

新增的“按最近点排序实体面片”选项，可正确渲染具有特定类型几何结构（否则会因排序错误而显示异常）的相似半透明实体。出于性能考量，此选项默认处于禁用状态。

漏洞修复内容包括多个崩溃问题修复，以及若干针对性优化，以避免在特定场景下长期持有大块内存分配：

• 避免在大量面片分割发生时创建并持续持有大块内存分配；
• 修复因重用 BSP 节点而导致面片分割时发生的缓冲区溢出问题；
• 修复 BaseBiForest 中错误的适用性检测逻辑，该问题会导致渲染距离大于 32 时出现错误的渲染效果；
• 实现可选的 FPS 百分位数显示功能（#3633，#3642）；
• 修复平面流体光照过暗的问题（#3620）；
• 大幅降低直接排序回退路径下的内存消耗；
• 修复“增强模式”与常规模式下流体造型的相关问题；
• 通过在粒子渲染中执行统一变量绑定，修复 #3612（#3637）；
• 修复 #3603（光源周围环境光遮蔽与天空光等级计算错误）（#3631）；
• 新增“按最近点排序实体面片”选项（#3635）；
• 修复 Minecraft 的 CompactVectorArray#getZ 方法返回错误值的问题，该问题曾导致部分模组渲染异常（#3643）；
• 调整全亮方块仅发射方块光、不发射天空光（#3640）；
• 重构 ImprovedItemModelBuilder，以提升与模组的兼容性（#3648）。

欢迎参与本版本的测试，并在我们的 Discord 服务器中提供反馈。

概览

Sodium 0.8.12-alpha.3 是将现代版 Sodium 0.8 向后移植至 Minecraft 1.21.1 的版本。本实验性分支现已正式进入 Alpha 阶段。我们对该分支的长期支持力度，将取决于实际测试结果、其运行表现以及与生态系统的整合程度。随着使用范围扩大、异常行为被发现及用户反馈持续涌入，本版本的质量预计将进一步提升。

• 显著提升了世界渲染性能（部分设备最高提升达 +115%）；
• 大幅优化了具有复杂模型的透明物体的渲染效果，尤其在水下场景中表现更佳；
• 对视频设置菜单中的用户体验进行了大量改进；
• 降低了世界区块更新时的延迟与微卡顿现象；
• 实体渲染速度略有提升，尤其是透明生物与粒子效果；
• 增强了对各类硬件及模组的兼容性；
• ……以及众多 Bug 修复与功能优化……

使用与测试本版本

本版本包含 Config API 等向后移植功能及相关规范，旨在帮助模组开发者更便捷地跨多个 Minecraft 版本与 Sodium 进行交互。本发布系列的更新节奏不同于当前面向 Minecraft 26.1 与 1.21.11 的正式版本，Alpha/Beta 版本编号规则亦不相同。模组开发者可在 我们的 Maven 仓库 获取包括 Config API 在内的相关构建产物。

欢迎参与本版本的测试工作，协助协调模组兼容性问题，并在 我们的 Discord 服务器 中提供反馈。

发布时已知的不兼容模组：

• Iris
• Voxy
• More culling、sodiumleafculling
• Create Aeronautics、Sable

Alpha 系列更新日志

• 修复 BufferBuilderMixin 在启用 requireOverwriteAnnotations 时与 Iris 的 MixinBufferBuilder_SeparateAo 冲突的问题（#3658）；
• 通过使构建脚本更贴近 1.21.11 所用版本，潜在修复发布流程中的若干问题。

概览

Sodium 0.8.12-alpha.2 是将现代版 Sodium 0.8 回溯适配至 Minecraft 1.21.1 的版本。该实验性分支现已正式进入 Alpha 阶段。我们对该分支的长期支持力度，将取决于实际测试结果、运行稳定性以及其与整个生态系统的兼容与集成程度。随着使用范围扩大、各类异常行为被发现并收到用户反馈，本版本的质量预计将持续提升。

• 显著提升世界渲染性能（部分设备最高可达 +115%）；
• 大幅优化复杂模型透明物体的渲染效果，尤其在水下场景中表现更佳；
• 视频设置菜单中的用户体验获得大量改进；
• 降低世界区块更新时的输入延迟与微卡顿现象；
• 实体渲染速度略有提升，尤其是透明生物与粒子效果；
• 进一步增强对各类硬件及模组的兼容性；
• ……以及众多其他 Bug 修复与功能优化。

使用与测试本版本

本版本包含 Config API 等功能的回溯适配，以及一系列通用约定，旨在帮助模组开发者更便捷地实现跨多个 Minecraft 版本与 Sodium 的交互。本发布系列的更新节奏不同于当前面向 Minecraft 26.1 和 1.21.11 的正式版本，Alpha/Beta 编号规则亦不相同。模组开发者可前往 我们的 Maven 仓库 获取相关构件（如 Config API）。

欢迎参与本版本的测试工作，协同验证模组兼容性，并在 我们的 Discord 服务器 中提供反馈。

发布时已知的不兼容模组：

• Iris
• Voxy
• More culling、sodiumleafculling
• Create Aeronautics、Sable

Alpha 系列更新日志

• 修复 BufferBuilderMixin 在启用 requireOverwriteAnnotations 时与 Iris 的 MixinBufferBuilder_SeparateAo 冲突的问题（#3658）；
• 通过使构建脚本更贴近 1.21.11 版本所用脚本，潜在修复发布流程中的问题。

概览

Sodium 0.8.12-alpha.2 是将现代版 Sodium 0.8 向后移植至 Minecraft 1.21.1 的版本。本次实验已正式进入 Alpha 阶段。我们对该分支的长期支持力度，将取决于实际测试结果、其运行稳定性以及与生态系统的兼容整合程度。随着本版本被更广泛地使用、各类异常行为被逐步发现、用户反馈持续涌入，其整体质量预期将持续提升。

• 显著提升了世界渲染性能（部分设备最高提升达 +115%）；
• 大幅优化了复杂模型透明物体的渲染效果，尤其在水下环境中的表现；
• 对视频设置菜单中的用户体验进行了大量改进；
• 降低了世界区块更新时的延迟与微卡顿现象；
• 略微加快了实体渲染速度，尤其是透明生物与粒子效果；
• 进一步增强了硬件及模组兼容性；
• ……以及众多其他 Bug 修复与功能优化……

使用与测试本版本

本版本包含 Config API 及其他约定的向后移植实现，旨在帮助模组更便捷地跨多个 Minecraft 版本与 Sodium 交互。该发布系列的更新节奏不同于当前面向 Minecraft 26.1 和 1.21.11 的正式版本，Alpha/Beta 编号规则亦不一致。模组开发者可在 我们的 Maven 仓库 中获取包括 Config API 在内的相关构建产物。

欢迎参与本版本的测试工作，协助协调模组兼容性问题，并在 我们的 Discord 服务器 中提交反馈。

发布时已知的不兼容模组：

• Iris
• Voxy
• More culling、sodiumleafculling
• Create Aeronautics、Sable

Alpha 系列更新日志

• 修复 BufferBuilderMixin 在启用 requireOverwriteAnnotations 时与 Iris 的 MixinBufferBuilder_SeparateAo 冲突的问题（#3658）；
• 通过使构建脚本更贴近 1.21.11 版本所用脚本，潜在修复发布流程中的问题。

Sodium 0.8.12-beta.3 修复了若干漏洞，新增了一些功能，并优化了内存占用。此外，该版本还对光照系统进行了多项改进。

本次发布新增了 FPS 百分位数显示功能，能更准确地反映你真正关心的帧率信息：

• 中位数（标记为 p50）表示排除卡顿帧后的典型帧率；
• 第 98 百分位数与第 99.5 百分位数则分别表示较慢与极慢帧的帧率；
• 而 Minecraft 默认显示的平均帧率，可能仅因少数卡顿帧而被显著拉低，即便其余时间帧率相当高。因此，平均帧率往往并不能真实代表你绝大多数时间所观察到的实际帧率。

新增的“按最近点排序实体面片”选项，可正确渲染具有特定类型几何结构（否则会因排序错误导致异常）的相似半透明实体。该选项默认关闭，因其会带来一定性能开销。

漏洞修复方面，包括多个崩溃问题的修复，以及若干针对特定场景下避免长期持有大块内存分配的改动：

• 修复通过 FluidModel 直接获取流体贴图时的动画异常（#3630）；
• 避免在大量面片拆分操作发生时持续持有由此产生的大块内存分配；
• 修复因面片拆分后重用 BSP 节点所导致的缓冲区溢出问题；
• 修复 BaseBiForest 中错误的适用性检测逻辑，该问题会导致渲染距离大于 32 时出现错误渲染；
• 修复启动后检查未能实际执行的问题，并修正重复弹出模块对话框的问题（#3624）；
• 实现可选的百分位数 FPS 显示功能（#3633、#3642）；
• 修复平面流体光照过暗的问题（#3620）；
• 大幅降低直接排序回退路径下的内存消耗；
• 修复“增强模式”与常规模式下流体形状渲染的相关问题；
• 通过在粒子渲染中执行统一变量绑定，修复 #3612 问题（#3637）；
• 修复 #3603（光源周围环境光遮蔽与天空光等级计算错误）（#3631）；
• 新增“按最近点排序实体面片”选项（#3635）；
• 修复 Minecraft 的 CompactVectorArray#getZ 方法返回错误值的问题，该问题曾导致部分模组渲染异常（#3643）；
• 将全亮方块改为仅发射方块光，不发射天空光（#3640）；
• 修复使用特定资源包时云朵在树叶后不可见的问题；
• 重构 ImprovedItemModelBuilder，以提升与模组的兼容性（#3648）。

欢迎参与本版本的测试，并在我们的 Discord 服务器中提供反馈。

Sodium 0.8.12-beta.3 修复了若干漏洞，新增了一些功能，并优化了内存占用。此外，还对光照系统进行了多项改进。

本次发布新增了 FPS 百分位数显示功能，能更准确地反映你真正关心的帧率信息：

• 中位数（标记为 p50）表示排除掉卡顿帧后的典型帧率；
• 第 98 和第 99.5 百分位数则分别表示卡顿帧与严重卡顿帧的帧率；
• 默认由 Minecraft 显示的平均帧率，可能仅因少数卡顿帧而被显著拉低，即便其余时间帧率其实很高——这导致平均帧率往往无法真实反映你大多数时间所看到的实际帧率。

新增的“按最近点排序实体面片”选项，可正确渲染具有特定类型几何结构（否则会因排序错误而显示异常）的相似半透明实体。该选项默认禁用，因其会带来一定的性能开销。

漏洞修复包括多个崩溃问题修复，以及针对特定场景中避免长期持有大块内存分配的改动：

• 修复通过 FluidModel 直接获取流体贴图时的动画异常（#3630）；
• 避免在大量面片拆分操作发生时创建并长期持有大块内存；
• 修复因面片拆分后重用 BSP 节点而导致的缓冲区溢出；
• 修复 BaseBiForest 中错误的适用性检测逻辑，该问题会导致渲染距离大于 32 时出现错误渲染；
• 修复启动后检查未实际执行的问题，并修复模块对话框重复弹出（#3624）；
• 实现可选的百分位数 FPS 显示功能（#3633、#3642）；
• 修复平面流体光照过暗的问题（#3620）；
• 显著降低直接排序回退路径下的内存消耗；
• 修复“增强模式”与常规模式下流体形状渲染的问题；
• 通过在粒子渲染中执行统一变量绑定，修复 #3612（#3637）；
• 修复 #3603（光源周围环境光遮蔽与天空光照等级计算错误）（#3631）；
• 新增“按最近点排序实体面片”选项（#3635）；
• 修复 Minecraft 的 CompactVectorArray#getZ 返回错误值的问题，该问题曾导致部分模组渲染异常（#3643）；
• 修改全亮方块仅发射方块光、不发射天空光（#3640）；
• 修复使用特定资源包时，云朵在树叶后方不可见的问题；
• 重构 ImprovedItemModelBuilder 以提升与模组的兼容性（#3648）。

欢迎参与本次版本的测试，并在我们的 Discord 服务器中提供反馈。

Sodium 0.8.12-alpha.1 是将现代版 Sodium 0.8.12 向后移植至 Minecraft 1.21.1 的版本。本次实验已正式进入 Alpha 阶段。我们对该分支的长期支持力度，将取决于实际测试结果、其运行稳定性以及与生态系统的兼容与集成程度。随着本版本被更多用户使用、各类异常行为被逐步发现、以及社区反馈持续涌入，其整体质量有望进一步提升。

• 显著提升了部分计算机上世界渲染性能（最高可达 +115%）；
• 大幅优化了复杂模型透明物体的渲染效果，尤其在水下场景中表现更佳；
• 视频设置菜单中的用户体验获得大量改进；
• 降低了世界区块更新时的输入延迟与微卡顿现象；
• 实体渲染速度略有提升，对透明生物及粒子效果尤为明显；
• 进一步增强了硬件兼容性与模组兼容性；
• ……以及众多其他 Bug 修复与功能优化。

本版本还包含 Config API 及其他约定的向后移植，旨在帮助模组开发者更便捷地实现跨多个 Minecraft 版本与 Sodium 的交互。需注意：该发布系列的更新节奏不同于当前面向 Minecraft 26.1 和 1.21.11 的正式版本，且其 Alpha/Beta 版本编号规则亦不相同。

欢迎参与本版本的测试工作，协助协调模组兼容性问题，并通过我们的 Discord 服务器提供宝贵反馈。