Multilayered Material Properties
Properties of the multilayered material
Summary
Created: Jan 14 2024 by manavortex Last documented update: Apr 07 2024 by manavortex
This page documents multilayered shader properties.
For an overview of glass shaders, see Cheat sheet: Materials-> Multilayered
For an explanation of material properties and further links, see Material properties
If a layer with a greyscale mask is invisible, set MicroblendContrast in the .mlsetup
to 1!
Multilayered Material
For a full documentation, check the corresponding page.
To set it up, use these keys for the "values" array of your material:
GlobalNormal
path\to\normal.xbm
MultilayerMask
path\to\mask.mlmask (white file)
MultilayerSetup
path\to\material.mlsetup

Material properties
colorScale
Sets a color from within the mltemplate file. Hex codes corresponds to rows and columns in substance painter.
material
Depot path to the base material mltemplate from which the surface inherits its properties (lightbreaking, subsurface scattering…).
Example values:
base\surfaces\materials\paint\car_paint\car_paint_metallic_01.mltemplate
base\surfaces\materials\metal\enameled_hq\enameled_hq_01_30.mltemplate
matTile
Scaling (tiling multiplier) of the material across the mesh. The higher the value, the smaller it is.
metalLevelsIn
Clamps metalness input levels. This value corresponds to a (generated?) greyscale texture across the entire mesh.
metalLevelsOut
Clamps metalness output levels. This value corresponds to a (generated?) greyscale texture across the entire mesh.
normalStrength
Applies or ignores the base mesh's normal map to this layer. This value can be greater than 1!
offsetU
For logos: X-offset on the texture. Used for e.g. targeting a certain label.
offsetV
For logos: Y-offset on the texture. Used for e.g. targeting a certain label.
opacity
Transparency of the layer, 0 means that it isn't displayed, 1 means that it's fully visible.
roughLevelsIn
TODO
roughLevelsOut
Determines the roughness of a material

Microblend properties
You can only use microblends if this layer's mask is not fully white.
mbTile
Like matTile, this determines the scaling of the microblend. The higher the value, the smaller it is.
microblend
Depot path to the base microblend texture (xbm), a seamless pattern which will be projected on the surface. Think of an extra normal map that tiles across a layer.
microblendContrast
A crossfade between the layer mask and the microblend mask (the black parts of the microblend texture). If you set this to >=1, then the layer will be blocked out where the microblend texture is black.
This requires the xbm's AlphaChannel (transparency) to be set up.
microblendNormalStrength
Like normalStrength for the microblend.
microblendOffsetU
X-offset for the microblend texture.
microblendOffsetV
Y-offset for the microblend texture
multilayered_clear_coat.mt
Discovered and shared by Rebecca, thanks a tonne!
Using ClearCoat lets you put additional hues over an mlsetup:


Please note that this uses light colour mixing!

Last updated
Was this helpful?