create_procedural_material
Create a complete procedural material with one call: node graph including coordinates, mapping, pattern, color ramp, and BSDF. Removes need for image textures and UV unwrapping.
Instructions
Build a complete procedural texture as a material, in one call.
Prefer this over hand-wiring texture nodes. It creates the full graph — coordinates, mapping, the pattern's texture nodes, a tuned colour ramp, and the Principled BSDF — and returns the node names so you can adjust anything afterwards with set_shader_node_input or the colour ramp tools.
Procedural beats image textures here: no files, no UV unwrap needed, and it stays sharp at any camera distance.
Call list_procedural_patterns() to see what each pattern looks like.
Args: name: Name for the new material. pattern: One of the supported patterns, e.g. 'fire', 'wood', 'veins'. scale: Feature size. Lower is bigger and broader, higher is finer and busier. 5.0 is a sensible default; try 1-3 for large forms and 20+ for fine detail. detail: Fractal octaves, 0-15. Higher adds finer sub-detail at the cost of render time. Applies to noise, cloud, wood, marble, plasma and fire. The cellular patterns (voronoi, veins, scales, sparks), stripes, weave and gradient have no detail socket and ignore it. distortion: Warps the pattern. Small values (0.5-2.0) make wood and marble look organic rather than machine-perfect. Applies to noise, cloud, stripes, wood, marble, plasma and fire. The cellular patterns, weave and gradient ignore it. roughness: Surface roughness 0-1 for the Principled BSDF. metallic: Metallic 0-1 for the Principled BSDF. colors: Optional list of RGB or RGBA colours for the ramp, in order. Omit to use the pattern's own tuned palette. banded: Use CONSTANT ramp interpolation, giving hard-edged bands instead of smooth blending. Turns noise into discrete regions: scale plates, cracked mud, cel shading. connect_to_bsdf: Wire the result into the Principled BSDF base colour so the material renders immediately. Set False to leave the pattern subtree unconnected for manual wiring.
Returns: Dict with the material name, the created node names, and ignored_params listing any arguments this pattern could not use.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| scale | No | ||
| banded | No | ||
| colors | No | ||
| detail | No | ||
| pattern | Yes | ||
| metallic | No | ||
| roughness | No | ||
| distortion | No | ||
| connect_to_bsdf | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||