lumoslab-innovation/3d-lab-skills/threejs-procedural-materials

Procedural Materials

Build a material from surface identity and causes. Color, roughness, metalness, normal, transmission, and emission should describe the same surface—not unrelated noise textures.

Material graph order

stable coordinates
  → structural fields
  → material identity weights
  → causal modifiers
  → filtered microstructure
  → PBR channels
  → lighting/shadow extensions

Read references/procedural-pbr-system.md for atlas filtering, specular AA, planetary coordinates, world-height wetness, per-instance dissolve, and authored PBR response bundles.

Read the sculpted gallery frame geometry for walnut, antique-gold, and ebony texture/roughness/metalness/clearcoat bundles under a grazing-light setup.

Read the procedural planet surface for shared geological, climate, water, biome, roughness, and derivative-normal causes on a procedural planetary surface.

Read the analytic wave optics for coupled reflection, refraction, absorption, filtered microstructure, resolved crest response, and their diagnostic channels.

Read the lava flow surface material for raymarched procedural height fields whose normals, rock/lava identity, emission, glow, embers, fog, and grain are coupled to one material cause stack.

Required controls

• real or perceptual texture scale;
• material identity weights;
• roughness range and micro-normal strength;
• the causal fields required by the selected material pattern;
• distance/derivative filtering;
• specular antialiasing;
• channel and mask debug modes.
• emissive-material debug modes when the material owns glow or volumetric

accumulation.

Failure conditions

• every PBR channel samples independent noise;
• roughness is a scalar afterthought;
• high-frequency normals survive below one pixel;
• triplanar projection has visible orientation or scale seams;
• atlas padding is ignored under mipmapping;
• custom lighting removes energy conservation without an explicit stylized goal;
• post-processing is used to hide unstable highlights.

Routing boundary

Use $threejs-procedural-fields when the main problem is designing shared scalar/vector causes. Use $threejs-procedural-planets for a complete orbit-to-close-approach body, not merely its material.

Source: Scott Sun, MIT. Adapted by LumosLab: example assets remain linked to pinned upstream source; skill instructions and references are bundled. See LICENSE.