Documentation / Node reference / mat nodes

mat/MeshPBR

Creates a physically based material, with metal, roughness and reflections.

Mesh

Shades a surface with a base colour, metallic and roughness, which cover most real materials. Imported glTF models use it. Each channel takes a flat value or a texture. Reflections need an environment map.

Parameters

Name Type What it does
albedo Color4 Base colour. Its alpha sets transparency under AUTO.
useVertexColor Float How much the point colour attribute multiplies albedo.
emissive Color Colour the surface gives off. It lights nothing else.
metallic Float 0 is non-metal, 1 is metal tinted by its colour.
roughness Float 0 is a mirror finish, 1 a broad matte sheen.
ao Float Ambient light reaching the surface. Lower darkens creases.
ior Float Index of refraction: reflection seen head on. Non-metals only.
environmentMode UInt8 AUTO · GLOBAL · PARAM · NONE Where the environment map comes from.
envMap NodePath Environment map, lighting the surface from every direction.
envIntensity Float Strength of the environment lighting. 0 turns it off.
envColor Color Tint of the environment lighting.
useBaseColorTexture Bool Take the base colour from a texture.
baseColorTexture NodePath Base colour texture. It multiplies albedo.
useMetallicRoughnessTexture Bool Take metallic and roughness from a texture.
metallicRoughnessTexture NodePath Texture with roughness in green, metallic in blue.
useOcclusionTexture Bool Take ambient occlusion from a texture.
occlusionTexture NodePath Occlusion texture, read from red. It multiplies ao.
useEmissiveTexture Bool Take the emissive colour from a texture.
emissiveTexture NodePath Emissive texture. It multiplies emissive, which must not be black.
useNormalTexture Bool Add surface detail from a normal map.
normalTexture NodePath Tangent space normal map.
normalScale Float Strength of the normal map. Negative flips it.
transparencyMode UInt8 AUTO · OPAQUE · MASK · BLEND How the material's alpha is drawn.
alphaCutoff Float Alpha below which pixels are cut out, shadows included.
sides UInt8 FRONT · BACK · BOTH Which side of each triangle is drawn.

This page is generated from the engine, so it describes the release you can download. The same text is in the editor's Help panel next to the node itself.