# Sodium Blending Registry
\nThis is a Sodium plugin designed to address a known bug in the Sodium graphics engine that causes incorrect color blending, resulting in visual inconsistencies in many Minecraft mods which make use of color providers.
\nThe bug is described in issue 895.<\/p>\n
Additionally, it introduces a new tag `c:blendable` that allows custom blocks or fluids to be registered to use the Sodium blending system.<\/p>\n
> **\u2757IMPORTANT NOTE\u2757**
\n> **Starting from Sodium 0.5, this plugin is a part of Sodium itself, and is not required anymore.**
\n> **If you use this with Sodium 0.5 or newer releases the game will crash!**<\/p>\n
## Examples of the bug
\n<\/p>\n
<\/p>\n
## Installation
\nTo install the mod, follow these steps:<\/p>\n
1. Make sure you have Fabric and Sodium installed.
\n2. Download the correct release of the mod file from Modrinth, for the specific Minecraft and Sodium releases.
\n3. Move the downloaded mod file into the mods folder.<\/p>\n
## Usage of the tag
\nThe `c:blendable` tag can be particularly useful for mod developers when they introduce a block or fluid that utilizes color providers based on the biome.
\nBy applying the tag, the new block or fluid will make use of Sodium blending system instead of the vanilla one.<\/p>\n
To use the tag, add a new file named `blendable.json` into `resources\/data\/c\/tags\/blocks` for blocks, or `resources\/data\/c\/tags\/fluids` for fluids.<\/p>\n
The file should be similar to this:<\/p>\n
“`json
\n{
\n “replace”: false,
\n “values”: [
\n\t“testmod:newleaveblock”
\n ]
\n}
\n“`<\/p>\n
Please note that this feature is intended for mod developers and not for end users.<\/p>\n
## Bug Reporting
\nNote that this mod fixes only the blending bug of Sodium.
\nFor other Sodium bugs, please open an issue on Sodium instead and not here!<\/p>\n
To ensure accurate bug reporting, please follow these steps:<\/p>\n
1. Verify that you are using the correct version of the plugin for the specific Minecraft and Sodium release.
\n2. Reproduce the issue, noting down any specific steps or circumstances that trigger the bug.
\n3. Provide any relevant information, including your Minecraft version, Fabric version, Sodium version, and any other mods you have installed.
\n4. Provide the logs if they are relevant.<\/p>\n
## References
\n* Sodium issue 895: The issue describing the bug.
\n* Sodium pull request 1360: The code is taken from here.<\/p>\n
# License
\nCopyright (C) 2023 devpelux (Salvatore Peluso)
\nLicensed under MIT license.<\/p>\n","protected":false},"excerpt":{"rendered":"
This is a plugin for sodium, that fixes a sodium “color blending bug”, and adds a dynamic way to register blocks for blending.<\/p>\n","protected":false},"featured_media":144949,"template":"","meta":{"_minecraft_slug":"sodium-blendingregistry","_minecraft_project_id":"iq71kojm","_minecraft_author":"devpelux","_minecraft_license":"MIT","_minecraft_downloads":32024,"_minecraft_follows":74,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"sodium-blendingregistry.zip","_minecraft_size_bytes":40067,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-16T16:05:22.475016Z","_minecraft_date_created":"2023-06-24T00:09:49.026871Z","_minecraft_date_modified":"2023-08-07T23:49:58.573012Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/sodium-blendingregistry","_minecraft_icon_attachment_id":144949,"_minecraft_imported_at":"2026-06-08T16:06:49+00:00","_minecraft_import_hash":"70f9b96299b2d68ba730930ccfec91fc","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[43,97,873,90,98],"mod_loader":[99,100],"minecraft_version":[54,55,56,57,58,59],"class_list":["post-144948","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-cursed","mod_category-fabric","mod_category-library","mod_category-optimization","mod_category-quilt","mod_loader-fabric","mod_loader-quilt","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20"],"yoast_head":"\n