โ† All examples

blender tools

Plain-weave fabric material with thread bump

Build a woven cloth node material on UV coordinates: warp and weft threads that alternate over and under by cell parity, rounded thread profiles that drive bump and edge shading, two thread colours and Principled sheen. Use it for clothing, upholstery, flags and furniture.

Recorded render of Plain-weave fabric material with thread bump

What this component contains

  • ATTRIBUTION.md
  • LICENSE
  • README.md
  • component.json
  • graphcheck.py
  • material_fabric_weave.py
  • meshcheck.py
  • preview.png
  • test_material_fabric_weave.py
  • test_package.py
  • verification/native.json

How it works

Operator
baltor.material_fabric_weave
Parameters
material_name, threads, warp_color, weft_color, sheen, bump, assign
Result
One material with a node tree; assigned to the active object.
Blender
4.2 or later
Axes
Blender Z up, -Y forward
Units
metres

Recorded checks

blender 5.2.1 LTS (hash 9e2066aef7ef built 2026-08-25 02:12:34)

  • addon_install_and_enable
  • operator_runs_with_defaults
  • blender_data_matches_core
  • addon_disable_unregisters
  • script_mode_runs
  • clean_reopen_addon_file
  • clean_reopen_script_file
  • gltf_separate_export
  • engine_output_clean

Limits to consider

Plain weave only; twill, satin and knits are not modelled. Threads are straight and evenly spaced with no fibre fuzz, slubs or irregularity. The pattern follows the UV map, so it needs reasonable UVs and aliases when threads are smaller than a pixel. Rendered here with Cycles CPU only. Verified in Blender 5.2.1; written for the 4.2 API.