Saltbrush
by dopadream
Saltbrush changes how Sodium draws blocks on the client by splitting its block shaders into separate passes for each render type.
What it does
Vanilla Minecraft and Sodium both draw blocks under a single shader regardless of render type. Saltbrush forces Sodium to use different shaders for the Opaque, Translucent and Cutout passes, with cutout mipped grouped apart from the opaque set that previously covered everything. That separation lets a resource pack set a distinct shader for each render type, so core shaders can be customized more freely and case by case.
Installation requires Fabric API and Sodium, and Sodium Core Shader Support is an optional addon that can take its place when a setup needs the same kind of shader separation. Saltbrush runs on the client alone, so a server does not need it. Files exist for Fabric and Quilt across the 1.21 – 1.21.3 range, with 1.2.1+1.21.3 as the latest Fabric file.
Key features
Separate block shader passes
Blocks are drawn in distinct Opaque, Translucent and Cutout passes, each with its own shader.
Cutout mipped grouping
Cutout mipped blocks are split from the opaque set they previously shared with everything else.
Custom per-pass shaders
Resource packs can assign unique core shaders to each render type instead of one shader for all blocks.
Sodium integration
The changes are built on Sodium's rendering pipeline, so Sodium must be installed to use the feature.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 2
Optional 2
Use cases
Who it’s for: Shader pack authors and players on Fabric or Quilt who run Sodium and want per-render-type block shaders. Players who use Iris or Nvidium should expect possible conflicts until updates arrive.
How it compares
Sodium Shader Support is a Fabric mod for 1.19 – 1.20.1, under the MIT License and open source, so it does not cover the 1.21 line Saltbrush targets. Dimension Based Shader Switch is a Fabric client mod for 1.21.11 – 26.2 under the GNU General Public License v3.0 only, and it switches shaders by dimension instead of by render type.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Saltbrush | Fabric and Quilt | 1.21 – 1.21.3 | Client-side only | 2024-10-31 |
| Sodium Shader Support | Fabric | 1.19 – 1.20.1 | Client-side only | 2023-07-16 |
| Dimension Based Shader Switch | Fabric | 1.21.11 – 26.2 | Client-side only | 2026-07-06 |
Questions
Does Saltbrush need Fabric API and Sodium?
Is Saltbrush needed on servers?
Can Saltbrush run with Iris or Nvidium?
Which Sodium addon can replace Saltbrush?
In the catalog
Saltbrush is one of 36,990 Utility mods on ModsFinder, and one of 25,772 Utility mods for Fabric. 13,252 mods support Minecraft 1.21.3.
More from dopadream
Similar mods
What the author says
Very small addon for Sodium that splits the block shader into separate passes for all block render types, allowing for each to be replaced separately with something like Sodium Core Shader Support. Unlike vanilla Minecraft, Sodium renders all blocks under one shader regardless of its render type. This limits core…
Official listing
- Modrinth page
- modrinth.com/mod/saltbrush
- Owner
- dopadream
- Published
- 2024-09-11
- Updated on Modrinth
- 2024-10-31
- Facts verified
- 2026-10-15
