AddEmAll (AddEmAll)

### Overview
Sodium 0.8.12-alpha.2 is a backport of modern Sodium 0.8 to Minecraft 1.21.1. This experiment has graduated to alpha status. The degree to which we commit to supporting this branch will be determined by testing and by how well it works and integrates with the ecosystem. The quality of this version is expected to further improve it gets used, we discover quirks, and receive feedback.

- Significantly improved the performance of rendering the world (up to +115%) on some computers.
- Greatly improved the rendering of transparent objects with complex models, especially when submerged in water.
- Lots and lots of improvements to the user experience in the Video Settings menu.
- Reduced latency and micro-stutter when updating chunks in the world.
- Slightly faster entity rendering, especially for transparent mobs and particles.
- Improvements for hardware and mod compatibility.
- ...And many more bug fixes and improvements...

### Using and Testing This Release
It includes the backport of our Config API and other conventions that will hopefully make it easier for mods to interact with Sodium across multiple versions. This release series doesn't get released at the same cadence as our current releases for Minecraft 26.1 and 1.21.11, and doesn't follow the same alpha/beta numbering. Mod developers can find our artifacts, such as the Config API, on [our Maven repository](https://maven.caffeinemc.net/).

Please participate in testing this release, coordinating on mod compatibility, and giving feedback on [our discord server](https://caffeinemc.net/discord).

Known incompatibilities at the time of release:
- Iris
- Voxy
- More culling, sodiumleafculling
- Create Aeronautics, Sable

### Alpha Series Changelog
- Fix BufferBuilderMixin conflicting with Iris' MixinBufferBuilder_SeparateAo when requireOverwriteAnnotations is enabled ([#3658](https://github.com/CaffeineMC/sodium/pull/3658))
- Potentially fix issues with publishing by making the buildscript more similar to that used in 1.21.11

### Overview
Sodium 0.8.12-alpha.2 is a backport of modern Sodium 0.8 to Minecraft 1.21.1. This experiment has graduated to alpha status. The degree to which we commit to supporting this branch will be determined by testing and by how well it works and integrates with the ecosystem. The quality of this version is expected to further improve it gets used, we discover quirks, and receive feedback.

- Significantly improved the performance of rendering the world (up to +115%) on some computers.
- Greatly improved the rendering of transparent objects with complex models, especially when submerged in water.
- Lots and lots of improvements to the user experience in the Video Settings menu.
- Reduced latency and micro-stutter when updating chunks in the world.
- Slightly faster entity rendering, especially for transparent mobs and particles.
- Improvements for hardware and mod compatibility.
- ...And many more bug fixes and improvements...

### Using and Testing This Release
It includes the backport of our Config API and other conventions that will hopefully make it easier for mods to interact with Sodium across multiple versions. This release series doesn't get released at the same cadence as our current releases for Minecraft 26.1 and 1.21.11, and doesn't follow the same alpha/beta numbering. Mod developers can find our artifacts, such as the Config API, on [our Maven repository](https://maven.caffeinemc.net/).

Please participate in testing this release, coordinating on mod compatibility, and giving feedback on [our discord server](https://caffeinemc.net/discord).

Known incompatibilities at the time of release:
- Iris
- Voxy
- More culling, sodiumleafculling
- Create Aeronautics, Sable

### Alpha Series Changelog
- Fix BufferBuilderMixin conflicting with Iris' MixinBufferBuilder_SeparateAo when requireOverwriteAnnotations is enabled ([#3658](https://github.com/CaffeineMC/sodium/pull/3658))
- Potentially fix issues with publishing by making the buildscript more similar to that used in 1.21.11

Sodium 0.8.12-beta.3 fixes a number of bugs, adds some new features, and improves memory usage. It also includes multiple improvements to lighting.

The release includes a new display of FPS percentiles which more accurately represent what you actually want to know about the FPS.
- The median (labeled p50) shows the typical frame rate ignoring the slow frames
- The 98th and 99.5th percentiles show the FPS of slow and very slow frames.
- The average, which is what Minecraft displays by default, can get pulled down by few slow frames even though otherwise the frame rate is pretty high. This leads to the average FPS being not very representative of the actual frame rate you're seeing most of the time.

The new option to sort entities quads by their closest point allows correct rendering of similar translucent entities that have specific types of otherwise wrongly sorted geometry. This is disabled by default as it incurs a performance cost.

The bug fixes include multiple crash fixes and changes to avoid retaining large memory allocations in specific scenarios.

- Fix the animation when fluid sprites are obtained directly via FluidModel ([#3630](https://github.com/CaffeineMC/sodium/pull/3630))
- Avoid retaining large allocations created when heavy quad splitting takes place
- Fix buffer overflow caused by BSP Node reuse when quads were split
- Fix wrong applicability test in BaseBiForest that would cause wrong rendering at render distances >32
- Fix post launch checks to actually run and fix duplicate module dialog ([#3624](https://github.com/CaffeineMC/sodium/pull/3624))
- Implement optional percentile fps display ([#3633](https://github.com/CaffeineMC/sodium/pull/3633), [#3642](https://github.com/CaffeineMC/sodium/pull/3642))
- Fix flat fluid lighting being too dark ([#3620](https://github.com/CaffeineMC/sodium/pull/3620))
- Significantly reduce memory consumption on the direct sorting fallback path
- Fix issues with fluid shaping in both "improved" and regular mode
- Fix #3612 by performing uniform binding on particle rendering ([#3637](https://github.com/CaffeineMC/sodium/pull/3637))
- Fixed #3603 (incorrect AO and skylight level around light sources) ([#3631](https://github.com/CaffeineMC/sodium/pull/3631))
- Add option to sort Entity Quads by Closest Point ([#3635](https://github.com/CaffeineMC/sodium/pull/3635))
- Fix Minecraft's CompactVectorArray#getZ returning the wrong value which broke some mods' rendering ([#3643](https://github.com/CaffeineMC/sodium/pull/3643))
- Change fullbright blocks to only emit block light and no sky light ([#3640](https://github.com/CaffeineMC/sodium/pull/3640))
- Fix clouds being invisible behind leaves with specific resource packs
- Refactor `ImprovedItemModelBuilder` for better mod compatibility ([#3648](https://github.com/CaffeineMC/sodium/pull/3648))

Please participate in testing this release and giving feedback on [our discord server](https://caffeinemc.net/discord).

Sodium 0.8.12-beta.3 fixes a number of bugs, adds some new features, and improves memory usage. It also includes multiple improvements to lighting.

The release includes a new display of FPS percentiles which more accurately represent what you actually want to know about the FPS.
- The median (labeled p50) shows the typical frame rate ignoring the slow frames
- The 98th and 99.5th percentiles show the FPS of slow and very slow frames.
- The average, which is what Minecraft displays by default, can get pulled down by few slow frames even though otherwise the frame rate is pretty high. This leads to the average FPS being not very representative of the actual frame rate you're seeing most of the time.

The new option to sort entities quads by their closest point allows correct rendering of similar translucent entities that have specific types of otherwise wrongly sorted geometry. This is disabled by default as it incurs a performance cost.

The bug fixes include multiple crash fixes and changes to avoid retaining large memory allocations in specific scenarios.

- Fix the animation when fluid sprites are obtained directly via FluidModel ([#3630](https://github.com/CaffeineMC/sodium/pull/3630))
- Avoid retaining large allocations created when heavy quad splitting takes place
- Fix buffer overflow caused by BSP Node reuse when quads were split
- Fix wrong applicability test in BaseBiForest that would cause wrong rendering at render distances >32
- Fix post launch checks to actually run and fix duplicate module dialog ([#3624](https://github.com/CaffeineMC/sodium/pull/3624))
- Implement optional percentile fps display ([#3633](https://github.com/CaffeineMC/sodium/pull/3633), [#3642](https://github.com/CaffeineMC/sodium/pull/3642))
- Fix flat fluid lighting being too dark ([#3620](https://github.com/CaffeineMC/sodium/pull/3620))
- Significantly reduce memory consumption on the direct sorting fallback path
- Fix issues with fluid shaping in both "improved" and regular mode
- Fix #3612 by performing uniform binding on particle rendering ([#3637](https://github.com/CaffeineMC/sodium/pull/3637))
- Fixed #3603 (incorrect AO and skylight level around light sources) ([#3631](https://github.com/CaffeineMC/sodium/pull/3631))
- Add option to sort Entity Quads by Closest Point ([#3635](https://github.com/CaffeineMC/sodium/pull/3635))
- Fix Minecraft's CompactVectorArray#getZ returning the wrong value which broke some mods' rendering ([#3643](https://github.com/CaffeineMC/sodium/pull/3643))
- Change fullbright blocks to only emit block light and no sky light ([#3640](https://github.com/CaffeineMC/sodium/pull/3640))
- Fix clouds being invisible behind leaves with specific resource packs
- Refactor `ImprovedItemModelBuilder` for better mod compatibility ([#3648](https://github.com/CaffeineMC/sodium/pull/3648))

Please participate in testing this release and giving feedback on [our discord server](https://caffeinemc.net/discord).

Sodium 0.8.12-alpha.1 is a backport of modern Sodium 0.8.12 to Minecraft 1.21.1. This experiment has graduated to alpha status. The degree to which we commit to supporting this branch will be determined by testing and by how well it works and integrates with the ecosystem. The quality of this version is expected to further improve it gets used, we discover quirks, and receive feedback.

- Significantly improved the performance of rendering the world (up to +115%) on some computers.
- Greatly improved the rendering of transparent objects with complex models, especially when submerged in water.
- Lots and lots of improvements to the user experience in the Video Settings menu.
- Reduced latency and micro-stutter when updating chunks in the world.
- Slightly faster entity rendering, especially for transparent mobs and particles.
- Improvements for hardware and mod compatibility.
- ...And many more bug fixes and improvements...

It includes the backport of our Config API and other conventions that will hopefully make it easier for mods to interact with Sodium across multiple versions. This release series doesn't get released at the same cadence as our current releases for Minecraft 26.1 and 1.21.11, and doesn't follow the same alpha/beta numbering.

Please participate in testing this release, coordinating on mod compatibility, and giving feedback on [our discord server](https://caffeinemc.net/discord).

Sodium 0.8.12-alpha.1 is a backport of modern Sodium 0.8.12 to Minecraft 1.21.1. This experiment has graduated to alpha status. The degree to which we commit to supporting this branch will be determined by testing and by how well it works and integrates with the ecosystem. The quality of this version is expected to further improve it gets used, we discover quirks, and receive feedback.

- Significantly improved the performance of rendering the world (up to +115%) on some computers.
- Greatly improved the rendering of transparent objects with complex models, especially when submerged in water.
- Lots and lots of improvements to the user experience in the Video Settings menu.
- Reduced latency and micro-stutter when updating chunks in the world.
- Slightly faster entity rendering, especially for transparent mobs and particles.
- Improvements for hardware and mod compatibility.
- ...And many more bug fixes and improvements...

It includes the backport of our Config API and other conventions that will hopefully make it easier for mods to interact with Sodium across multiple versions. This release series doesn't get released at the same cadence as our current releases for Minecraft 26.1 and 1.21.11, and doesn't follow the same alpha/beta numbering.

Please participate in testing this release, coordinating on mod compatibility, and giving feedback on [our discord server](https://caffeinemc.net/discord).

Sodium 0.8.12-beta.2 fixes a number of bugs, adds some new features, and improves memory usage. It also includes multiple improvements to lighting.

The release includes a new display of FPS percentiles which more accurately represent what you actually want to know about the FPS.
- The median (labeled p50) shows the typical frame rate ignoring the slow frames
- The 98th and 99.5th percentiles show the FPS of slow and very slow frames.
- The average, which is what Minecraft displays by default, can get pulled down by few slow frames even though otherwise the frame rate is pretty high. This leads to the average FPS being not very representative of the actual frame rate you're seeing most of the time.

The new option to sort entities quads by their closest point allows correct rendering of similar translucent entities that have specific types of otherwise wrongly sorted geometry. This is disabled by default as it incurs a performance cost.

The bug fixes include multiple crash fixes and changes to avoid retaining large memory allocations in specific scenarios.

- Avoid retaining large allocations created when heavy quad splitting takes place
- Fix buffer overflow caused by BSP Node reuse when quads were split
- Fix wrong applicability test in BaseBiForest that would cause wrong rendering at render distances >32
- Implement optional percentile fps display ([#3633](https://github.com/CaffeineMC/sodium/pull/3633), [#3642](https://github.com/CaffeineMC/sodium/pull/3642))
- Fix flat fluid lighting being too dark ([#3620](https://github.com/CaffeineMC/sodium/pull/3620))
- Significantly reduce memory consumption on the direct sorting fallback path
- Fix issues with fluid shaping in both "improved" and regular mode
- Fix #3612 by performing uniform binding on particle rendering ([#3637](https://github.com/CaffeineMC/sodium/pull/3637))
- Fixed #3603 (incorrect AO and skylight level around light sources) ([#3631](https://github.com/CaffeineMC/sodium/pull/3631))
- Add option to sort Entity Quads by Closest Point ([#3635](https://github.com/CaffeineMC/sodium/pull/3635))
- Fix Minecraft's CompactVectorArray#getZ returning the wrong value which broke some mods' rendering ([#3643](https://github.com/CaffeineMC/sodium/pull/3643))
- Change fullbright blocks to only emit block light and no sky light ([#3640](https://github.com/CaffeineMC/sodium/pull/3640))

Sodium 0.8.12-beta.2 fixes a number of bugs, adds some new features, and improves memory usage. It also includes multiple improvements to lighting.

The release includes a new display of FPS percentiles which more accurately represent what you actually want to know about the FPS.
- The median (labeled p50) shows the typical frame rate ignoring the slow frames
- The 98th and 99.5th percentiles show the FPS of slow and very slow frames.
- The average, which is what Minecraft displays by default, can get pulled down by few slow frames even though otherwise the frame rate is pretty high. This leads to the average FPS being not very representative of the actual frame rate you're seeing most of the time.

The new option to sort entities quads by their closest point allows correct rendering of similar translucent entities that have specific types of otherwise wrongly sorted geometry. This is disabled by default as it incurs a performance cost.

The bug fixes include multiple crash fixes and changes to avoid retaining large memory allocations in specific scenarios.

- Avoid retaining large allocations created when heavy quad splitting takes place
- Fix buffer overflow caused by BSP Node reuse when quads were split
- Fix wrong applicability test in BaseBiForest that would cause wrong rendering at render distances >32
- Implement optional percentile fps display ([#3633](https://github.com/CaffeineMC/sodium/pull/3633), [#3642](https://github.com/CaffeineMC/sodium/pull/3642))
- Fix flat fluid lighting being too dark ([#3620](https://github.com/CaffeineMC/sodium/pull/3620))
- Significantly reduce memory consumption on the direct sorting fallback path
- Fix issues with fluid shaping in both "improved" and regular mode
- Fix #3612 by performing uniform binding on particle rendering ([#3637](https://github.com/CaffeineMC/sodium/pull/3637))
- Fixed #3603 (incorrect AO and skylight level around light sources) ([#3631](https://github.com/CaffeineMC/sodium/pull/3631))
- Add option to sort Entity Quads by Closest Point ([#3635](https://github.com/CaffeineMC/sodium/pull/3635))
- Fix Minecraft's CompactVectorArray#getZ returning the wrong value which broke some mods' rendering ([#3643](https://github.com/CaffeineMC/sodium/pull/3643))
- Change fullbright blocks to only emit block light and no sky light ([#3640](https://github.com/CaffeineMC/sodium/pull/3640))

Sodium 0.8.12-beta.2 fixes a number of bugs, adds some new features, and improves memory usage. It also includes multiple improvements to lighting.

The release includes a new display of FPS percentiles which more accurately represent what you actually want to know about the FPS.
- The median (labeled p50) shows the typical frame rate ignoring the slow frames
- The 98th and 99.5th percentiles show the FPS of slow and very slow frames.
- The average, which is what Minecraft displays by default, can get pulled down by few slow frames even though otherwise the frame rate is pretty high. This leads to the average FPS being not very representative of the actual frame rate you're seeing most of the time.

The new option to sort entities quads by their closest point allows correct rendering of similar translucent entities that have specific types of otherwise wrongly sorted geometry. This is disabled by default as it incurs a performance cost.

The bug fixes include multiple crash fixes and changes to avoid retaining large memory allocations in specific scenarios.

- Fix the animation when fluid sprites are obtained directly via FluidModel ([#3630](https://github.com/CaffeineMC/sodium/pull/3630))
- Avoid retaining large allocations created when heavy quad splitting takes place
- Fix buffer overflow caused by BSP Node reuse when quads were split
- Fix wrong applicability test in BaseBiForest that would cause wrong rendering at render distances >32
- Fix post launch checks to actually run and fix duplicate module dialog ([#3624](https://github.com/CaffeineMC/sodium/pull/3624))
- Implement optional percentile fps display ([#3633](https://github.com/CaffeineMC/sodium/pull/3633), [#3642](https://github.com/CaffeineMC/sodium/pull/3642))
- Fix flat fluid lighting being too dark ([#3620](https://github.com/CaffeineMC/sodium/pull/3620))
- Significantly reduce memory consumption on the direct sorting fallback path
- Fix issues with fluid shaping in both "improved" and regular mode
- Fix #3612 by performing uniform binding on particle rendering ([#3637](https://github.com/CaffeineMC/sodium/pull/3637))
- Fixed #3603 (incorrect AO and skylight level around light sources) ([#3631](https://github.com/CaffeineMC/sodium/pull/3631))
- Add option to sort Entity Quads by Closest Point ([#3635](https://github.com/CaffeineMC/sodium/pull/3635))
- Fix Minecraft's CompactVectorArray#getZ returning the wrong value which broke some mods' rendering ([#3643](https://github.com/CaffeineMC/sodium/pull/3643))
- Change fullbright blocks to only emit block light and no sky light ([#3640](https://github.com/CaffeineMC/sodium/pull/3640))

Sodium 0.8.12-beta.2 fixes a number of bugs, adds some new features, and improves memory usage. It also includes multiple improvements to lighting.

The release includes a new display of FPS percentiles which more accurately represent what you actually want to know about the FPS.
- The median (labeled p50) shows the typical frame rate ignoring the slow frames
- The 98th and 99.5th percentiles show the FPS of slow and very slow frames.
- The average, which is what Minecraft displays by default, can get pulled down by few slow frames even though otherwise the frame rate is pretty high. This leads to the average FPS being not very representative of the actual frame rate you're seeing most of the time.

The new option to sort entities quads by their closest point allows correct rendering of similar translucent entities that have specific types of otherwise wrongly sorted geometry. This is disabled by default as it incurs a performance cost.

The bug fixes include multiple crash fixes and changes to avoid retaining large memory allocations in specific scenarios.

- Fix the animation when fluid sprites are obtained directly via FluidModel ([#3630](https://github.com/CaffeineMC/sodium/pull/3630))
- Avoid retaining large allocations created when heavy quad splitting takes place
- Fix buffer overflow caused by BSP Node reuse when quads were split
- Fix wrong applicability test in BaseBiForest that would cause wrong rendering at render distances >32
- Fix post launch checks to actually run and fix duplicate module dialog ([#3624](https://github.com/CaffeineMC/sodium/pull/3624))
- Implement optional percentile fps display ([#3633](https://github.com/CaffeineMC/sodium/pull/3633), [#3642](https://github.com/CaffeineMC/sodium/pull/3642))
- Fix flat fluid lighting being too dark ([#3620](https://github.com/CaffeineMC/sodium/pull/3620))
- Significantly reduce memory consumption on the direct sorting fallback path
- Fix issues with fluid shaping in both "improved" and regular mode
- Fix #3612 by performing uniform binding on particle rendering ([#3637](https://github.com/CaffeineMC/sodium/pull/3637))
- Fixed #3603 (incorrect AO and skylight level around light sources) ([#3631](https://github.com/CaffeineMC/sodium/pull/3631))
- Add option to sort Entity Quads by Closest Point ([#3635](https://github.com/CaffeineMC/sodium/pull/3635))
- Fix Minecraft's CompactVectorArray#getZ returning the wrong value which broke some mods' rendering ([#3643](https://github.com/CaffeineMC/sodium/pull/3643))
- Change fullbright blocks to only emit block light and no sky light ([#3640](https://github.com/CaffeineMC/sodium/pull/3640))

Sodium 0.8.12-beta.1 fixes a number of bugs, adds some new features, and improves memory usage. The release includes a new display of FPS percentiles which more accurately represent what you actually want to know about the FPS.
- The median (labeled p50) shows the typical frame rate ignoring the slow frames
- The 98th and 99.5th percentiles show the FPS of slow and very slow frames
The average, which is what Minecraft displays by default, can get pulled down by few slow frames even though otherwise the frame rate is pretty high. This leads to the average FPS being not very representative of the actual frame rate you're seeing most of the time.

The new option to sort entities quads by their closest point allows correct rendering of similar translucent entities that have specific types of otherwise wrongly sorted geometry. This is disabled by default as it incurs a performance cost.

The bug fixes include multiple crash fixes and changes to avoid retaining large memory allocations in specific scenarios.

- Avoid retaining large allocations created when heavy quad splitting takes place
- Fix buffer overflow caused by BSP Node reuse when quads were split
- Fix wrong applicability test in BaseBiForest that would cause wrong rendering at render distances >32
- Implement optional percentile fps display ([#3633](https://github.com/CaffeineMC/sodium/pull/3633))
- Fix flat fluid lighting being too dark ([#3620](https://github.com/CaffeineMC/sodium/pull/3620))
- Significantly reduce memory consumption on the direct sorting fallback path
- Fix issues with fluid shaping in both "improved" and regular mode
- Fix #3612 by performing uniform binding on particle rendering ([#3637](https://github.com/CaffeineMC/sodium/pull/3637))
- Fixed #3603 (incorrect AO and skylight level around light sources) ([#3631](https://github.com/CaffeineMC/sodium/pull/3631))
- Add option to sort Entity Quads by Closest Point ([#3635](https://github.com/CaffeineMC/sodium/pull/3635))

Sodium 0.8.12-beta.1 fixes a number of bugs, adds some new features, and improves memory usage. The release includes a new display of FPS percentiles which more accurately represent what you actually want to know about the FPS.
- The median (labeled p50) shows the typical frame rate ignoring the slow frames
- The 98th and 99.5th percentiles show the FPS of slow and very slow frames
The average, which is what Minecraft displays by default, can get pulled down by few slow frames even though otherwise the frame rate is pretty high. This leads to the average FPS being not very representative of the actual frame rate you're seeing most of the time.

The new option to sort entities quads by their closest point allows correct rendering of similar translucent entities that have specific types of otherwise wrongly sorted geometry. This is disabled by default as it incurs a performance cost.

The bug fixes include multiple crash fixes and changes to avoid retaining large memory allocations in specific scenarios.

- Avoid retaining large allocations created when heavy quad splitting takes place
- Fix buffer overflow caused by BSP Node reuse when quads were split
- Fix wrong applicability test in BaseBiForest that would cause wrong rendering at render distances >32
- Implement optional percentile fps display ([#3633](https://github.com/CaffeineMC/sodium/pull/3633))
- Fix flat fluid lighting being too dark ([#3620](https://github.com/CaffeineMC/sodium/pull/3620))
- Significantly reduce memory consumption on the direct sorting fallback path
- Fix issues with fluid shaping in both "improved" and regular mode
- Fix #3612 by performing uniform binding on particle rendering ([#3637](https://github.com/CaffeineMC/sodium/pull/3637))
- Fixed #3603 (incorrect AO and skylight level around light sources) ([#3631](https://github.com/CaffeineMC/sodium/pull/3631))
- Add option to sort Entity Quads by Closest Point ([#3635](https://github.com/CaffeineMC/sodium/pull/3635))

Sodium 0.8.12-beta.1 fixes a number of bugs, adds some new features, and improves memory usage. The release includes a new display of FPS percentiles which more accurately represent what you actually want to know about the FPS.
- The median (labeled p50) shows the typical frame rate ignoring the slow frames
- The 98th and 99.5th percentiles show the FPS of slow and very slow frames
The average, which is what Minecraft displays by default, can get pulled down by few slow frames even though otherwise the frame rate is pretty high. This leads to the average FPS being not very representative of the actual frame rate you're seeing most of the time.

The new option to sort entities quads by their closest point allows correct rendering of similar translucent entities that have specific types of otherwise wrongly sorted geometry. This is disabled by default as it incurs a performance cost.

The bug fixes include multiple crash fixes and changes to avoid retaining large memory allocations in specific scenarios.

- Fix the animation when fluid sprites are obtained directly via FluidModel ([#3630](https://github.com/CaffeineMC/sodium/pull/3630))
- Avoid retaining large allocations created when heavy quad splitting takes place
- Fix buffer overflow caused by BSP Node reuse when quads were split
- Fix wrong applicability test in BaseBiForest that would cause wrong rendering at render distances >32
- Fix post launch checks to actually run and fix duplicate module dialog ([#3624](https://github.com/CaffeineMC/sodium/pull/3624))
- Implement optional percentile fps display ([#3633](https://github.com/CaffeineMC/sodium/pull/3633))
- Fix flat fluid lighting being too dark ([#3620](https://github.com/CaffeineMC/sodium/pull/3620))
- Significantly reduce memory consumption on the direct sorting fallback path
- Fix issues with fluid shaping in both "improved" and regular mode
- Fix #3612 by performing uniform binding on particle rendering ([#3637](https://github.com/CaffeineMC/sodium/pull/3637))
- Fixed #3603 (incorrect AO and skylight level around light sources) ([#3631](https://github.com/CaffeineMC/sodium/pull/3631))
- Add option to sort Entity Quads by Closest Point ([#3635](https://github.com/CaffeineMC/sodium/pull/3635))

Sodium 0.8.12-beta.1 fixes a number of bugs, adds some new features, and improves memory usage. The release includes a new display of FPS percentiles which more accurately represent what you actually want to know about the FPS.
- The median (labeled p50) shows the typical frame rate ignoring the slow frames
- The 98th and 99.5th percentiles show the FPS of slow and very slow frames
The average, which is what Minecraft displays by default, can get pulled down by few slow frames even though otherwise the frame rate is pretty high. This leads to the average FPS being not very representative of the actual frame rate you're seeing most of the time.

The new option to sort entities quads by their closest point allows correct rendering of similar translucent entities that have specific types of otherwise wrongly sorted geometry. This is disabled by default as it incurs a performance cost.

The bug fixes include multiple crash fixes and changes to avoid retaining large memory allocations in specific scenarios.

- Fix the animation when fluid sprites are obtained directly via FluidModel ([#3630](https://github.com/CaffeineMC/sodium/pull/3630))
- Avoid retaining large allocations created when heavy quad splitting takes place
- Fix buffer overflow caused by BSP Node reuse when quads were split
- Fix wrong applicability test in BaseBiForest that would cause wrong rendering at render distances >32
- Fix post launch checks to actually run and fix duplicate module dialog ([#3624](https://github.com/CaffeineMC/sodium/pull/3624))
- Implement optional percentile fps display ([#3633](https://github.com/CaffeineMC/sodium/pull/3633))
- Fix flat fluid lighting being too dark ([#3620](https://github.com/CaffeineMC/sodium/pull/3620))
- Significantly reduce memory consumption on the direct sorting fallback path
- Fix issues with fluid shaping in both "improved" and regular mode
- Fix #3612 by performing uniform binding on particle rendering ([#3637](https://github.com/CaffeineMC/sodium/pull/3637))
- Fixed #3603 (incorrect AO and skylight level around light sources) ([#3631](https://github.com/CaffeineMC/sodium/pull/3631))
- Add option to sort Entity Quads by Closest Point ([#3635](https://github.com/CaffeineMC/sodium/pull/3635))

Sodium 0.8.11 for Minecraft 1.21.11 makes some improvements to the options UI, introduces a new automatic publishing system, fixes some bugs, and introduces some small performance optimizations.

- Fix issues with improved item meshing and add documentation ([#3581](https://github.com/CaffeineMC/sodium/pull/3581))
- Update neoforge to stable
- Workflow and Gradle based publishing setup with changelog system ([#3575](https://github.com/CaffeineMC/sodium/pull/3575), [#3622](https://github.com/CaffeineMC/sodium/pull/3622))
- refactor: Lazily construct expensive ShapeComparisonCache object ([#3607](https://github.com/CaffeineMC/sodium/pull/3607))
- Invalidate cached search index sources to be properly indexed after language switch
- Jump to the mod's options when its header in the page list is clicked
- Show that an entry in the options page list leads to an external page more clearly
- Hide options search bar clear button when search bar is empty
- Implement Alt shortcuts and ESC discard behavior ([#2769](https://github.com/CaffeineMC/sodium/pull/2769)) ([#3604](https://github.com/CaffeineMC/sodium/pull/3604))
- Reset button for options with hold-shift to reset functionality
- Fix rare translucency sorting crash when repeatedly interacting with specific chunks with some resource packs ([#3609](https://github.com/CaffeineMC/sodium/pull/3609))
- Configurable filtering mode ([#3618](https://github.com/CaffeineMC/sodium/pull/3618))
- Fix animated sprite mipping ([#3619](https://github.com/CaffeineMC/sodium/pull/3619))
- Add caching to `GlStateManager#glViewport` ([#3309](https://github.com/CaffeineMC/sodium/pull/3309))

Sodium 0.8.11 for Minecraft 1.21.11 makes some improvements to the options UI, introduces a new automatic publishing system, fixes some bugs, and introduces some small performance optimizations.

- Fix issues with improved item meshing and add documentation ([#3581](https://github.com/CaffeineMC/sodium/pull/3581))
- Update neoforge to stable
- Workflow and Gradle based publishing setup with changelog system ([#3575](https://github.com/CaffeineMC/sodium/pull/3575), [#3622](https://github.com/CaffeineMC/sodium/pull/3622))
- refactor: Lazily construct expensive ShapeComparisonCache object ([#3607](https://github.com/CaffeineMC/sodium/pull/3607))
- Invalidate cached search index sources to be properly indexed after language switch
- Jump to the mod's options when its header in the page list is clicked
- Show that an entry in the options page list leads to an external page more clearly
- Hide options search bar clear button when search bar is empty
- Implement Alt shortcuts and ESC discard behavior ([#2769](https://github.com/CaffeineMC/sodium/pull/2769)) ([#3604](https://github.com/CaffeineMC/sodium/pull/3604))
- Reset button for options with hold-shift to reset functionality
- Fix rare translucency sorting crash when repeatedly interacting with specific chunks with some resource packs ([#3609](https://github.com/CaffeineMC/sodium/pull/3609))
- Configurable filtering mode ([#3618](https://github.com/CaffeineMC/sodium/pull/3618))
- Fix animated sprite mipping ([#3619](https://github.com/CaffeineMC/sodium/pull/3619))
- Add caching to `GlStateManager#glViewport` ([#3309](https://github.com/CaffeineMC/sodium/pull/3309))

Sodium 0.8.11 for Minecraft 26.1.2 makes some improvements to the options UI, introduces a new automatic publishing system, fixes some bugs, and introduces some small performance optimizations.

- Workflow and Gradle based publishing setup with changelog system ([#3575](https://github.com/CaffeineMC/sodium/pull/3575), [#3622](https://github.com/CaffeineMC/sodium/pull/3622))
- Invalidate cached search index sources to be properly indexed after language switch
- Jump to the mod's options when its header in the page list is clicked
- Show that an entry in the options page list leads to an external page more clearly
- Hide options search bar clear button when search bar is empty
- Implement Alt shortcuts and ESC discard behavior ([#2769](https://github.com/CaffeineMC/sodium/pull/2769)) ([#3604](https://github.com/CaffeineMC/sodium/pull/3604))
- Reset button for options with hold-shift to reset functionality
- Fix rare translucency sorting crash when repeatedly interacting with specific chunks with some resource packs ([#3609](https://github.com/CaffeineMC/sodium/pull/3609))
- Make the filtering mode configurable with an option and change the default to nearest
- Fix animated sprite mipping ([#3619](https://github.com/CaffeineMC/sodium/pull/3619))
- Add caching to `GlStateManager#glViewport` ([#3309](https://github.com/CaffeineMC/sodium/pull/3309))
- Add support for new fabric color provider API
- Fix tint on neoforge when blocks are rendered as items ([#3615](https://github.com/CaffeineMC/sodium/pull/3615))
- Fix the animation when fluid sprites are obtained directly via FluidModel ([#3630](https://github.com/CaffeineMC/sodium/pull/3630))

Sodium 0.8.11 for Minecraft 26.1.2 makes some improvements to the options UI, introduces a new automatic publishing system, fixes some bugs, and introduces some small performance optimizations.

- Workflow and Gradle based publishing setup with changelog system ([#3575](https://github.com/CaffeineMC/sodium/pull/3575), [#3622](https://github.com/CaffeineMC/sodium/pull/3622))
- Invalidate cached search index sources to be properly indexed after language switch
- Jump to the mod's options when its header in the page list is clicked
- Show that an entry in the options page list leads to an external page more clearly
- Hide options search bar clear button when search bar is empty
- Implement Alt shortcuts and ESC discard behavior ([#2769](https://github.com/CaffeineMC/sodium/pull/2769)) ([#3604](https://github.com/CaffeineMC/sodium/pull/3604))
- Reset button for options with hold-shift to reset functionality
- Fix rare translucency sorting crash when repeatedly interacting with specific chunks with some resource packs ([#3609](https://github.com/CaffeineMC/sodium/pull/3609))
- Make the filtering mode configurable with an option and change the default to nearest
- Fix animated sprite mipping ([#3619](https://github.com/CaffeineMC/sodium/pull/3619))
- Add caching to `GlStateManager#glViewport` ([#3309](https://github.com/CaffeineMC/sodium/pull/3309))
- Add support for new fabric color provider API
- Fix tint on neoforge when blocks are rendered as items ([#3615](https://github.com/CaffeineMC/sodium/pull/3615))
- Fix the animation when fluid sprites are obtained directly via FluidModel ([#3630](https://github.com/CaffeineMC/sodium/pull/3630))

Sodium 0.8.10 fixes some bugs. This release is primarily relevant for NeoForge.

- Support Minecraft 26.1.2
- Sources jar is now published to our Maven ([#3592](https://github.com/CaffeineMC/sodium/pull/3592))
- Lazily construct expensive ShapeComparisonCache object ([#3607](https://github.com/CaffeineMC/sodium/pull/3607))

Sodium 0.8.10 fixes some bugs and updates to the latest version of NeoForge.

- Support Minecraft 26.1.2 and NeoForge 26.1.2.29
- Fixes water color with zero-alpha being invisible on NeoForge after the port to 26.1. ([#3577](https://github.com/CaffeineMC/sodium/pull/3577))
- Sources jar is now published to our Maven ([#3592](https://github.com/CaffeineMC/sodium/pull/3592))
- Lazily construct expensive ShapeComparisonCache object ([#3607](https://github.com/CaffeineMC/sodium/pull/3607))

This release fixes bugs and makes some miscellaneous improvements.

- Fixed vanilla performance regression in item models when using high resolution texture packs ([PR](https://github.com/CaffeineMC/sodium/pull/3551))
- Better error messages for option override/overlay conflicts
- Only show amd workarounds message on windows ([PR](https://github.com/CaffeineMC/sodium/pull/3553))
- Improved down-facing inner fluid face heuristic ([PR](https://github.com/CaffeineMC/sodium/pull/3552))
- Fix severe performance issue on 26.1 due to Java 25

This release fixes bugs and makes some miscellaneous improvements.

- Fixed vanilla performance regression in item models when using high resolution texture packs ([PR](https://github.com/CaffeineMC/sodium/pull/3551))
- Better error messages for option override/overlay conflicts
- Only show amd workarounds message on windows ([PR](https://github.com/CaffeineMC/sodium/pull/3553))
- Improved down-facing inner fluid face heuristic ([PR](https://github.com/CaffeineMC/sodium/pull/3552))
- Fixes a crash with Fabric API 0.145.0+
- Fix severe performance issue on 26.1 due to Java 25

This release updates to Minecraft 26.1, as well as fixing a few bugs.

- Improved the error message about LWJGL being the wrong version ([PR](https://github.com/CaffeineMC/sodium/pull/3527))
- Improved fluid culling and shaping ([PR](https://github.com/CaffeineMC/sodium/pull/2931))
- Improved mod compatibility ([PR](https://github.com/CaffeineMC/sodium/pull/3540), [PR](https://github.com/CaffeineMC/sodium/pull/3539))
- Fixed an issue with the fog distance ([PR](https://github.com/CaffeineMC/sodium/pull/3510))
- Fixed a number of smaller issues and performed refactoring

This release updates to Minecraft 26.1, as well as fixing a few bugs.

- Improved the error message about LWJGL being the wrong version ([PR](https://github.com/CaffeineMC/sodium/pull/3527))
- Improved fluid culling and shaping ([PR](https://github.com/CaffeineMC/sodium/pull/2931))
- Improved mod compatibility ([PR](https://github.com/CaffeineMC/sodium/pull/3540), [PR](https://github.com/CaffeineMC/sodium/pull/3539))
- Fixed an issue with the fog distance ([PR](https://github.com/CaffeineMC/sodium/pull/3510))
- Fixed a number of smaller issues and performed refactoring

This release updates to Minecraft 26.1, as well as fixing a few bugs.

- Improved the error message about LWJGL being the wrong version ([PR](https://github.com/CaffeineMC/sodium/pull/3527))
- Improved fluid culling and shaping ([PR](https://github.com/CaffeineMC/sodium/pull/2931))
- Improved mod compatibility ([PR](https://github.com/CaffeineMC/sodium/pull/3540), [PR](https://github.com/CaffeineMC/sodium/pull/3539))
- Fixed an issue with the fog distance ([PR](https://github.com/CaffeineMC/sodium/pull/3510))
- Fixed a number of smaller issues and performed refactoring

In this release we've fixed some bugs and introduced a small CPU-side performance improvement to occlusion culling.

In this release we've fixed some bugs and introduced a small CPU-side performance improvement to occlusion culling.

This release fixes a bug preventing some users on _Wayland_ from launching the game.

This release fixes a bug preventing users on Wayland from starting the game.

This release makes some improvements to the options UI and fixes issues in the UI, translucency sorting, occlusion culling, and regarding mod compatibility.

This release makes some improvements to the options UI and fixes issues in the UI, translucency sorting, occlusion culling, and regarding mod compatibility.

This release fixes a critical bug with FRAPI, as well as allowing mods to set non-monochrome icons.

This release fixes a critical bug with FRAPI, as well as allowing mods to set non-monochrome icons.

This release adds support for the Fabric Rendering API on 1.21.11, works around a bug where blocks would turn invisible with certain launchers on certain AMD drivers, and fixes many bugs with the new configuration screen.

This release adds support for the Fabric Rendering API on 1.21.11, works around a bug where blocks would turn invisible with certain launchers on certain AMD drivers, and fixes many bugs with the new configuration screen.

This release comes with many bug fixes, a brand new configuration screen, and support for Minecraft 1.21.11.

This release comes with many bug fixes, a brand new configuration screen, and support for Minecraft 1.21.11.

This release fixes a stuttering issue affecting Intel cards.

This release fixes a stuttering issue affecting Intel cards.

This release fixes a stuttering issue affecting Intel cards.

This release fixes a stuttering issue affecting Intel cards.

- Improved the appearance of mipmaps when viewed at extreme angles, especially when looking at fire or tall grass blocks (JellySquid)
- Fixed a crash that could occur under specific circumstances when alpha-blended blocks were re-sorted (Douira)
- Reduced the amount of visual flickering that occurs when pistons and other animated blocks are updated in the world (Douira)
- Reduced the number of nuisance warnings caused by the resource pack compatibility checks (Douira)
- Fixed a problem that caused model faces to render in a different order, which caused some resource packs to break (2190303755)
- Added support for Fabric's Item Rendering APIs, which at the time of Minecraft 1.21.9's release were not yet fully implemented in Indigo (IMS, Pepper)

- Improved the appearance of mipmaps when viewed at extreme angles, especially when looking at fire or tall grass blocks (JellySquid)
- Fixed a crash that could occur under specific circumstances when alpha-blended blocks were re-sorted (Douira)
- Reduced the amount of visual flickering that occurs when pistons and other animated blocks are updated in the world (Douira)
- Reduced the number of nuisance warnings caused by the resource pack compatibility checks (Douira)
- Fixed a problem that caused model faces to render in a different order, which caused some resource packs to break (2190303755)
- Added support for Fabric's Item Rendering APIs, which at the time of Minecraft 1.21.9's release were not yet fully implemented in Indigo (IMS, Pepper)

- Improved the appearance of mipmaps when viewed at extreme angles, especially when looking at fire or tall grass blocks (JellySquid)
- Fixed a crash that could occur under specific circumstances when alpha-blended blocks were re-sorted (Douira)
- Reduced the amount of visual flickering that occurs when pistons and other animated blocks are updated in the world (Douira)
- Reduced the number of nuisance warnings caused by the resource pack compatibility checks (Douira)
- Fixed a problem that caused model faces to render in a different order, which caused some resource packs to break (2190303755)
- Added support for Fabric's Item Rendering APIs, which at the time of Minecraft 1.21.9's release were not yet fully implemented in Indigo (IMS, Pepper)

- Improved the appearance of mipmaps when viewed at extreme angles, especially when looking at fire or tall grass blocks (JellySquid)
- Fixed a crash that could occur under specific circumstances when alpha-blended blocks were re-sorted (Douira)
- Reduced the amount of visual flickering that occurs when pistons and other animated blocks are updated in the world (Douira)
- Reduced the number of nuisance warnings caused by the resource pack compatibility checks (Douira)
- Fixed a problem that caused model faces to render in a different order, which caused some resource packs to break (2190303755)
- Added support for Fabric's Item Rendering APIs, which at the time of Minecraft 1.21.9's release were not yet fully implemented in Indigo (IMS, Pepper)

This release brings a variety of performance optimizations, new features, and bug fixes.

We've spent a lot of time developing and testing this release, with some changes having been worked on and tuned for over a year. Thanks to our community members who contributed features and bug fixes to this release! If you are a mod author who finds their mod no longer works with Sodium 0.7, please [open an issue](https://github.com/CaffeineMC/sodium/issues) so that we can work with you to fix it.

This is an overview of the biggest changes in this release:

- Complex translucent geometry, such as waterlogged stained glass panes and many types of modded blocks, are now correctly rendered with no measurable performance impact in typical scenarios. We've implemented a quad splitting approach into our translucency sorting solution, resulting in perfect translucency even where it was previously not possible. This provides a significant improvement in graphical fidelity in vanilla and modded scenarios.
- Many aspects of the chunk meshing task system have been updated to work independently of the frame rate. This means even at lower frame rates or with few threads chunks will be meshed without delay or overloading. Our carefully tuned scheduler uses machine learning to improve frame time stability even when loading new chunks.
- Terrain rendering itself has received some optimizations that improve the frame rate for some systems, and when the camera is not moving by using a new per-region cache.
- New optimizations to entity and particle rendering improve performance in heavy scenes.

# New Optimizations and Features

- Added translucency sorting with quad splitting to correctly display intersecting and complex geometry (douira)
- Improved performance of terrain rendering on some systems (combined draw commands) (douira)
- Improved performance of terrain rendering when the camera is not moving (draw batch caching) (douira)
- Improved performance of entity rendering by faster vertex sorting (JellySquid)
- Improved chunk load performance & frame stability by task effort estimation and frame-rate independent task scheduling (douira)
- Improved frame time stability by limiting the uploaded chunks using size estimation (douira)
- Improved performance of particle rendering (MoePus)

# Changes and Fixes

- Reduced unnecessary memory usage in the upload buffer (IMS, douira)
- Optimized and fixed some block models (muzikbike)
- Improved accessibility, correctness, and translatability of the options (MeeniMc, Madis0, contariaa)
- Added debug mode and safety features to prevent and detect off-thread rendering bugs (JellySquid)
- Improved mod compatibility with the sprite animation optimizations (contariaa)

# Other Bugs Fixed

- Fixed small memory leak (JellySquid)
- Fixed some bugs with translucency sorting at large coordinates and with some specific geometry (douira)
- Fixed terrain rendering when the camera is outside the loaded area using bitmap trees (douira)
- Fixed jittery fog animation (cortex, douira)
- Fixed multiple bugs with missed chunk updates and race conditions (douira)

This release brings a variety of performance optimizations, new features, and bug fixes.

We've spent a lot of time developing and testing this release, with some changes having been worked on and tuned for over a year. Thanks to our community members who contributed features and bug fixes to this release! If you are a mod author who finds their mod no longer works with Sodium 0.7, please [open an issue](https://github.com/CaffeineMC/sodium/issues) so that we can work with you to fix it.

This is an overview of the biggest changes in this release:

- Complex translucent geometry, such as waterlogged stained glass panes and many types of modded blocks, are now correctly rendered with no measurable performance impact in typical scenarios. We've implemented a quad splitting approach into our translucency sorting solution, resulting in perfect translucency even where it was previously not possible. This provides a significant improvement in graphical fidelity in vanilla and modded scenarios.
- Many aspects of the chunk meshing task system have been updated to work independently of the frame rate. This means even at lower frame rates or with few threads chunks will be meshed without delay or overloading. Our carefully tuned scheduler uses machine learning to improve frame time stability even when loading new chunks.
- Terrain rendering itself has received some optimizations that improve the frame rate for some systems, and when the camera is not moving by using a new per-region cache.
- New optimizations to entity and particle rendering improve performance in heavy scenes.

# New Optimizations and Features

- Added translucency sorting with quad splitting to correctly display intersecting and complex geometry (douira)
- Improved performance of terrain rendering on some systems (combined draw commands) (douira)
- Improved performance of terrain rendering when the camera is not moving (draw batch caching) (douira)
- Improved performance of entity rendering by faster vertex sorting (JellySquid)
- Improved chunk load performance & frame stability by task effort estimation and frame-rate independent task scheduling (douira)
- Improved frame time stability by limiting the uploaded chunks using size estimation (douira)
- Improved performance of particle rendering (MoePus)

# Changes and Fixes

- Reduced unnecessary memory usage in the upload buffer (IMS, douira)
- Optimized and fixed some block models (muzikbike)
- Improved accessibility, correctness, and translatability of the options (MeeniMc, Madis0, contariaa)
- Added debug mode and safety features to prevent and detect off-thread rendering bugs (JellySquid)
- Improved mod compatibility with the sprite animation optimizations (contariaa)

# Other Bugs Fixed

- Fixed small memory leak (JellySquid)
- Fixed some bugs with translucency sorting at large coordinates and with some specific geometry (douira)
- Fixed terrain rendering when the camera is outside the loaded area using bitmap trees (douira)
- Fixed jittery fog animation (cortex, douira)
- Fixed multiple bugs with missed chunk updates and race conditions (douira)

This release brings a variety of performance optimizations, new features, and bug fixes.

We've spent a lot of time developing and testing this release, with some changes having been worked on and tuned for over a year. Thanks to our community members who contributed features and bug fixes to this release! If you are a mod author who finds their mod no longer works with Sodium 0.7, please [open an issue](https://github.com/CaffeineMC/sodium/issues) so that we can work with you to fix it.

This is an overview of the biggest changes in this release:

- Complex translucent geometry, such as waterlogged stained glass panes and many types of modded blocks, are now correctly rendered with no measurable performance impact in typical scenarios. We've implemented a quad splitting approach into our translucency sorting solution, resulting in perfect translucency even where it was previously not possible. This provides a significant improvement in graphical fidelity in vanilla and modded scenarios.
- Many aspects of the chunk meshing task system have been updated to work independently of the frame rate. This means even at lower frame rates or with few threads chunks will be meshed without delay or overloading. Our carefully tuned scheduler uses machine learning to improve frame time stability even when loading new chunks.
- Terrain rendering itself has received some optimizations that improve the frame rate for some systems, and when the camera is not moving by using a new per-region cache.
- New optimizations to entity and particle rendering improve performance in heavy scenes.

# New Optimizations and Features

- Added translucency sorting with quad splitting to correctly display intersecting and complex geometry (douira)
- Improved performance of terrain rendering on some systems (combined draw commands) (douira)
- Improved performance of terrain rendering when the camera is not moving (draw batch caching) (douira)
- Improved performance of entity rendering by faster vertex sorting (JellySquid)
- Improved chunk load performance & frame stability by task effort estimation and frame-rate independent task scheduling (douira)
- Improved frame time stability by limiting the uploaded chunks using size estimation (douira)
- Improved performance of particle rendering (MoePus)

# Changes and Fixes

- Reduced unnecessary memory usage in the upload buffer (IMS, douira)
- Optimized and fixed some block models (muzikbike)
- Improved accessibility, correctness, and translatability of the options (MeeniMc, Madis0, contariaa)
- Added debug mode and safety features to prevent and detect off-thread rendering bugs (JellySquid)
- Improved mod compatibility with the sprite animation optimizations (contariaa)

# Other Bugs Fixed

- Fixed small memory leak (JellySquid)
- Fixed some bugs with translucency sorting at large coordinates and with some specific geometry (douira)
- Fixed terrain rendering when the camera is outside the loaded area using bitmap trees (douira)
- Fixed jittery fog animation (cortex, douira)
- Fixed multiple bugs with missed chunk updates and race conditions (douira)

**Note:** Due to various performance regressions introduced in Minecraft 1.21.5 (which our team is still investigating), we recommend that players use an older, more stable version of Minecraft if performance is important.

This release is also compatible with Minecraft 1.21.7 and 1.21.8.

---

### Highlights
- Added support for Minecraft 1.21.6.

**Note:** Due to various performance regressions introduced in Minecraft 1.21.5 (which our team is still investigating), we recommend that players use an older, more stable version of Minecraft if performance is important.

This release is also compatible with Minecraft 1.21.7 and 1.21.8.

---

### Highlights
- Added support for Minecraft 1.21.6.

**Note:** This release is marked as _Beta_ due to performance regressions introduced in Minecraft 1.21.5 that our team is still investigating. We recommend that players use an older, more stable version of Minecraft if performance is important.

---

- Improved compatibility with some NeoForge mods that use the Fabric Rendering API.
- Improved compatibility with some Fabric mods when they're used on NeoForge with Sinytra Connector.
- Fixed an incompatibility with _Snow Real Magic!_ and some other mods that would cause holes to appear in the world.
- Fixed an issue with mods that use animated sprites in the user interface which was causing their sprites to not be animated.
- Disabled the use of certain developer options in production which were being modified unnecessarily by other mods.
- Marked PojavLauncher as incompatible due to multiple severe and unresolved issues.
- Marked BetterEnd as incompatible due to it enabling code when Sodium is present that causes frequent and difficult to understand crashes.
- Added a warning for when resource packs try to replace the shaders used by Sodium's improved cloud renderer.

**Note:** This release is marked as _Beta_ due to performance regressions introduced in Minecraft 1.21.5 that our team is still investigating. We recommend that players use an older, more stable version of Minecraft if performance is important.

---

- Improved compatibility with some NeoForge mods that use the Fabric Rendering API.
- Improved compatibility with some Fabric mods when they're used on NeoForge with Sinytra Connector.
- Fixed an incompatibility with _Snow Real Magic!_ and some other mods that would cause holes to appear in the world.
- Fixed an issue with mods that use animated sprites in the user interface which was causing their sprites to not be animated.
- Disabled the use of certain developer options in production which were being modified unnecessarily by other mods.
- Marked PojavLauncher as incompatible due to multiple severe and unresolved issues.
- Marked BetterEnd as incompatible due to it enabling code when Sodium is present that causes frequent and difficult to understand crashes.
- Added a warning for when resource packs try to replace the shaders used by Sodium's improved cloud renderer.

- Improved compatibility with some NeoForge mods that use the Fabric Rendering API.
- Improved compatibility with some Fabric mods when they're used on NeoForge with Sinytra Connector.
- Fixed an incompatibility with _Snow Real Magic!_ and some other mods that would cause holes to appear in the world.
- Fixed an issue with mods that use animated sprites in the user interface which was causing their sprites to not be animated.
- Disabled the use of certain developer options in production which were being modified unnecessarily by other mods.
- Marked PojavLauncher as incompatible due to multiple severe and unresolved issues.
- Marked BetterEnd as incompatible due to it enabling code when Sodium is present that causes frequent and difficult to understand crashes.
- Added a warning for when resource packs try to replace the shaders used by Sodium's improved cloud renderer.

- Improved compatibility with some NeoForge mods that use the Fabric Rendering API.
- Improved compatibility with some Fabric mods when they're used on NeoForge with Sinytra Connector.
- Fixed an incompatibility with _Snow Real Magic!_ and some other mods that would cause holes to appear in the world.
- Fixed an issue with mods that use animated sprites in the user interface which was causing their sprites to not be animated.
- Disabled the use of certain developer options in production which were being modified unnecessarily by other mods.
- Marked PojavLauncher as incompatible due to multiple severe and unresolved issues.
- Marked BetterEnd as incompatible due to it enabling code when Sodium is present that causes frequent and difficult to understand crashes.
- Added a warning for when resource packs try to replace the shaders used by Sodium's improved cloud renderer.

- Improved compatibility with some NeoForge mods that use the Fabric Rendering API.
- Improved compatibility with some Fabric mods when they're used on NeoForge with Sinytra Connector.
- Fixed an incompatibility with _Snow Real Magic!_ and some other mods that would cause holes to appear in the world.
- Fixed an issue with mods that use animated sprites in the user interface which was causing their sprites to not be animated.
- Disabled the use of certain developer options in production which were being modified unnecessarily by other mods.
- Marked PojavLauncher as incompatible due to multiple severe and unresolved issues.
- Marked BetterEnd as incompatible due to it enabling code when Sodium is present that causes frequent and difficult to understand crashes.
- Added a warning for when resource packs try to replace the shaders used by Sodium's improved cloud renderer.

- Improved compatibility with some NeoForge mods that use the Fabric Rendering API.
- Improved compatibility with some Fabric mods when they're used on NeoForge with Sinytra Connector.
- Fixed an incompatibility with _Snow Real Magic!_ and some other mods that would cause holes to appear in the world.
- Fixed an issue with mods that use animated sprites in the user interface which was causing their sprites to not be animated.
- Disabled the use of certain developer options in production which were being modified unnecessarily by other mods.
- Marked PojavLauncher as incompatible due to multiple severe and unresolved issues.
- Marked BetterEnd as incompatible due to it enabling code when Sodium is present that causes frequent and difficult to understand crashes.
- Added a warning for when resource packs try to replace the shaders used by Sodium's improved cloud renderer.

- Improved compatibility with some NeoForge mods that use the Fabric Rendering API.
- Improved compatibility with some Fabric mods when they're used on NeoForge with Sinytra Connector.
- Fixed an incompatibility with _Snow Real Magic!_ and some other mods that would cause holes to appear in the world.
- Fixed an issue with mods that use animated sprites in the user interface which was causing their sprites to not be animated.
- Disabled the use of certain developer options in production which were being modified unnecessarily by other mods.
- Marked PojavLauncher as incompatible due to multiple severe and unresolved issues.
- Marked BetterEnd as incompatible due to it enabling code when Sodium is present that causes frequent and difficult to understand crashes.
- Added a warning for when resource packs try to replace the shaders used by Sodium's improved cloud renderer.

- Improved compatibility with some NeoForge mods that use the Fabric Rendering API.
- Improved compatibility with some Fabric mods when they're used on NeoForge with Sinytra Connector.
- Fixed an incompatibility with _Snow Real Magic!_ and some other mods that would cause holes to appear in the world.
- Fixed an issue with mods that use animated sprites in the user interface which was causing their sprites to not be animated.
- Disabled the use of certain developer options in production which were being modified unnecessarily by other mods.
- Marked PojavLauncher as incompatible due to multiple severe and unresolved issues.
- Marked BetterEnd as incompatible due to it enabling code when Sodium is present that causes frequent and difficult to understand crashes.
- Added a warning for when resource packs try to replace the shaders used by Sodium's improved cloud renderer.

- Fixed an issue that would cause graphical corruption when holding items in some situations.
- Fixed a bug that was causing a very large number of OpenGL errors to be logged to disk.

- Fixed an issue that would cause graphical corruption when holding items in some situations.
- Fixed a bug that was causing a very large number of OpenGL errors to be logged to disk.

This release introduces support for Minecraft 1.21.5. For the time being, this version of Sodium is considered _beta-quality_ while the ecosystem takes some time to stabilize.

This release introduces support for Minecraft 1.21.5. For the time being, this version of Sodium is considered _beta-quality_ while the ecosystem takes some time to stabilize.

This is a stable release which back-ports many fixes and improvements from newer versions of Sodium.

For more information about the (many) changes in this release, please see the change-log for [Sodium 0.5.12 Beta 2](https://modrinth.com/mod/sodium/version/mc1.20.1-0.5.12-beta.2-fabric).

We recommend that players and mod pack authors update to this version, as some changes can significantly improve performance and stability.


## Mod Compatibility

Special care has been taken with this update to ensure mod compatibility is not affected. Most users should be able to upgrade to this release without any issues. However, there are some exceptions for mods that heavily touch the internals of Sodium.

- ⚠️ If using the _Indium_ mod, you must update to version 1.0.36 or newer.
- ⚠️ If using the _Iris_ mod, you must update to version 1.7.6 or newer.

## Highlights

- Fixed a problem that caused some block entities to render as if they were inside out.
- Fixed a problem that caused some mods with custom fluids to render with the incorrect colors.

- Fixed compatibility with NeoForge version 21.4.96-beta and newer.
- Updated Fabric API modules to version 0.118.0.

- Fixed compatibility with NeoForge version 21.4.96-beta and newer.
- Updated Fabric API modules to version 0.118.0.

This version backports many improvements and bug fixes from newer versions of Sodium 0.6. We recommend that players and mod pack authors update to this version, as some changes can significantly improve performance and stability.

## Mod Compatibility

Special care has been taken to minimize the number of breaking changes for other mods, so there should be few issues upgrading to this release for the vast majority of users. However, there are some exceptions:

- ⚠️ If using the _Indium_ mod, you must update to version 1.0.36 or newer.
- ⚠️ If using the _Iris_ mod, you must update to version 1.7.6 or newer.

## Highlights

- The quality of terrain rendering has been significantly improved (adding greater vertex and texture precision). This fixes many issues with special block models, and especially with modded content. With large mod packs or resource packs, there is significantly reduced texture bleeding between blocks when compared to the previous release.
- Virtual memory utilization has been dramatically reduced while loading chunks. This can have a large impact on how quickly chunks are loaded on the client, and on many systems, can reduce the amount of micro-stutter significantly.
- Improved performance on integrated Intel GPUs significantly with additional terrain rendering optimizations (up to 10-15% faster, depending on the render distance) and enhanced framebuffer copies (up to 3-5% faster, regardless of render distance).
- Occlusion culling has been improved slightly, reducing the number of rendered sections by up to 10-15%, especially when using higher render distances.
- All improvements for hardware and driver compatibility from Sodium 0.6+ have been back-ported in this release, helping to improve the user experience considerably.

## Other changes
- Fixed the handling of sub-texel offsets in terrain rendering, which caused texture seams to appear between blocks when very large texture atlases were used (common in large mod packs).
- Fixed a problem where z-fighting would occur with some block overlays, such as emissive textures.
- Fixed the rendering of block models which have quads with different shading modes (i.e. VT's Bushy Leaves, Bray's World...)
- Fixed an issue where some chunks would not render correctly immediately after the projection matrix was changed (such as when putting down a Spyglass.)
- Fixed a bug where very large block entities in nearby chunk sections would be incorrectly culled.
- Startup warnings about incompatible NVIDIA or Intel GPU driver versions will now only be shown if the GPU is actually in use.
- Error messages at startup are more helpful now, especially when showing errors about incompatible graphics drivers.
- Fixed a crash at startup with ARM CPUs on Windows that don't support OpenGL without the use of a translation layer.
- Fixed a bug that prevented the "Help" button in dialog boxes from opening the default web browser on Windows.
- Fixed many issues around the handling of chunks with large amounts of geometry, fixing some rare crashes and graphical issues.
- Added a workaround for users who have installed ASUS GPU Tweak III on their computer, since it causes extremely poor performance and crashes with Minecraft.
- Improved the driver workarounds for NVIDIA GPUs on Windows, potentially improving performance on laptops with hybrid graphics.
- Improved compatibility with some resource packs that use custom shaders in entity rendering.
- Added support for the Sprite Tracking API (originally introduced in Sodium 0.6.9.)

- Fixed the handling of sub-texel offsets in terrain rendering, which caused texture seams to appear between blocks when very large texture atlases were used (common in large mod packs).
- On macOS, fixed an issue that would cause texture seams to frequently appear between most blocks, regardless of what mods or texture packs are used.
- Fixed an issue that caused textures on cross-block models (such as Flowers) and block overlays (such as the side of Grass Blocks) to be misaligned.
- Fixed an issue that caused textures on different faces of the same block to appear misaligned with each other.
- Fixed an issue that caused textures to appear slightly too zoomed-in on some blocks.
- Added a utility class which other mods can use to ensure their animated textures are updated correctly when using custom rendering.
- Other mods should replace their usages of the [internal SpriteUtil](https://github.com/CaffeineMC/sodium/blob/dev/common/src/main/java/net/caffeinemc/mods/sodium/client/render/texture/SpriteUtil.java) with the [public SpriteUtil](https://github.com/CaffeineMC/sodium/blob/dev/common/src/api/java/net/caffeinemc/mods/sodium/api/texture/SpriteUtil.java), as the internal class will be removed in Sodium 0.7.
- Fixed the detection of Intel Xe2 graphics cards (again.)

- Fixed the handling of sub-texel offsets in terrain rendering, which caused texture seams to appear between blocks when very large texture atlases were used (common in large mod packs).
- On macOS, fixed an issue that would cause texture seams to frequently appear between most blocks, regardless of what mods or texture packs are used.
- Fixed an issue that caused textures on cross-block models (such as Flowers) and block overlays (such as the side of Grass Blocks) to be misaligned.
- Fixed an issue that caused textures on different faces of the same block to appear misaligned with each other.
- Fixed an issue that caused textures to appear slightly too zoomed-in on some blocks.
- Added a utility class which other mods can use to ensure their animated textures are updated correctly when using custom rendering.
- Other mods should replace their usages of the [internal SpriteUtil](https://github.com/CaffeineMC/sodium/blob/dev/common/src/main/java/net/caffeinemc/mods/sodium/client/render/texture/SpriteUtil.java) with the [public SpriteUtil](https://github.com/CaffeineMC/sodium/blob/dev/common/src/api/java/net/caffeinemc/mods/sodium/api/texture/SpriteUtil.java), as the internal class will be removed in Sodium 0.7.
- Fixed the detection of Intel Xe2 graphics cards (again.)

- Fixed the handling of sub-texel offsets in terrain rendering, which caused texture seams to appear between blocks when very large texture atlases were used (common in large mod packs).
- On macOS, fixed an issue that would cause texture seams to frequently appear between most blocks, regardless of what mods or texture packs are used.
- Fixed an issue that caused textures on cross-block models (such as Flowers) and block overlays (such as the side of Grass Blocks) to be misaligned.
- Fixed an issue that caused textures on different faces of the same block to appear misaligned with each other.
- Fixed an issue that caused textures to appear slightly too zoomed-in on some blocks.
- Added a utility class which other mods can use to ensure their animated textures are updated correctly when using custom rendering.
- Other mods should replace their usages of the [internal SpriteUtil](https://github.com/CaffeineMC/sodium/blob/dev/common/src/main/java/net/caffeinemc/mods/sodium/client/render/texture/SpriteUtil.java) with the [public SpriteUtil](https://github.com/CaffeineMC/sodium/blob/dev/common/src/api/java/net/caffeinemc/mods/sodium/api/texture/SpriteUtil.java), as the internal class will be removed in Sodium 0.7.
- Fixed the detection of Intel Xe2 graphics cards (again.)

- Fixed the handling of sub-texel offsets in terrain rendering, which caused texture seams to appear between blocks when very large texture atlases were used (common in large mod packs).
- On macOS, fixed an issue that would cause texture seams to frequently appear between most blocks, regardless of what mods or texture packs are used.
- Fixed an issue that caused textures on cross-block models (such as Flowers) and block overlays (such as the side of Grass Blocks) to be misaligned.
- Fixed an issue that caused textures on different faces of the same block to appear misaligned with each other.
- Fixed an issue that caused textures to appear slightly too zoomed-in on some blocks.
- Added a utility class which other mods can use to ensure their animated textures are updated correctly when using custom rendering.
- Other mods should replace their usages of the [internal SpriteUtil](https://github.com/CaffeineMC/sodium/blob/dev/common/src/main/java/net/caffeinemc/mods/sodium/client/render/texture/SpriteUtil.java) with the [public SpriteUtil](https://github.com/CaffeineMC/sodium/blob/dev/common/src/api/java/net/caffeinemc/mods/sodium/api/texture/SpriteUtil.java), as the internal class will be removed in Sodium 0.7.
- Fixed the detection of Intel Xe2 graphics cards (again.)

- Fixed the handling of sub-texel offsets in terrain rendering, which caused texture seams to appear between blocks when very large texture atlases were used (common in large mod packs).
- On macOS, fixed an issue that would cause texture seams to frequently appear between most blocks, regardless of what mods or texture packs are used.
- Fixed an issue that caused textures on cross-block models (such as Flowers) and block overlays (such as the side of Grass Blocks) to be misaligned.
- Fixed an issue that caused textures on different faces of the same block to appear misaligned with each other.
- Fixed an issue that caused textures to appear slightly too zoomed-in on some blocks.
- Added a utility class which other mods can use to ensure their animated textures are updated correctly when using custom rendering.
- Other mods should replace their usages of the [internal SpriteUtil](https://github.com/CaffeineMC/sodium/blob/dev/common/src/main/java/net/caffeinemc/mods/sodium/client/render/texture/SpriteUtil.java) with the [public SpriteUtil](https://github.com/CaffeineMC/sodium/blob/dev/common/src/api/java/net/caffeinemc/mods/sodium/api/texture/SpriteUtil.java), as the internal class will be removed in Sodium 0.7.
- Fixed the detection of Intel Xe2 graphics cards (again.)

- Fixed the handling of sub-texel offsets in terrain rendering, which caused texture seams to appear between blocks when very large texture atlases were used (common in large mod packs).
- On macOS, fixed an issue that would cause texture seams to frequently appear between most blocks, regardless of what mods or texture packs are used.
- Fixed an issue that caused textures on cross-block models (such as Flowers) and block overlays (such as the side of Grass Blocks) to be misaligned.
- Fixed an issue that caused textures on different faces of the same block to appear misaligned with each other.
- Fixed an issue that caused textures to appear slightly too zoomed-in on some blocks.
- Added a utility class which other mods can use to ensure their animated textures are updated correctly when using custom rendering.
- Other mods should replace their usages of the [internal SpriteUtil](https://github.com/CaffeineMC/sodium/blob/dev/common/src/main/java/net/caffeinemc/mods/sodium/client/render/texture/SpriteUtil.java) with the [public SpriteUtil](https://github.com/CaffeineMC/sodium/blob/dev/common/src/api/java/net/caffeinemc/mods/sodium/api/texture/SpriteUtil.java), as the internal class will be removed in Sodium 0.7.
- Fixed the detection of Intel Xe2 graphics cards (again.)

This is a very small release, and only backports a fix for translucency sorting to Minecraft 1.21.3 that was missed in Sodium 0.6.7.

This is a very small release, and only backports a fix for translucency sorting to Minecraft 1.21.3 that was missed in Sodium 0.6.7.

- Fixed a problem where material downgrading would not correctly handle custom block models that use multiple render layers on NeoForge. (i.e. Red Observer in XyCraft.)
- Fixed the handling of custom DelegateBakedModel implementations which also provide their own BakedModel#getQuads implementation, which affected mods like _Framed Blocks_ on Minecraft 1.21.4.
- Fixed certain replacement models (Hoppers, Cauldrons, etc) not using the texture names that mods and resource packs expect.
- Fixed graphical corruption with translucent blocks that would only appear on 32-bit operating systems.
- Improved error diagnostics for a common mod compatibility issue that is causing game crashes.
- Improved compatibility with mods that change behavior of the item renderer.
- Improved compatibility with mods that implement animated sprites using custom logic.
- Added support to the graphics adapter probe for detecting Intel Xe2 graphics.

- Fixed a problem where material downgrading would not correctly handle custom block models that use multiple render layers on NeoForge. (i.e. Red Observer in XyCraft.)
- Fixed the handling of custom DelegateBakedModel implementations which also provide their own BakedModel#getQuads implementation, which affected mods like _Framed Blocks_ on Minecraft 1.21.4.
- Fixed certain replacement models (Hoppers, Cauldrons, etc) not using the texture names that mods and resource packs expect.
- Fixed graphical corruption with translucent blocks that would only appear on 32-bit operating systems.
- Improved error diagnostics for a common mod compatibility issue that is causing game crashes.
- Improved compatibility with mods that change behavior of the item renderer.
- Improved compatibility with mods that implement animated sprites using custom logic.
- Added support to the graphics adapter probe for detecting Intel Xe2 graphics.

- Fixed a problem where material downgrading would not correctly handle custom block models that use multiple render layers on NeoForge. (i.e. Red Observer in XyCraft.)
- Fixed the handling of custom DelegateBakedModel implementations which also provide their own BakedModel#getQuads implementation, which affected mods like _Framed Blocks_ on Minecraft 1.21.4.
- Fixed certain replacement models (Hoppers, Cauldrons, etc) not using the texture names that mods and resource packs expect.
- Fixed graphical corruption with translucent blocks that would only appear on 32-bit operating systems.
- Improved error diagnostics for a common mod compatibility issue that is causing game crashes.
- Improved compatibility with mods that change behavior of the item renderer.
- Improved compatibility with mods that implement animated sprites using custom logic.
- Added support to the graphics adapter probe for detecting Intel Xe2 graphics.

- Fixed a problem where material downgrading would not correctly handle custom block models that use multiple render layers on NeoForge. (i.e. Red Observer in XyCraft.)
- Fixed the handling of custom DelegateBakedModel implementations which also provide their own BakedModel#getQuads implementation, which affected mods like _Framed Blocks_ on Minecraft 1.21.4.
- Fixed certain replacement models (Hoppers, Cauldrons, etc) not using the texture names that mods and resource packs expect.
- Fixed graphical corruption with translucent blocks that would only appear on 32-bit operating systems.
- Improved error diagnostics for a common mod compatibility issue that is causing game crashes.
- Improved compatibility with mods that change behavior of the item renderer.
- Improved compatibility with mods that implement animated sprites using custom logic.
- Added support to the graphics adapter probe for detecting Intel Xe2 graphics.

- Fixed a problem where material downgrading would not correctly handle custom block models that use multiple render layers on NeoForge. (i.e. Red Observer in XyCraft.)
- Fixed the handling of custom DelegateBakedModel implementations which also provide their own BakedModel#getQuads implementation, which affected mods like _Framed Blocks_ on Minecraft 1.21.4.
- Fixed certain replacement models (Hoppers, Cauldrons, etc) not using the texture names that mods and resource packs expect.
- Fixed graphical corruption with translucent blocks that would only appear on 32-bit operating systems.
- Improved error diagnostics for a common mod compatibility issue that is causing game crashes.
- Improved compatibility with mods that change behavior of the item renderer.
- Improved compatibility with mods that implement animated sprites using custom logic.
- Added support to the graphics adapter probe for detecting Intel Xe2 graphics.

- Fixed a problem where material downgrading would not correctly handle custom block models that use multiple render layers on NeoForge. (i.e. Red Observer in XyCraft.)
- Fixed the handling of custom DelegateBakedModel implementations which also provide their own BakedModel#getQuads implementation, which affected mods like _Framed Blocks_ on Minecraft 1.21.4.
- Fixed certain replacement models (Hoppers, Cauldrons, etc) not using the texture names that mods and resource packs expect.
- Fixed graphical corruption with translucent blocks that would only appear on 32-bit operating systems.
- Improved error diagnostics for a common mod compatibility issue that is causing game crashes.
- Improved compatibility with mods that change behavior of the item renderer.
- Improved compatibility with mods that implement animated sprites using custom logic.
- Added support to the graphics adapter probe for detecting Intel Xe2 graphics.

- Fixed a bug that prevented quad transforms from applying to block models. Fixes compatibility with Contiunity.

- Fixed a bug that prevented quad transforms from applying to block models. Fixes compatibility with Contiunity.

This release is a hot fix for a critical issue introduced with Sodium 0.6.4 (published earlier today) that was causing frequent crashes. We have archived the previous release and recommend that all players using Sodium 0.6.4 instead update to this version.

### Sodium 0.6.5
- Fixed a bug that would cause any usage of block or item rendering from entities to immediately crash.

### Sodium 0.6.4
- Fixed a number of bugs with translucency sorting which were caused by the wrong camera coordinates being used in rendering.
- This also fixes rendering bugs with Distant Horizons that were introduced in Sodium 0.6.3.
- Fixed the rendering of block models which have quads with different shading modes (i.e. VT's Bushy Leaves, Bray's World...)
- Fixed a bug that prevented the "Help" button in dialog boxes from opening the default web browser on Windows.
- Improved the rendering of the "Pale Oak Leaves" block in Fast graphics mode.
- ... and some other very minor improvements and changes.

This release is a hot fix for a critical issue introduced with Sodium 0.6.4 (published earlier today) that was causing frequent crashes. We have archived the previous release and recommend that all players using Sodium 0.6.4 instead update to this version.

### Sodium 0.6.5
- Fixed a bug that would cause any usage of block or item rendering from entities to immediately crash.

### Sodium 0.6.4
- Fixed a number of bugs with translucency sorting which were caused by the wrong camera coordinates being used in rendering.
- This also fixes rendering bugs with Distant Horizons that were introduced in Sodium 0.6.3.
- Fixed the rendering of block models which have quads with different shading modes (i.e. VT's Bushy Leaves, Bray's World...)
- Fixed a bug that prevented the "Help" button in dialog boxes from opening the default web browser on Windows.
- Improved the rendering of the "Pale Oak Leaves" block in Fast graphics mode.
- ... and some other very minor improvements and changes.

This release is a hot fix for a critical issue introduced with Sodium 0.6.4 (published earlier today) that was causing frequent crashes. We have archived the previous release and recommend that all players using Sodium 0.6.4 instead update to this version.

### Sodium 0.6.5
- Fixed a bug that would cause any usage of block or item rendering from entities to immediately crash.

### Sodium 0.6.4
- Fixed a number of bugs with translucency sorting which were caused by the wrong camera coordinates being used in rendering.
- This also fixes rendering bugs with Distant Horizons that were introduced in Sodium 0.6.3.
- Fixed the rendering of block models which have quads with different shading modes (i.e. VT's Bushy Leaves, Bray's World...)
- Fixed a bug that prevented the "Help" button in dialog boxes from opening the default web browser on Windows.
- Improved the rendering of the "Pale Oak Leaves" block in Fast graphics mode.
- ... and some other very minor improvements and changes.

This release is a hot fix for a critical issue introduced with Sodium 0.6.4 (published earlier today) that was causing frequent crashes. We have archived the previous release and recommend that all players using Sodium 0.6.4 instead update to this version.

### Sodium 0.6.5
- Fixed a bug that would cause any usage of block or item rendering from entities to immediately crash.

### Sodium 0.6.4
- Fixed a number of bugs with translucency sorting which were caused by the wrong camera coordinates being used in rendering.
- This also fixes rendering bugs with Distant Horizons that were introduced in Sodium 0.6.3.
- Fixed the rendering of block models which have quads with different shading modes (i.e. VT's Bushy Leaves, Bray's World...)
- Fixed a bug that prevented the "Help" button in dialog boxes from opening the default web browser on Windows.
- Improved the rendering of the "Pale Oak Leaves" block in Fast graphics mode.
- ... and some other very minor improvements and changes.

This release is a hot fix for a critical issue introduced with Sodium 0.6.4 (published earlier today) that was causing frequent crashes. We have archived the previous release and recommend that all players using Sodium 0.6.4 instead update to this version.

### Sodium 0.6.5
- Fixed a bug that would cause any usage of block or item rendering from entities to immediately crash.

### Sodium 0.6.4
- Fixed a number of bugs with translucency sorting which were caused by the wrong camera coordinates being used in rendering.
- This also fixes rendering bugs with Distant Horizons that were introduced in Sodium 0.6.3.
- Fixed the rendering of block models which have quads with different shading modes (i.e. VT's Bushy Leaves, Bray's World...)
- Fixed a bug that prevented the "Help" button in dialog boxes from opening the default web browser on Windows.
- Improved the rendering of the "Pale Oak Leaves" block in Fast graphics mode.
- ... and some other very minor improvements and changes.

This release is a hot fix for a critical issue introduced with Sodium 0.6.4 (published earlier today) that was causing frequent crashes. We have archived the previous release and recommend that all players using Sodium 0.6.4 instead update to this version.

### Sodium 0.6.5
- Fixed a bug that would cause any usage of block or item rendering from entities to immediately crash.

### Sodium 0.6.4
- Fixed a number of bugs with translucency sorting which were caused by the wrong camera coordinates being used in rendering.
- This also fixes rendering bugs with Distant Horizons that were introduced in Sodium 0.6.3.
- Fixed the rendering of block models which have quads with different shading modes (i.e. VT's Bushy Leaves, Bray's World...)
- Fixed a bug that prevented the "Help" button in dialog boxes from opening the default web browser on Windows.
- Improved the rendering of the "Pale Oak Leaves" block in Fast graphics mode.
- ... and some other very minor improvements and changes.

- [MC 1.21.4] Fixed compatibility with NeoForge 21.4.3+ Beta
- [MC 1.21.4] Fixed a bug causing font effects (such as italic, bold, underline) and text backgrounds to not render correctly.
- Fixed a number of bugs with fluid rendering that were causing faces to be hidden incorrectly against some modded blocks.
- Fixed detection of Intel graphics cards on Windows, which was causing some important workarounds to not apply.
- Startup warnings about incompatible NVIDIA or Intel GPU driver versions will now only be shown if the GPU is actually in use.

- [MC 1.21.4] Fixed compatibility with NeoForge 21.4.3+ Beta
- [MC 1.21.4] Fixed a bug causing font effects (such as italic, bold, underline) and text backgrounds to not render correctly.
- Fixed a number of bugs with fluid rendering that were causing faces to be hidden incorrectly against some modded blocks.
- Fixed detection of Intel graphics cards on Windows, which was causing some important workarounds to not apply.
- Startup warnings about incompatible NVIDIA or Intel GPU driver versions will now only be shown if the GPU is actually in use.

- [MC 1.21.4] Fixed compatibility with NeoForge 21.4.3+ Beta
- [MC 1.21.4] Fixed a bug causing font effects (such as italic, bold, underline) and text backgrounds to not render correctly.
- Fixed a number of bugs with fluid rendering that were causing faces to be hidden incorrectly against some modded blocks.
- Fixed detection of Intel graphics cards on Windows, which was causing some important workarounds to not apply.
- Startup warnings about incompatible NVIDIA or Intel GPU driver versions will now only be shown if the GPU is actually in use.

- [MC 1.21.4] Fixed compatibility with NeoForge 21.4.3+ Beta
- [MC 1.21.4] Fixed a bug causing font effects (such as italic, bold, underline) and text backgrounds to not render correctly.
- Fixed a number of bugs with fluid rendering that were causing faces to be hidden incorrectly against some modded blocks.
- Fixed detection of Intel graphics cards on Windows, which was causing some important workarounds to not apply.
- Startup warnings about incompatible NVIDIA or Intel GPU driver versions will now only be shown if the GPU is actually in use.

- [MC 1.21.4] Fixed compatibility with NeoForge 21.4.3+ Beta
- [MC 1.21.4] Fixed a bug causing font effects (such as italic, bold, underline) and text backgrounds to not render correctly.
- Fixed a number of bugs with fluid rendering that were causing faces to be hidden incorrectly against some modded blocks.
- Fixed detection of Intel graphics cards on Windows, which was causing some important workarounds to not apply.
- Startup warnings about incompatible NVIDIA or Intel GPU driver versions will now only be shown if the GPU is actually in use.

- [MC 1.21.4] Fixed compatibility with NeoForge 21.4.3+ Beta
- [MC 1.21.4] Fixed a bug causing font effects (such as italic, bold, underline) and text backgrounds to not render correctly.
- Fixed a number of bugs with fluid rendering that were causing faces to be hidden incorrectly against some modded blocks.
- Fixed detection of Intel graphics cards on Windows, which was causing some important workarounds to not apply.
- Startup warnings about incompatible NVIDIA or Intel GPU driver versions will now only be shown if the GPU is actually in use.

- Added support for Minecraft 1.21.4
- Fixed the handling of translucent render layers in item rendering when using the Fabric API
- Updated manifest files to indicate correct versions of Minecraft and NeoForge/Fabric
- Updated list of known-incompatible mods to help users avoid common issues
- Backported support for NeoForge fluid handling APIs to Minecraft 1.21.1

- Added support for Minecraft 1.21.4
- Fixed the handling of translucent render layers in item rendering when using the Fabric API
- Updated manifest files to indicate correct versions of Minecraft and NeoForge/Fabric
- Updated list of known-incompatible mods to help users avoid common issues
- Backported support for NeoForge fluid handling APIs to Minecraft 1.21.1

- Added support for Minecraft 1.21.4
- Fixed the handling of translucent render layers in item rendering when using the Fabric API
- Updated manifest files to indicate correct versions of Minecraft and NeoForge/Fabric
- Updated list of known-incompatible mods to help users avoid common issues
- Backported support for NeoForge fluid handling APIs to Minecraft 1.21.1

- Added support for Minecraft 1.21.4
- Fixed the handling of translucent render layers in item rendering when using the Fabric API
- Updated manifest files to indicate correct versions of Minecraft and NeoForge/Fabric
- Updated list of known-incompatible mods to help users avoid common issues
- Backported support for NeoForge fluid handling APIs to Minecraft 1.21.1

- Added support for Minecraft 1.21.4
- Fixed the handling of translucent render layers in item rendering when using the Fabric API
- Updated manifest files to indicate correct versions of Minecraft and NeoForge/Fabric
- Updated list of known-incompatible mods to help users avoid common issues
- Backported support for NeoForge fluid handling APIs to Minecraft 1.21.1

- Added support for Minecraft 1.21.4
- Fixed the handling of translucent render layers in item rendering when using the Fabric API
- Updated manifest files to indicate correct versions of Minecraft and NeoForge/Fabric
- Updated list of known-incompatible mods to help users avoid common issues
- Backported support for NeoForge fluid handling APIs to Minecraft 1.21.1

This release fixes a number of issues in Sodium 0.6.0, and it is recommended that all players install this update.

- Improved the driver workarounds for NVIDIA GPUs on Windows, potentially improving performance on laptops with hybrid graphics.
- Improved the occlusion culling code so that it can be skipped when chunk updates do not modify the connected-ness of chunk sections, improving performance slightly in some scenarios.
- Fixed a bug where clouds would render incorrectly (on the wrong framebuffer) when _Fabulous!_ mode is used.
- Fixed a bug with color blending that would cause some animated textures to flicker or render incorrectly, especially with shader packs.
- Fixed some issues with translucent block rendering that could occur due to draw calls not being correctly sorted.
- Fixed a bug where very large block entities in nearby chunk sections would be incorrectly culled.
- Added optimized block models for Cauldrons, Brewing Stands, and Bells.

This release fixes a number of issues in Sodium 0.6.0, and it is recommended that all players install this update.

- Improved the driver workarounds for NVIDIA GPUs on Windows, potentially improving performance on laptops with hybrid graphics.
- Improved the occlusion culling code so that it can be skipped when chunk updates do not modify the connected-ness of chunk sections, improving performance slightly in some scenarios.
- Fixed a bug where clouds would render incorrectly (on the wrong framebuffer) when _Fabulous!_ mode is used.
- Fixed a bug with color blending that would cause some animated textures to flicker or render incorrectly, especially with shader packs.
- Fixed some issues with translucent block rendering that could occur due to draw calls not being correctly sorted.
- Fixed a bug where very large block entities in nearby chunk sections would be incorrectly culled.
- Added optimized block models for Cauldrons, Brewing Stands, and Bells.

This release fixes a number of issues in Sodium 0.6.0, and it is recommended that all players install this update.

- Improved the driver workarounds for NVIDIA GPUs on Windows, potentially improving performance on laptops with hybrid graphics.
- Improved the occlusion culling code so that it can be skipped when chunk updates do not modify the connected-ness of chunk sections, improving performance slightly in some scenarios.
- Fixed a bug where clouds would render incorrectly (on the wrong framebuffer) when _Fabulous!_ mode is used.
- Fixed a bug with color blending that would cause some animated textures to flicker or render incorrectly, especially with shader packs.
- Fixed some issues with translucent block rendering that could occur due to draw calls not being correctly sorted.
- Fixed a bug where very large block entities in nearby chunk sections would be incorrectly culled.
- Added optimized block models for Cauldrons, Brewing Stands, and Bells.

This release fixes a number of issues in Sodium 0.6.0, and it is recommended that all players install this update.

- Improved the driver workarounds for NVIDIA GPUs on Windows, potentially improving performance on laptops with hybrid graphics.
- Improved the occlusion culling code so that it can be skipped when chunk updates do not modify the connected-ness of chunk sections, improving performance slightly in some scenarios.
- Fixed a bug where clouds would render incorrectly (on the wrong framebuffer) when _Fabulous!_ mode is used.
- Fixed a bug with color blending that would cause some animated textures to flicker or render incorrectly, especially with shader packs.
- Fixed some issues with translucent block rendering that could occur due to draw calls not being correctly sorted.
- Fixed a bug where very large block entities in nearby chunk sections would be incorrectly culled.
- Added optimized block models for Cauldrons, Brewing Stands, and Bells.

This is the largest update to Sodium since the initial release! There are a countless number of improvements for mod compatibility and hundreds of bugs and other issues have been resolved. Additionally, we managed to pack some new performance optimizations into this release.

## Key highlights of this release

- **This is the first multi-loader release for both NeoForge _and_ Fabric!** Yes, seriously!
- In the long-term, this means that users and mod authors will no longer need to rely on third-party forks of Sodium (Rubidium, Embeddium, Xenon, etc). This will greatly reduce friction for everyone, and improve the overall user experience significantly.
- We are working with mod authors as quickly as possible to implement additional APIs to improve mod compatibility with this version. Where possible, we will try to submit patches upstream to other mods to minimize the effort needed. If you are a mod author who finds their mod no longer works with Sodium 0.6, please [open an issue](<https://github.com/CaffeineMC/sodium-fabric/issues>) so that we can work with you to fix it.
- **The Fabric Rendering API (FRAPI) is now supported out of the box!** This greatly improves mod compatibility, and makes it so mods like _Indium_ are no longer necessary. We've worked with individuals in the Fabric team and other mod authors to make sure our implementation works correctly, and have done comprehensive testing to ensure other mods behave correctly with our implementation. (That said, if you find a bug with it as a mod author, please let us know.)
- **Major improvements for translucent blocks!** You know the long-standing issues with stained glass and other blocks, and how they don't quite look right? We're happy to announce those issues are no more. This means that translucent blocks will look great-- much better than Vanilla even-- with almost no performance impact. (This achievement would not have been possible without the effort of [Douira](https://douira.dev/). This was such a complex issue that it became the subject of their master's thesis.)

## Improvements and new optimizations

- Occlusion culling has been improved slightly, reducing the number of rendered sections by up to 10-15% when using higher render distances.
- Added a new optimization called "Material Downgrading" which moves some terrain geometry to a simpler render pass when the texture is not transparent or translucent. This can improve terrain rendering performance slightly, and sometimes much more with certain mods or resource packs.
- The quality of terrain rendering has been greatly improved (greater vertex/texture precision), fixing many issues with special block models.
- Added a handful of optimizations to Minecraft's block models, which can slightly improve performance in complex worlds.
- Improved performance on integrated Intel GPUs by up to 10-15% with additional terrain rendering optimizations.
- The graphical fidelity and performance of cloud rendering has been improved significantly.
- Greatly reduced virtual memory utilization while loading chunks. This should also help improve how quickly chunks are loaded on the client.
- Many fixes for handling worlds with a large amount of geometry.
- Error messages at startup are more helpful now, especially when showing errors about incompatible graphics drivers.
- Added an option to the Video Settings screen for controlling the Fullscreen Resolution. (This is currently only available on Windows.)
- Minor code quality and performance improvements for color mixing/swizzling functions used in various parts of the renderer.
- The rendering of some options in the video settings menu has been slightly improved.
- Improved the performance of the box blurs used in biome color blending, making the higher values for the biome blend option less expensive.

## Fixes for mod compatibility

- Added support for modifying the alpha component of vertex colors in terrain rendering, as used by some mods.
- Fixed an issue where mods relying on FREX Flawless Frames (such as ReplayMod) would have a one-frame delay before chunks were rendered to the screen.
- Fixed a crash with Immersive Engineering when block entities attempt to render particles.
- Fixed compatibility with some mods that modify biome colors on NeoForge (i.e. Polytone.)
- Fixed compatibility with mods that render their block entities on a glowing render pass.
- Improved compatibility with mods that use custom fluid renderers.
- Improved compatibility with mods that use custom biome colors.
- Improved compatibility with mods that extend the entity renderer.
- Improved compatibility with some resource packs that use custom shaders in entity rendering.
- Added support for the FREX Flawless Frame API on NeoForge.
- Added an API for mods that need to conditionally render block entities (i.e. Flywheel.)
- Fixed a cryptic crash relating to the PoseStack that can happen when mods render items using the Fabric APIs.

## Other bugs fixed in this release

- Fixed a bug that would cause z-fighting between fluids and some special blocks (such as Stairs and Slabs.)
- Fixed a crash at startup with ARM CPUs on Windows that don't support OpenGL without the use of a translation layer.
- Fixed an issue where some chunks would not render correctly immediately after the projection matrix was changed (such as when putting down a Spyglass.)
- Fixed a problem where animated textures would stop animating, especially when some other mods were installed.
- Fixed a problem where z-fighting would occur with some block overlays, such as emissive textures.
- Fixed a problem that caused clouds to render as fully opaque.
- Fixed a regression that was causing clouds to only render at a short distance.
- Fixed a bug that would cause clouds to render with the wrong colors at specific times of day and with specific camera angles.
- Fixed tooltips being cutoff in the Video Settings menu when the effective window size is very small.
- Fixed a bug where clouds may not render their bottom faces at specific camera angles.
- Added a workaround for users who have installed ASUS GPU Tweak III on their computer, since it causes extremely poor performance and crashes with Minecraft.

This is the largest update to Sodium since the initial release! There are a countless number of improvements for mod compatibility and hundreds of bugs and other issues have been resolved. Additionally, we managed to pack some new performance optimizations into this release.

## Key highlights of this release

- **This is the first multi-loader release for both NeoForge _and_ Fabric!** Yes, seriously!
- In the long-term, this means that users and mod authors will no longer need to rely on third-party forks of Sodium (Rubidium, Embeddium, Xenon, etc). This will greatly reduce friction for everyone, and improve the overall user experience significantly.
- We are working with mod authors as quickly as possible to implement additional APIs to improve mod compatibility with this version. Where possible, we will try to submit patches upstream to other mods to minimize the effort needed. If you are a mod author who finds their mod no longer works with Sodium 0.6, please [open an issue](<https://github.com/CaffeineMC/sodium-fabric/issues>) so that we can work with you to fix it.
- **The Fabric Rendering API (FRAPI) is now supported out of the box!** This greatly improves mod compatibility, and makes it so mods like _Indium_ are no longer necessary. We've worked with individuals in the Fabric team and other mod authors to make sure our implementation works correctly, and have done comprehensive testing to ensure other mods behave correctly with our implementation. (That said, if you find a bug with it as a mod author, please let us know.)
- **Major improvements for translucent blocks!** You know the long-standing issues with stained glass and other blocks, and how they don't quite look right? We're happy to announce those issues are no more. This means that translucent blocks will look great-- much better than Vanilla even-- with almost no performance impact. (This achievement would not have been possible without the effort of [Douira](https://douira.dev/). This was such a complex issue that it became the subject of their master's thesis.)

## Improvements and new optimizations

- Occlusion culling has been improved slightly, reducing the number of rendered sections by up to 10-15% when using higher render distances.
- Added a new optimization called "Material Downgrading" which moves some terrain geometry to a simpler render pass when the texture is not transparent or translucent. This can improve terrain rendering performance slightly, and sometimes much more with certain mods or resource packs.
- The quality of terrain rendering has been greatly improved (greater vertex/texture precision), fixing many issues with special block models.
- Added a handful of optimizations to Minecraft's block models, which can slightly improve performance in complex worlds.
- Improved performance on integrated Intel GPUs by up to 10-15% with additional terrain rendering optimizations.
- The graphical fidelity and performance of cloud rendering has been improved significantly.
- Greatly reduced virtual memory utilization while loading chunks. This should also help improve how quickly chunks are loaded on the client.
- Many fixes for handling worlds with a large amount of geometry.
- Error messages at startup are more helpful now, especially when showing errors about incompatible graphics drivers.
- Added an option to the Video Settings screen for controlling the Fullscreen Resolution. (This is currently only available on Windows.)
- Minor code quality and performance improvements for color mixing/swizzling functions used in various parts of the renderer.
- The rendering of some options in the video settings menu has been slightly improved.
- Improved the performance of the box blurs used in biome color blending, making the higher values for the biome blend option less expensive.

## Fixes for mod compatibility

- Added support for modifying the alpha component of vertex colors in terrain rendering, as used by some mods.
- Fixed an issue where mods relying on FREX Flawless Frames (such as ReplayMod) would have a one-frame delay before chunks were rendered to the screen.
- Fixed a crash with Immersive Engineering when block entities attempt to render particles.
- Fixed compatibility with some mods that modify biome colors on NeoForge (i.e. Polytone.)
- Fixed compatibility with mods that render their block entities on a glowing render pass.
- Improved compatibility with mods that use custom fluid renderers.
- Improved compatibility with mods that use custom biome colors.
- Improved compatibility with mods that extend the entity renderer.
- Improved compatibility with some resource packs that use custom shaders in entity rendering.
- Added support for the FREX Flawless Frame API on NeoForge.
- Added an API for mods that need to conditionally render block entities (i.e. Flywheel.)
- Fixed a cryptic crash relating to the PoseStack that can happen when mods render items using the Fabric APIs.

## Other bugs fixed in this release

- Fixed a bug that would cause z-fighting between fluids and some special blocks (such as Stairs and Slabs.)
- Fixed a crash at startup with ARM CPUs on Windows that don't support OpenGL without the use of a translation layer.
- Fixed an issue where some chunks would not render correctly immediately after the projection matrix was changed (such as when putting down a Spyglass.)
- Fixed a problem where animated textures would stop animating, especially when some other mods were installed.
- Fixed a problem where z-fighting would occur with some block overlays, such as emissive textures.
- Fixed a problem that caused clouds to render as fully opaque.
- Fixed a regression that was causing clouds to only render at a short distance.
- Fixed a bug that would cause clouds to render with the wrong colors at specific times of day and with specific camera angles.
- Fixed tooltips being cutoff in the Video Settings menu when the effective window size is very small.
- Fixed a bug where clouds may not render their bottom faces at specific camera angles.
- Added a workaround for users who have installed ASUS GPU Tweak III on their computer, since it causes extremely poor performance and crashes with Minecraft.

This is the largest update to Sodium since the initial release! There are a countless number of improvements for mod compatibility and hundreds of bugs and other issues have been resolved. Additionally, we managed to pack some new performance optimizations into this release.

## Key highlights of this release

- **This is the first multi-loader release for both NeoForge _and_ Fabric!** Yes, seriously!
- In the long-term, this means that users and mod authors will no longer need to rely on third-party forks of Sodium (Rubidium, Embeddium, Xenon, etc). This will greatly reduce friction for everyone, and improve the overall user experience significantly.
- We are working with mod authors as quickly as possible to implement additional APIs to improve mod compatibility with this version. Where possible, we will try to submit patches upstream to other mods to minimize the effort needed. If you are a mod author who finds their mod no longer works with Sodium 0.6, please [open an issue](<https://github.com/CaffeineMC/sodium-fabric/issues>) so that we can work with you to fix it.
- **The Fabric Rendering API (FRAPI) is now supported out of the box!** This greatly improves mod compatibility, and makes it so mods like _Indium_ are no longer necessary. We've worked with individuals in the Fabric team and other mod authors to make sure our implementation works correctly, and have done comprehensive testing to ensure other mods behave correctly with our implementation. (That said, if you find a bug with it as a mod author, please let us know.)
- **Major improvements for translucent blocks!** You know the long-standing issues with stained glass and other blocks, and how they don't quite look right? We're happy to announce those issues are no more. This means that translucent blocks will look great-- much better than Vanilla even-- with almost no performance impact. (This achievement would not have been possible without the effort of [Douira](https://douira.dev/). This was such a complex issue that it became the subject of their master's thesis.)

## Improvements and new optimizations

- Occlusion culling has been improved slightly, reducing the number of rendered sections by up to 10-15% when using higher render distances.
- Added a new optimization called "Material Downgrading" which moves some terrain geometry to a simpler render pass when the texture is not transparent or translucent. This can improve terrain rendering performance slightly, and sometimes much more with certain mods or resource packs.
- The quality of terrain rendering has been greatly improved (greater vertex/texture precision), fixing many issues with special block models.
- Added a handful of optimizations to Minecraft's block models, which can slightly improve performance in complex worlds.
- Improved performance on integrated Intel GPUs by up to 10-15% with additional terrain rendering optimizations.
- The graphical fidelity and performance of cloud rendering has been improved significantly.
- Greatly reduced virtual memory utilization while loading chunks. This should also help improve how quickly chunks are loaded on the client.
- Many fixes for handling worlds with a large amount of geometry.
- Error messages at startup are more helpful now, especially when showing errors about incompatible graphics drivers.
- Added an option to the Video Settings screen for controlling the Fullscreen Resolution. (This is currently only available on Windows.)
- Minor code quality and performance improvements for color mixing/swizzling functions used in various parts of the renderer.
- The rendering of some options in the video settings menu has been slightly improved.
- Improved the performance of the box blurs used in biome color blending, making the higher values for the biome blend option less expensive.

## Fixes for mod compatibility

- Added support for modifying the alpha component of vertex colors in terrain rendering, as used by some mods.
- Fixed an issue where mods relying on FREX Flawless Frames (such as ReplayMod) would have a one-frame delay before chunks were rendered to the screen.
- Fixed a crash with Immersive Engineering when block entities attempt to render particles.
- Fixed compatibility with some mods that modify biome colors on NeoForge (i.e. Polytone.)
- Fixed compatibility with mods that render their block entities on a glowing render pass.
- Improved compatibility with mods that use custom fluid renderers.
- Improved compatibility with mods that use custom biome colors.
- Improved compatibility with mods that extend the entity renderer.
- Improved compatibility with some resource packs that use custom shaders in entity rendering.
- Added support for the FREX Flawless Frame API on NeoForge.
- Added an API for mods that need to conditionally render block entities (i.e. Flywheel.)
- Fixed a cryptic crash relating to the PoseStack that can happen when mods render items using the Fabric APIs.

## Other bugs fixed in this release

- Fixed a bug that would cause z-fighting between fluids and some special blocks (such as Stairs and Slabs.)
- Fixed a crash at startup with ARM CPUs on Windows that don't support OpenGL without the use of a translation layer.
- Fixed an issue where some chunks would not render correctly immediately after the projection matrix was changed (such as when putting down a Spyglass.)
- Fixed a problem where animated textures would stop animating, especially when some other mods were installed.
- Fixed a problem where z-fighting would occur with some block overlays, such as emissive textures.
- Fixed a problem that caused clouds to render as fully opaque.
- Fixed a regression that was causing clouds to only render at a short distance.
- Fixed a bug that would cause clouds to render with the wrong colors at specific times of day and with specific camera angles.
- Fixed tooltips being cutoff in the Video Settings menu when the effective window size is very small.
- Fixed a bug where clouds may not render their bottom faces at specific camera angles.
- Added a workaround for users who have installed ASUS GPU Tweak III on their computer, since it causes extremely poor performance and crashes with Minecraft.

This is the largest update to Sodium since the initial release! There are a countless number of improvements for mod compatibility and hundreds of bugs and other issues have been resolved. Additionally, we managed to pack some new performance optimizations into this release.

## Key highlights of this release

- **This is the first multi-loader release for both NeoForge _and_ Fabric!** Yes, seriously!
- In the long-term, this means that users and mod authors will no longer need to rely on third-party forks of Sodium (Rubidium, Embeddium, Xenon, etc). This will greatly reduce friction for everyone, and improve the overall user experience significantly.
- We are working with mod authors as quickly as possible to implement additional APIs to improve mod compatibility with this version. Where possible, we will try to submit patches upstream to other mods to minimize the effort needed. If you are a mod author who finds their mod no longer works with Sodium 0.6, please [open an issue](<https://github.com/CaffeineMC/sodium-fabric/issues>) so that we can work with you to fix it.
- **The Fabric Rendering API (FRAPI) is now supported out of the box!** This greatly improves mod compatibility, and makes it so mods like _Indium_ are no longer necessary. We've worked with individuals in the Fabric team and other mod authors to make sure our implementation works correctly, and have done comprehensive testing to ensure other mods behave correctly with our implementation. (That said, if you find a bug with it as a mod author, please let us know.)
- **Major improvements for translucent blocks!** You know the long-standing issues with stained glass and other blocks, and how they don't quite look right? We're happy to announce those issues are no more. This means that translucent blocks will look great-- much better than Vanilla even-- with almost no performance impact. (This achievement would not have been possible without the effort of [Douira](https://douira.dev/). This was such a complex issue that it became the subject of their master's thesis.)

## Improvements and new optimizations

- Occlusion culling has been improved slightly, reducing the number of rendered sections by up to 10-15% when using higher render distances.
- Added a new optimization called "Material Downgrading" which moves some terrain geometry to a simpler render pass when the texture is not transparent or translucent. This can improve terrain rendering performance slightly, and sometimes much more with certain mods or resource packs.
- The quality of terrain rendering has been greatly improved (greater vertex/texture precision), fixing many issues with special block models.
- Added a handful of optimizations to Minecraft's block models, which can slightly improve performance in complex worlds.
- Improved performance on integrated Intel GPUs by up to 10-15% with additional terrain rendering optimizations.
- The graphical fidelity and performance of cloud rendering has been improved significantly.
- Greatly reduced virtual memory utilization while loading chunks. This should also help improve how quickly chunks are loaded on the client.
- Many fixes for handling worlds with a large amount of geometry.
- Error messages at startup are more helpful now, especially when showing errors about incompatible graphics drivers.
- Added an option to the Video Settings screen for controlling the Fullscreen Resolution. (This is currently only available on Windows.)
- Minor code quality and performance improvements for color mixing/swizzling functions used in various parts of the renderer.
- The rendering of some options in the video settings menu has been slightly improved.
- Improved the performance of the box blurs used in biome color blending, making the higher values for the biome blend option less expensive.

## Fixes for mod compatibility

- Added support for modifying the alpha component of vertex colors in terrain rendering, as used by some mods.
- Fixed an issue where mods relying on FREX Flawless Frames (such as ReplayMod) would have a one-frame delay before chunks were rendered to the screen.
- Fixed a crash with Immersive Engineering when block entities attempt to render particles.
- Fixed compatibility with some mods that modify biome colors on NeoForge (i.e. Polytone.)
- Fixed compatibility with mods that render their block entities on a glowing render pass.
- Improved compatibility with mods that use custom fluid renderers.
- Improved compatibility with mods that use custom biome colors.
- Improved compatibility with mods that extend the entity renderer.
- Improved compatibility with some resource packs that use custom shaders in entity rendering.
- Added support for the FREX Flawless Frame API on NeoForge.
- Added an API for mods that need to conditionally render block entities (i.e. Flywheel.)
- Fixed a cryptic crash relating to the PoseStack that can happen when mods render items using the Fabric APIs.

## Other bugs fixed in this release

- Fixed a bug that would cause z-fighting between fluids and some special blocks (such as Stairs and Slabs.)
- Fixed a crash at startup with ARM CPUs on Windows that don't support OpenGL without the use of a translation layer.
- Fixed an issue where some chunks would not render correctly immediately after the projection matrix was changed (such as when putting down a Spyglass.)
- Fixed a problem where animated textures would stop animating, especially when some other mods were installed.
- Fixed a problem where z-fighting would occur with some block overlays, such as emissive textures.
- Fixed a problem that caused clouds to render as fully opaque.
- Fixed a regression that was causing clouds to only render at a short distance.
- Fixed a bug that would cause clouds to render with the wrong colors at specific times of day and with specific camera angles.
- Fixed tooltips being cutoff in the Video Settings menu when the effective window size is very small.
- Fixed a bug where clouds may not render their bottom faces at specific camera angles.
- Added a workaround for users who have installed ASUS GPU Tweak III on their computer, since it causes extremely poor performance and crashes with Minecraft.

- Fixed a cryptic crash relating to the PoseStack that can happen when mods render items using the Fabric APIs.
- Fixed a bug that would cause clouds to render with the wrong colors at specific times of day and with specific camera angles.
- Fixed a bug where clouds may not render their bottom faces at specific camera angles.
- Minor code quality and performance improvements for color mixing/swizzling functions used in various parts of the renderer.
- Improved the performance of the box blurs used in biome color blending, making the higher values for the biome blend option less expensive.

- Fixed a cryptic crash relating to the PoseStack that can happen when mods render items using the Fabric APIs.
- Fixed a bug that would cause clouds to render with the wrong colors at specific times of day and with specific camera angles.
- Fixed a bug where clouds may not render their bottom faces at specific camera angles.
- Minor code quality and performance improvements for color mixing/swizzling functions used in various parts of the renderer.
- Improved the performance of the box blurs used in biome color blending, making the higher values for the biome blend option less expensive.

- Fixed a problem with older Intel GPUs that would cause Z-fighting with block overlays.
- Fixed a crash with Immersive Engineering when block entities attempt to render particles.
- Added a handful of optimizations to Minecraft's block models, which can slightly improve performance in complex worlds.
- Improved translucency sorting for special block models with rotated cuboids.
- Fixed a problem that caused clouds to render as fully opaque.
- Fixed a regression that was causing clouds to only render at a short distance.
- Fixed tooltips being cutoff in the Video Settings menu when the effective window size is very small.
- Fixed warnings at startup about missing refmaps.

- Fixed a problem with older Intel GPUs that would cause Z-fighting with block overlays.
- Fixed a crash with Immersive Engineering when block entities attempt to render particles.
- Added a handful of optimizations to Minecraft's block models, which can slightly improve performance in complex worlds.
- Improved translucency sorting for special block models with rotated cuboids.
- Fixed a problem that caused clouds to render as fully opaque.
- Fixed a regression that was causing clouds to only render at a short distance.
- Fixed tooltips being cutoff in the Video Settings menu when the effective window size is very small.
- Fixed warnings at startup about missing refmaps.

- Fixed a problem with older Intel GPUs that would cause Z-fighting with block overlays.
- Fixed a crash with Immersive Engineering when block entities attempt to render particles.
- Added a handful of optimizations to Minecraft's block models, which can slightly improve performance in complex worlds.
- Improved translucency sorting for special block models with rotated cuboids.
- Fixed a problem that caused clouds to render as fully opaque.
- Fixed a regression that was causing clouds to only render at a short distance.
- Fixed tooltips being cutoff in the Video Settings menu when the effective window size is very small.
- Fixed warnings at startup about missing refmaps.

- Fixed a problem with older Intel GPUs that would cause Z-fighting with block overlays.
- Fixed a crash with Immersive Engineering when block entities attempt to render particles.
- Added a handful of optimizations to Minecraft's block models, which can slightly improve performance in complex worlds.
- Improved translucency sorting for special block models with rotated cuboids.
- Fixed a problem that caused clouds to render as fully opaque.
- Fixed a regression that was causing clouds to only render at a short distance.
- Fixed tooltips being cutoff in the Video Settings menu when the effective window size is very small.
- Fixed warnings at startup about missing refmaps.

This update contains some minor performance and compatibility improvements, alongside adding support for Minecraft 1.21.2 and 1.21.3.

- Occlusion culling has been improved slightly, reducing the number of rendered sections by up to 10-15% when using higher render distances.
- Greatly reduced virtual memory utilization while loading chunks. This should also help improve how quickly chunks are loaded on the client.
- Many fixes for handling worlds with a large amount of geometry.
- Improved compatibility with some resource packs that use custom shaders in entity rendering.
- Added support for the FREX Flawless Frame API on NeoForge.
- Marked the mod as client-side only on NeoForge so that it is not (uselessly) loaded on servers.
- Improved some error diagnostics shown in the log file.

This update contains some minor performance and compatibility improvements, alongside adding support for Minecraft 1.21.2 and 1.21.3.

- Occlusion culling has been improved slightly, reducing the number of rendered sections by up to 10-15% when using higher render distances.
- Greatly reduced virtual memory utilization while loading chunks. This should also help improve how quickly chunks are loaded on the client.
- Many fixes for handling worlds with a large amount of geometry.
- Improved compatibility with some resource packs that use custom shaders in entity rendering.
- Added support for the FREX Flawless Frame API on NeoForge.
- Marked the mod as client-side only on NeoForge so that it is not (uselessly) loaded on servers.
- Improved some error diagnostics shown in the log file.

- Improved performance on integrated Intel GPUs by up to 10-15% with additional terrain rendering optimizations.
- Added a new optimization called "Material Downgrading" which moves some terrain geometry to a simpler render pass when the texture is not transparent or translucent. This can improve terrain rendering performance slightly, and sometimes much more with certain mods or resource packs.
- Added an option to the Video Settings screen for controlling the Fullscreen Resolution. (This is currently only available on Windows.)
- The game no longer crashes at startup instead of showing an error pop-up mesage on NeoForge.
- Fixed a problem where animated textures would stop animating, especially when some other mods were installed.
- Fixed a problem where z-fighting would occur with some block overlays, such as emissive textures.
- Fixed a frequent crash when unfocusing the game window or switching between applications on older Intel GPUs.
- Fixed a bug that would cause mixin overrides from mods to not apply.
- Fixed compatibility with some mods that modify biome colors on NeoForge (i.e. Polytone.)
- Fixed compatibility with mods that render their block entities on a glowing render pass.
- Added an API for mods that need to conditionally render block entities (i.e. Flywheel.)

- Improved performance on integrated Intel GPUs by up to 10-15% with additional terrain rendering optimizations.
- Added a new optimization called "Material Downgrading" which moves some terrain geometry to a simpler render pass when the texture is not transparent or translucent. This can improve terrain rendering performance slightly, and sometimes much more with certain mods or resource packs.
- Added an option to the Video Settings screen for controlling the Fullscreen Resolution. (This is currently only available on Windows.)
- The game no longer crashes at startup instead of showing an error pop-up mesage on NeoForge.
- Fixed a problem where animated textures would stop animating, especially when some other mods were installed.
- Fixed a problem where z-fighting would occur with some block overlays, such as emissive textures.
- Fixed a frequent crash when unfocusing the game window or switching between applications on older Intel GPUs.
- Fixed a bug that would cause mixin overrides from mods to not apply.
- Fixed compatibility with some mods that modify biome colors on NeoForge (i.e. Polytone.)
- Fixed compatibility with mods that render their block entities on a glowing render pass.
- Added an API for mods that need to conditionally render block entities (i.e. Flywheel.)

This version contains a countless number of improvements and bug fixes, and is the largest update to Sodium since the initial release.

## Highlights
- **This is the first multi-loader release for both NeoForge _and_ Fabric!** Yes, seriously!
- In the long-term, this means that users and mod authors will no longer need to rely on third-party forks of Sodium (Rubidium, Embeddium, Xenon, etc). This will greatly reduce friction for everyone, and improve the overall user experience significantly.
- We are working with mod authors as quickly as possible to implement additional APIs to improve mod compatibility with this version. Where possible, we will try to submit patches upstream to other mods to minimize the effort needed. If you are a mod author who finds their mod no longer works with Sodium 0.6, please [open an issue](<https://github.com/CaffeineMC/sodium-fabric/issues>) so that we can work with you to fix it.
- **The Fabric Rendering API (FRAPI) is now supported out of the box!** This greatly improves mod compatibility, and makes it so mods like _Indium_ are no longer necessary. We've worked with individuals in the Fabric team and other mod authors to make sure our implementation works correctly, and have done comprehensive testing to ensure other mods behave correctly with our implementation. (That said, if you find a bug with it as a mod author, please let us know.)
- **Major improvements for translucent blocks!** You know the long-standing issues with stained glass and other blocks, and how they don't quite look right? We're happy to announce those issues are no more. This means that translucent blocks will look great-- much better than Vanilla even-- with almost no performance impact. (This achievement would not have been possible without the effort of [Douira](https://douira.dev/). This was such a complex issue that it became the subject of their master's thesis.)

## Other changes
- The quality of terrain rendering has been greatly improved (greater vertex/texture precision), fixing many issues with special block models.
- The graphical fidelity and performance of cloud rendering has been improved significantly.
- Error messages at startup are more helpful now, especially when showing errors about incompatible graphics drivers.
- Reduced the overhead of framebuffer copies, improving performance slightly on integrated graphics.
- Fixed a bug that would cause z-fighting between fluids and some special blocks (such as Stairs and Slabs.)
- Added support for modifying the alpha component of vertex colors in terrain rendering, as used by some mods.
- Improved compatibility with mods that use custom fluid renderers.
- Improved compatibility with mods that use custom biome colors.
- Improved compatibility with mods that extend the entity renderer.
- Fixed an issue where some chunks would not render correctly immediately after the projection matrix was changed (such as when putting down a Spyglass.)
- Fixed an issue where mods relying on FREX Flawless Frames (such as ReplayMod) would have a one-frame delay before chunks were rendered to the screen.
- Added a workaround for users who have installed ASUS GPU Tweak III on their computer, since it causes extremely poor performance and crashes with Minecraft.
- Fixed a crash at startup with ARM CPUs on Windows that don't support OpenGL without the use of a translation layer.
- The rendering of some options in the video settings menu has been slightly improved.
- And many other improvements...

This version contains a countless number of improvements and bug fixes, and is the largest update to Sodium since the initial release.

## Highlights
- **This is the first multi-loader release for both NeoForge _and_ Fabric!** Yes, seriously!
- In the long-term, this means that users and mod authors will no longer need to rely on third-party forks of Sodium (Rubidium, Embeddium, Xenon, etc). This will greatly reduce friction for everyone, and improve the overall user experience significantly.
- We are working with mod authors as quickly as possible to implement additional APIs to improve mod compatibility with this version. Where possible, we will try to submit patches upstream to other mods to minimize the effort needed. If you are a mod author who finds their mod no longer works with Sodium 0.6, please [open an issue](<https://github.com/CaffeineMC/sodium-fabric/issues>) so that we can work with you to fix it.
- **The Fabric Rendering API (FRAPI) is now supported out of the box!** This greatly improves mod compatibility, and makes it so mods like _Indium_ are no longer necessary. We've worked with individuals in the Fabric team and other mod authors to make sure our implementation works correctly, and have done comprehensive testing to ensure other mods behave correctly with our implementation. (That said, if you find a bug with it as a mod author, please let us know.)
- **Major improvements for translucent blocks!** You know the long-standing issues with stained glass and other blocks, and how they don't quite look right? We're happy to announce those issues are no more. This means that translucent blocks will look great-- much better than Vanilla even-- with almost no performance impact. (This achievement would not have been possible without the effort of [Douira](https://douira.dev/). This was such a complex issue that it became the subject of their master's thesis.)

## Other changes
- The quality of terrain rendering has been greatly improved (greater vertex/texture precision), fixing many issues with special block models.
- The graphical fidelity and performance of cloud rendering has been improved significantly.
- Error messages at startup are more helpful now, especially when showing errors about incompatible graphics drivers.
- Reduced the overhead of framebuffer copies, improving performance slightly on integrated graphics.
- Fixed a bug that would cause z-fighting between fluids and some special blocks (such as Stairs and Slabs.)
- Added support for modifying the alpha component of vertex colors in terrain rendering, as used by some mods.
- Improved compatibility with mods that use custom fluid renderers.
- Improved compatibility with mods that use custom biome colors.
- Improved compatibility with mods that extend the entity renderer.
- Fixed an issue where some chunks would not render correctly immediately after the projection matrix was changed (such as when putting down a Spyglass.)
- Fixed an issue where mods relying on FREX Flawless Frames (such as ReplayMod) would have a one-frame delay before chunks were rendered to the screen.
- Added a workaround for users who have installed ASUS GPU Tweak III on their computer, since it causes extremely poor performance and crashes with Minecraft.
- Fixed a crash at startup with ARM CPUs on Windows that don't support OpenGL without the use of a translation layer.
- The rendering of some options in the video settings menu has been slightly improved.
- And many other improvements...

This is a minor release of Sodium, further fixing driver checks, adding minor fixes for fluid rendering, and fixing a crash when using specific resource packs that changed the clouds texture.

This is a minor release of Sodium, further fixing driver checks, adding minor fixes for fluid rendering, and fixing a crash when using specific resource packs that changed the clouds texture.

This is a minor release of Sodium, further fixing driver checks, adding minor fixes for fluid rendering, and fixing a crash when using specific resource packs that changed the clouds texture.

This is a hotfix to fix some items not showing on 1.20.1.

This is a minor bugfix release to fix some driver and mod compatibility issues, as well as updating to Minecraft 1.21.

This is a minor bugfix release to fix some driver and mod compatibility issues, as well as updating to Minecraft 1.21.

This is a minor bugfix release to fix some driver and mod compatibility issues, as well as updating to Minecraft 1.21.

This is a minor upgrade to make Sodium 0.5.8 compatible with Minecraft 1.20.6.

**Compatible with Minecraft 1.20.5 and 1.20.6, and Fabric Loader 0.15.9 or newer.**

This is a minor upgrade to make Sodium 0.5.8 compatible with Minecraft 1.20.5.

**Compatible with Minecraft 1.20.5 only and Fabric Loader 0.15.9 or newer.**

- Fixed compatibility with Fabric API 0.95.3+ when using High Contrast or Programmer Art resource packs.
- Improved support for keyboard accessibility features in parts of the video settings screen. (thanks @haykam821)
- Updated mod compatibility data.

- Fixed compatibility with Fabric API 0.95.3+ when using High Contrast or Programmer Art resource packs.
- Improved support for keyboard accessibility features in parts of the video settings screen. (thanks @haykam821)
- Updated mod compatibility data.

- Fixed a critical issue where terrain would not render if outside the world height.
- Updated mod compatibility data so that the game will crash early at startup if incompatible addon mods are found.

- Fixed a critical issue where terrain would not render if outside the world height.
- Updated mod compatibility data so that the game will crash early at startup if incompatible addon mods are found.

- Reverted back to the 20-byte vertex format, which fixes a number of lighting issues that were introduced with Sodium 0.5. ([bug](https://github.com/CaffeineMC/sodium-fabric/issues/2228))
- This will cause a slight performance regression, but there is no way to fix the bugs without accepting this.
- The resource pack compatibility scanner has been improved significantly. ([commit](https://github.com/CaffeineMC/sodium-fabric/commit/5c04268709f8cc27f7b9bc1cc063cd1da63e3d8f))
- Resource pack authors can now silence certain warnings if they know the compatibility warnings are incorrect. ([pr](https://github.com/CaffeineMC/sodium-fabric/pull/2206))
- A compatibility report is now written to the game's log file with more information about the problems.
- The compatibility checks for RivaTuner Statistics Server (RTSS) have been improved so that no crash will happen if a known compatible version is used. ([bug](https://github.com/CaffeineMC/sodium-fabric/issues/2263))
- Older versions are still not supported, and a pop-up error will be shown if it is detected.
- Added support for using "fast clouds" with Sodium. ([bug](https://github.com/CaffeineMC/sodium-fabric/issues/2107))
- Please note, using "fast clouds" does not actually improve performance, since our optimized code for cloud rendering is already fast enough.
- Improved compatibility with certain mods (i.e. Caxton) that have unusual vertex formats. ([bug](https://github.com/CaffeineMC/sodium-fabric/issues/2240))
- Improved compatibility with mods that use custom ColorResolvers. ([bug](https://github.com/CaffeineMC/sodium-fabric/issues/2166))
- Fixed an issue where other mods using special animated block rendering would not have their textures be animated. ([pr](https://github.com/CaffeineMC/sodium-fabric/pull/2254))
- Fixed texture alignment problems and other block rendering issues caused by the use of very high-resolution texture packs.
- Added a pop-up message (with installation instructions) for when users attempt to double-click the Sodium JAR file. ([code](https://github.com/CaffeineMC/sodium-fabric/tree/7a622846d8ed703a55d813c0efaadcff4e9a0e14/src/desktop/java/net/caffeinemc/mods/sodium/desktop))
- The Video Settings screen now has better descriptions of each option and their performance impact. ([change](https://github.com/CaffeineMC/sodium-fabric/commit/cf27e1432192420b07c74de030d89899a93763c8))
- Improved the UX for when the renderer config file is corrupt and can't be used.
- A toast message is shown at startup, and the user is now prompted to reset the config file back to defaults when opening the Video Settings screen.
- Fixed a warning message which could appear when compiling terrain shaders. ([pr](https://github.com/CaffeineMC/sodium-fabric/pull/2271))
- Fixed a number of problems which caused incorrect rendering between certain render regions. ([bug](https://github.com/CaffeineMC/sodium-fabric/issues/2244))
- Fixed a problem where the block shape culling cache would always generate a cache-miss after it had exceeded a certain size.
- Fixed some block face culling problems that were caused by hureistics which were too aggressive.
- Added a donation nag screen that appears after a few days have passed after installation.
- This can be disabled permanently by changing the config option `notifications.force_disable_donation_prompts` to `false`.

- Reverted back to the 20-byte vertex format, which fixes a number of lighting issues that were introduced with Sodium 0.5. ([bug](https://github.com/CaffeineMC/sodium-fabric/issues/2228))
- This will cause a slight performance regression, but there is no way to fix the bugs without accepting this.
- The resource pack compatibility scanner has been improved significantly. ([commit](https://github.com/CaffeineMC/sodium-fabric/commit/5c04268709f8cc27f7b9bc1cc063cd1da63e3d8f))
- Resource pack authors can now silence certain warnings if they know the compatibility warnings are incorrect. ([pr](https://github.com/CaffeineMC/sodium-fabric/pull/2206))
- A compatibility report is now written to the game's log file with more information about the problems.
- The compatibility checks for RivaTuner Statistics Server (RTSS) have been improved so that no crash will happen if a known compatible version is used. ([bug](https://github.com/CaffeineMC/sodium-fabric/issues/2263))
- Older versions are still not supported, and a pop-up error will be shown if it is detected.
- Added support for using "fast clouds" with Sodium. ([bug](https://github.com/CaffeineMC/sodium-fabric/issues/2107))
- Please note, using "fast clouds" does not actually improve performance, since our optimized code for cloud rendering is already fast enough.
- Improved compatibility with certain mods (i.e. Caxton) that have unusual vertex formats. ([bug](https://github.com/CaffeineMC/sodium-fabric/issues/2240))
- Improved compatibility with mods that use custom ColorResolvers. ([bug](https://github.com/CaffeineMC/sodium-fabric/issues/2166))
- Fixed an issue where other mods using special animated block rendering would not have their textures be animated. ([pr](https://github.com/CaffeineMC/sodium-fabric/pull/2254))
- Fixed texture alignment problems and other block rendering issues caused by the use of very high-resolution texture packs.
- Added a pop-up message (with installation instructions) for when users attempt to double-click the Sodium JAR file. ([code](https://github.com/CaffeineMC/sodium-fabric/tree/7a622846d8ed703a55d813c0efaadcff4e9a0e14/src/desktop/java/net/caffeinemc/mods/sodium/desktop))
- The Video Settings screen now has better descriptions of each option and their performance impact. ([change](https://github.com/CaffeineMC/sodium-fabric/commit/cf27e1432192420b07c74de030d89899a93763c8))
- Improved the UX for when the renderer config file is corrupt and can't be used.
- A toast message is shown at startup, and the user is now prompted to reset the config file back to defaults when opening the Video Settings screen.
- Fixed a warning message which could appear when compiling terrain shaders. ([pr](https://github.com/CaffeineMC/sodium-fabric/pull/2271))
- Fixed a number of problems which caused incorrect rendering between certain render regions. ([bug](https://github.com/CaffeineMC/sodium-fabric/issues/2244))
- Fixed a problem where the block shape culling cache would always generate a cache-miss after it had exceeded a certain size.
- Fixed some block face culling problems that were caused by hureistics which were too aggressive.
- Added a donation nag screen that appears after a few days have passed after installation.
- This can be disabled permanently by changing the config option `notifications.force_disable_donation_prompts` to `false`.

This is a minor point release which improves some error diagnostics.

### Changes
- Startup errors caused by out-of-date graphics drivers will now show a popup message on Windows.
- Error diagnostics now link to the improved wiki pages.
- Attempts to schedule chunk rebuilds from the wrong thread is now an error, potentially catching broken mods that are causing memory safety issues.

This is a minor point release which improves some error diagnostics.

### Changes
- Startup errors caused by out-of-date graphics drivers will now show a popup message on Windows.
- Error diagnostics now link to the improved wiki pages.
- Attempts to schedule chunk rebuilds from the wrong thread is now an error, potentially catching broken mods that are causing memory safety issues.

## Highlights
- Slightly improved the performance of immediate-mode rendering (anything which is not terrain) by enabling general optimizations for all parts of the game code and other mods.
- The existing optimizations for entity rendering have been further improved, increasing frame rates by up to 7-10% in busy worlds.
- The automatic detection of graphics driver bugs and software incompatibilities has been improved.
- The game will now crash when Rivatuner Statistics Server (RTSS) is detected, in order to prevent the user's hard drive from [being filled up with errors](https://github.com/CaffeineMC/sodium-fabric/issues/2048).
- Resource packs which attempt to load incompatible "core shaders" now show a warning.

### Misc changes:.
- Fixed a bug where interacting with blocks in a debug world would result in the incorrect visual state being shown.
- Fixed some problems where chunks would not be rendered in the correct order when standing at the extreme extent of a render region.
- Fixed a bug where the client would get stuck at "Loading terrain..." for a very long time when the player's eyes and feet were in different chunks.
- Fixed a problem where animated textures would become de-synchronized with one another, due to texture updates being skipped for not-visible blocks.
- Fixed animated texture interpolation with mods that use unusual texture sizes.
- Improved compatibility with mods that replace the ColorProvider implementation of vanilla blocks.
- Improved compatibility with mods that specify a block entity renderer on "air" blocks. (Please stop doing this.)

## Highlights
- Slightly improved the performance of immediate-mode rendering (anything which is not terrain) by enabling general optimizations for all parts of the game code and other mods.
- The existing optimizations for entity rendering have been further improved, increasing frame rates by up to 7-10% in busy worlds.
- The automatic detection of graphics driver bugs and software incompatibilities has been improved.
- The game will now crash when Rivatuner Statistics Server (RTSS) is detected, in order to prevent the user's hard drive from [being filled up with errors](https://github.com/CaffeineMC/sodium-fabric/issues/2048).
- Resource packs which attempt to load incompatible "core shaders" now show a warning.

### Misc changes:.
- Fixed a bug where interacting with blocks in a debug world would result in the incorrect visual state being shown.
- Fixed some problems where chunks would not be rendered in the correct order when standing at the extreme extent of a render region.
- Fixed a bug where the client would get stuck at "Loading terrain..." for a very long time when the player's eyes and feet were in different chunks.
- Fixed a problem where animated textures would become de-synchronized with one another, due to texture updates being skipped for not-visible blocks.
- Fixed animated texture interpolation with mods that use unusual texture sizes.
- Improved compatibility with mods that replace the ColorProvider implementation of vanilla blocks.
- Improved compatibility with mods that specify a block entity renderer on "air" blocks. (Please stop doing this.)

Updated to Minecraft 1.20.2.

### Changes

- Added support for version 2 of Fabric's BlockView API. ([#2063](https://github.com/CaffeineMC/sodium-fabric/pull/2063))
- Fixed a crash that could occur when mods attempt to create quads with fewer than 4 vertices. ([#2060](https://github.com/CaffeineMC/sodium-fabric/pull/2060))
- Fixed a crash that could occur when mods do not provide a valid sprite as part of their block model geometry. ([#2049](https://github.com/CaffeineMC/sodium-fabric/pull/2049))
- Updated the list of authors and contributors.

This release fixes some issues that were introduced with Sodium 0.5.x, mostly to improve mod compatibility.

Compatible with **Minecraft 1.20.1 only** and **Fabric Loader 0.14 or newer**.

**Note:** Other mods which are compatible with Sodium 0.5.1 should also be compatible with Sodium 0.5.2, with some notable exceptions (such as Iris Shaders.) You may have to wait for an update from the authors of those mods.

---

### Changes

- Fixed a problem where chunks would not render in front of the player when using mods that disable fog effects.
- Fixed a problem where the game would freeze if using mods that configure the fog distance to far beyond the render distance.
- Fixed a crash that could occur when mods make use of NIO channels on the chunk meshing threads.
- Cauldron blocks no longer force the use of smooth biome color blending for the fluid conetnts.
- Added some additional integrations for ModMenu.

This release contains some new performance improvements (especially for integrated GPUs) and some fixes for issues introduced in the previous release.

Compatible with **Minecraft 1.20.1 only** and **Fabric Loader 0.14 or newer**.

**Note:** Some mods which interact with Sodium are likely to be incompatible with this update. You may have to wait for an update from the authors of those mods.

## Highlights

- Reduced video memory usage & bandwidth requirements by up to 20%. This can significantly improve performance when GPU-limited.
- Some more performance improvements have been made to chunk occlusion culling, reducing CPU overhead. The algorithm is also slightly more accurate, which may allow for GPU load to be further reduced.

## Other notable changes

- Fixed a problem where some surfaces would not render when the player stands at certain positions.
- Fixed a problem which caused the "update your graphics drivers" message to appear even if the latest NVIDIA graphics drivers were installed on Windows.
- Fixed the "Always Defer Chunk Updates" option (in "Video Settings > Performance") not working correctly.
- Fixed a race condition that could cause sporadic crashes when other mods attempt to perform rendering off-thread.
- Fixed a number of issues with the Mixins configuration file which prevented other mods from disabling certain functionality in Sodium.
- The graphics adapter probe now works correctly on Linux computers with hybrid graphics.
- The focus behavior of the Video Settings screen has changed, and elements are now only focused if the keyboard is used, rather than on each mouse click.

This version is probably one of the biggest updates for Sodium yet, and contains a massive number of performance enhancements, bug fixes, and improvements.

With thanks to the following contributors: [@jellysquid3](https://github.com/CaffeineMC/sodium-fabric/commits?author=jellysquid3), [@IMS212](https://github.com/CaffeineMC/sodium-fabric/commits?author=IMS212), [@PepperCode1](https://github.com/CaffeineMC/sodium-fabric/commits?author=PepperCode1), [@comp500](https://github.com/CaffeineMC/sodium-fabric/commits?author=comp500), [@MCRcortex](https://github.com/CaffeineMC/sodium-fabric/commits?author=MCRcortex), [@Noryea](https://github.com/CaffeineMC/sodium-fabric/commits?author=Noryea), [@embeddedt](https://github.com/CaffeineMC/sodium-fabric/commits?author=embeddedt), [@Grayray75](https://github.com/CaffeineMC/sodium-fabric/commits?author=Grayray75), and [@Moulberry](https://github.com/CaffeineMC/sodium-fabric/commits?author=Moulberry).

Compatible with **Minecraft 1.20.1 only** and **Fabric Loader 0.14 or newer**.

**Note:** Many mods which interact with Sodium are likely to be incompatible with this update. You may have to wait for an update from the authors of those mods.

## Highlights

- **Dramatically improved the performance of terrain rendering in nearly every way.**
- Chunk loading is dramatically faster, uses much fewer resources (both CPU and RAM), and should feel much smoother than before.
- The amount of time needed to load new chunks (referred to as "meshing") has been greatly reduced, and is anywhere from 40% to 60% faster than the previous release.
- Memory allocation rate while loading the geometry for new chunks has been decreased by around 80%.
- Occlusion culling is anywhere from 25-45% faster now, and the long-standing bugs with it have also been fixed
- You've probably experienced those issues where certain parts of the world don't seem to render when looked at from certain angles. Well, those issues are fixed now!
- Terrain rendering now uses shared index buffers which can reduce video memory bandwidth/usage requirements by up to 25%.
- **Fixed major performance regressions NVIDIA graphics cards.** (anywhere from 200% to 300% faster than previous release...)
- If you were previously disappointed by the performance you were getting on a NVIDIA GPU, try this version.
- "Render Pass Consolidation" has been added, which greatly reduces the number of render passes needed for the world (hugely improves CPU and GPU utilization.) This also helps to prevent excessive amounts of overdraw, and ensures larger batches of geometry are sent to the GPU for rendering.
- "Block Face Culling" has been significantly improved, which allows for more blocks to be eligible for early geometry culling (hugely improves GPU utilization.) This generally makes the biggest difference in foliage-heavy scenes.
- Many other performance enhancements which are too numerous to describe here.

## Other notable changes

- A lot of issues with biome color blending have been fixed. This means it is no longer incorrectly applied to certain blocks, especially those from other mods. Additionally, it's much faster to calculate the colors used by certain blocks, which helps improve world load times.
- A lot of issues were also fixed with smooth lighting! This should fix some issues with certain resource packs, and the lighting with blocks like Sculk Sensors.
- Mip-mapping has been greatly improved so that terrain no longer has a black outline around certain textures when viewed at extreme angles. (Note: This has the consequence that some textures, such as those used for leaves, may seem slightly brighter than they did before. However, we think this generally looks more accurate to the original texture work, and believe the original behavior was a bug.)
- When supported, the mod will now request a "No Error Context", which allows the graphics driver to skip some unnecessary CPU overhead during rendering. This slightly helps improve performance on some graphics card drivers.
- A new driver compatibility and workarounds system has been implemented, which helps to inform the user of possible performance issues & automatically fix them.
- Line rendering (used by things like Structure Blocks and Hitbox Rendering) is no longer broken.
- ... Many other improvements for mod compatibility.

Updated for Minecraft 1.20. No other changes.

### Highlights

- Added support for Minecraft 1.19.4.
- Fixed graphical corruption when using the Zink OpenGL driver.

### Known Issues

None outstanding as of the time of writing. Please open an issue if you run into problems.

This version adds new a number of new optimizations and fixes a couple of bugs with the previous release. Most players will want to upgrade to this version.

- Improved the performance of special effects, such as the enchanted item glint (up to 300% faster.)
- Improved the performance of mob and block entity rendering (up to 20% faster.)
- Improved the performance of chunk rendering by exchanging a small amount of memory for a reduced number of draw calls (up to 10% faster.)
- Fixed a memory leak which would cause copies of chunks to remain in cache even if they were no longer needed.
- Fixed a problem where animated textures which used interpolation would not have their alpha channel handled correctly.

NOTE: This version makes internal changes that will likely break mods that try to hook into Sodium (such as Iris, Indium, ImmediatelyFast, etc.) You will need to wait for an updated version of these mods.

This version improves on the driver detection system introduced in Sodium 0.4.7. The game no longer requires a restart to apply workarounds, and users will no longer see a popup window when a workaround has been applied.

To see what workarounds have been applied, you can read your client log file.

Sodium 0.4.7 is now out, fixing a memory leak and adding optimized cloud rendering.

This release includes a workaround for crashes on NVIDIA drivers. On the first boot, if you are affected a notice will appear explaining the problem.

Sodium 0.4.6 has now released, fixing a texture animation corruption issue.

Sodium 0.4.5 is now out, updating to 1.19.3. This release also fixes a small texture corruption issue.

**This release no longer includes JOML, as Minecraft 1.19.3 has it bundled.**

### Highlights

Supports Minecraft 1.19.3
Removed JOML
Fixed compact vertex format texture overflow

### Known Issues

None outstanding as of the time of writing. Please open an issue if you run into problems.

This is a hotfix release to revert Adaptive VSync, as it broke VSync on AMD cards.

This release also fixes a memory leak.

This release includes multiple bug fixes, lighting improvements, and better support for the Fabric Fluid API. It also includes native support for the Flawless Frames API, which fixes compatibility with Replay Mod.

Sodium 0.4.2 for Minecraft 1.19 is now out.
This is a straight port of the previous release for Minecraft 1.19.

This release is a mostly straightforward port of the most recent version, with some additional bug fixes. Also, we're dropping the alpha version and making this a proper release.

### Highlights
- Requires Minecraft 1.18.2

### Fixes
- Fixed a problem where the game could crash at random when teleporting or loading chunks
- Fixed a problem where biome colors would be incorrect at the edge of chunks which neighbor empty space

This release is a minor patch for 0.4.0-alpha5 which fixes a number of reported issues. We're currently working on some pretty big changes for the next major release and are pressed for time, so this patch only a small set of issues.

### Highlights

- Lag spikes caused by block updates should be significantly improved
- Fog effects now match those introduced in Minecraft 1.18.1
- Fixed a slow memory leak that would occur from fence objects being leaked
- Server view distance is now respected, preventing discrepancies between client/server
- Biome blending effects have been improved slightly
- World rendering bugs/flickering caused by being far away from world center (i.e. near the world border) no longer occurs

### Known issues
- Some parts of the world may not load correctly unless the player exits and loads the world file again

This release contains a few important bug fixes and improvements for Minecraft 1.17.1.

### Highlights
- Flickering and other rendering bugs caused by the player being far away from the center of the world (i.e. near the world border) should no longer happen
- Fixed a memory leak that would slowly develop each time a chunk is updated

This is a port of Sodium 0.3.3 to Minecraft 1.18 with some changes for compatibility. Fabric Loader 0.12 or newer and Java 17 is required.

### Known issues
- Placing and breaking blocks may cause stutters and other pauses when "Biome Blend Distance" is set to high values
- Some parts of the world may not load correctly unless the player exits and loads the world file again
- Server view distance is not respected, causing incorrect fog effects (#994)

This release contains a few important bug fixes and improvements for Minecraft 1.17.1.

### Highlights
- Improved frame rates when loading or updating chunks.
- Fixed a memory leak caused by sync objects never getting released.
- Added options to control how many threads are used for chunk building, and to always defer chunk updates for improved frame times. The default number of threads used for chunk building is more optimally chosen and should help improve frame rates on slower CPUs.
- Improved the precision of the compressed vertex format, reducing texture glitches found with some texture packs and vanilla blocks
- The inner faces of leaves are no longer rendered if fast graphics are enabled, significantly reducing the geometry count of scenes with lots of foliage (thanks ADudeCalledLeo.)
- Config file handling has been greatly improved, and if a corrupted config file is found, the user will be prompted to fix the problem instead of the game crashing.

### And everything else...
- Mods which provide config file overrides will no longer crash on first startup (thanks tbejos.)
- Improved our shader code slightly to reduce overhead in the vertex stage, potentially helping older graphics cards.
- Improved compatibility with the legacy AMD graphics drivers on Windows.
- Fixed a problem where empty draw calls would be submitted during chunk rendering.
- Some other minor improvements and fixes...

This release fixes a few more issues in Sodium 0.3 for Minecraft 1.17.1.

### Changes and fixes
- Fixed an issue where OpenGL 4.x buffer targets would be accessed on OpenGL 3.x hardware, leading to a flood of OpenGL errors and degraded performance
- Fixed the "Use Block Face Culling" option not applying
- Fixed some strings not being translatable in the Video Settings screen
- Fixed a number of cases where the world would suddenly disappear at specific camera angles
- Fixed an issue where particles using animated sprites would not be animated
- Merged the cloud toggle and quality controls into one option to reduce confusion
- Fixed entities with spectral effects not being rendered through walls due to entity culling

This release fixes many issues and performance problems that were introduced with the first release of Sodium for Minecraft 1.17.1.

### Changes and fixes

- Improved frame times when loading/updating chunks through the use of persistently mapped staging buffer (requires OpenGL 4.4+)
- Fixed chunk rendering corruption on older AMD/Windows systems
- Fixed missing chunk and "hole in the world" issues that could appear on some AMD systems
- Fixed the "Only Animate Visible Textures" option not disabling the optimization if ticked
- Fixed config files sometimes becoming corrupt after the game crashes
- Fixed an issue where fog effects would not respect other mods which modify the camera
- Fixed compatibility with LWJGL 3.2.3 and macOS M1 hardware
- Fixed an issue where some blocks wouldn't render their waterlogged state against glass.
- Changed how camera transformation matrices are handled in our shader code for better compatibility with Iris

This release adds official support for Minecraft 1.17.1 and with it many new improvements and fixes.

### Changes and fixes

- A brand new chunk rendering backend has been introduced, bringing the best performance yet to any hardware that can run Minecraft.
- Added support for some Fabric API features, such custom fluid rendering and blocks with attached data.
- Many improvements to how we use and allocate VRAM, reducing stutters caused by loading chunks and overall GPU memory usage.
- Additionally, chunk loading was improved to prevent overload and to better stabilize frame rates. This can help with loading into worlds or when many blocks are changing at once.
- Improved the amount of time it takes to rebuild the chunk graph. This can reduce lag associated with moving around in the world or loading chunks at higher render distances.
- Many new optimizations for high resolution texture packs, especially when animated textures are used.
- Fixes and improvements for fog effects during sunrise/sunset and while underwater, helping to improve visuals drastically.
- Reduced VRAM usage in ocean biomes and other environments with lots of water.
- Support for custom translations (to be added in a future release)
- Improvements to particle rendering/culling, helping performance in particle heavy servers.
- Additional optimizations for biome color blending.
- ... and many other smaller, miscellaneous optimizations specific to Minecraft 1.17.

This is the first major release of Sodium since launch, so there are nearly a year's worth of improvements and bug fixes in this one! Hardware support has been greatly improved, and there's been many new optimizations to help out everyone.

### Highlights
- Added a new and optimized system for vertex writing. Depending on the situation, significant performance improvements can be seen for both [block entity rendering](https://cdn.discordapp.com/attachments/791199652410032150/792627201463287818/unknown.png), [mob rendering](https://cdn.discordapp.com/attachments/791199652410032150/792627353401950208/unknown.png), and text rendering.
- Improved hardware support for AMD and Intel GPUs on Windows, allowing the use of multi-draw rendering where it was otherwise broken in the past. Multi-draw chunk rendering can drastically improve frame rates where supported.
- Switched to using the new ThinGL library, which allows Sodium code to use a stateless abstraction over OpenGL. This helps to improve performance, mod compatibility, stability, and future compatibility with Minecraft 1.17.
- Preparing chunk updates for rendering now takes much less time by better taking advantage of multi-threading, greatly improving frame times while loading or updating chunks.
- Many new optimizations for our chunk graph and culling algorithm, helping to reduce CPU load and improve frame rates while playing.
- Improved compatibility with many mods depending on additional block data to be available during chunk building, such as LambdaBetterGrass.
- Added an API other mods can use to disable Sodium features. Sometimes, incompatibilities can arise, but mods supporting this functionality can ask Sodium to disable specific parts of itself automatically to avoid these.
- Fixed large memory leaks that could occur when unloading and loading many worlds repeatedly.
- Fixed terrain stitching issues caused by high-resolution texture packs and exotic block models.
- Fixed some issues with smooth block and entity lighting, notably with emissive properties.
- Fixed issues where the top-face of fluids would disappear at certain camera angle, or while inside a fluid.
- Fixed many issues causing chunks not to update or appear when looking in certain directions.
- Issues with render distance and fog effects when using certain mods have been fixed.
... and much, much more.

You can find a number of issues that were fixed with this release [here](https://github.com/CaffeineMC/sodium-fabric/milestone/2?closed=1). For the complete list of changes, you can review the Git commit log [here](https://github.com/CaffeineMC/sodium-fabric/commits/1.16.x/next).

Initial release.