Multilayered Material Properties

Properties of the multilayered material

Summary

Created: Jan 14 2024 by mana vortex Last documented update: Apr 07 2024 by mana vortex

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.