GBuffer Encodings
MeshBlend stores a blend ID for every mesh in the GBuffer. The launcher version of Unreal has no free GBuffer channel, so the plugin has to share one. There are two ways to do this, called encodings.
- GBuffer AO (default) - Stores the ID in the material Ambient Occlusion channel.
- GBufferB (experimental) - Packs Metallic and Specular into one channel, and stores the ID in the channel that frees up.
Both encodings blend the same way. They differ in what your project gives up.
Comparison
| GBuffer AO | GBufferB | |
|---|---|---|
| Material AO | Not available | Works |
| Static lighting | Not available | Works |
| Metallic and Specular | Unchanged | Share one channel at 7 bits. Metallic pixels use the default Specular |
| Hair and Eye shading models | Not blendable | |
| Substrate | UE5.5+ | UE5.7+ with Blendable GBuffer |
| Required console variables | r.AllowStaticLighting=Falser.Lumen.ScreenProbeGather.MaterialAO=0 | r.DBuffer=1 |
Engine support
| Engine | Legacy Materials | Substrate |
|---|---|---|
| UE5.3 - UE5.4 | Both | - |
| UE5.5 - UE5.6 | Both | GBuffer AO |
| UE5.7+ | Both | Blendable GBuffer: Both Adaptive GBuffer: GBuffer AO |
Substrate on UE5.7+
Blendable GBuffer is the default for new Substrate projects. You can check it under Substrate GBuffer Format in project settings.
Which one should I use?
- Use GBuffer AO if you don't need Material AO or baked lighting. It's the default, and it's the setup shown in the getting started video.
- Use GBufferB if your project needs Material AO or static lighting. (Note: Check that materials using Metallic & Specular in special ways still look as expected)
The engine patch is shared
ENGINE-WIDE PATCH
Both encodings patch the engine shaders. The patch applies to every project that uses the same engine install, not just the one you converted.
With GBufferB, every project on that engine gets merged Metallic and Specular, including projects that don't use MeshBlend. Converting any project back to GBuffer AO switches the engine back for all of them.
- Keep projects that share an engine install on the same encoding.
- Every machine that builds the project, including teammates and build machines, needs the same patch. Without it, that machine falls back to GBuffer AO.