Installation

1. Unzip the download. You get wool_generator-1.5.0.zip (the extension) and WoolGenerator_Examples.blend.
2. In Blender 5.2 LTS or newer: Edit > Preferences > Get Extensions > (arrow menu) Install from Disk, pick wool_generator-1.5.0.zip.
3. Open the 3D Viewport sidebar (N) and select the Wool tab.

Quick start

1. Select one or more mesh objects.
2. Click Wool from Selection. A Curves object "Wool" with the WoolGenerator Geometry Nodes modifier is created, sized to your mesh.
3. Choose a Look Preset (Fine, Classic, Chunky, Mega, Mohair Knit, Braided Yarn, Fuzzy Mohair, Flat Ribbon, Rope). Presets are relative to the mesh size.
4. Tweak the sliders. Use Colors from Model Texture to sample the source mesh's image texture through its UVs.
5. Render with Cycles.

Main parameters

• Yarn Layout: 2 = Knit Lattice (closed, roughly star-shaped meshes), 1 = Surface Stitches (any mesh), 0 = Mesh Edges (regular quad meshes).
• Stitch Size / Stitch Aspect / Stitch Roundness / Stitch Depth: size and shape of the knit stitches.
• Yarn Radius, Fibers per Yarn, Fiber Radius, Fiber Spread, Twist, Twist Variation: yarn structure.
• Fuzz Amount / Length / Curl: surface hair. Set Fuzz Amount to 0 to switch it off.
• Growth (0 to 1) with direction mode (axis, from Empty, random): procedural growth. Click Animate Growth to keyframe it.
• Render Quality: Draft / Standard / High. The viewport uses reduced fibers.
• Color mode: solid, 3-color palette, model texture, color attribute; per-fiber and per-yarn variation.
• wool_density vertex group: paint to thin the wool locally.

Bake to Mesh

Converts the wool to tube geometry with vertex colors for GLB / FBX export. A live vertex estimate is shown; for game assets start with 4-6 fibers per yarn.

Limits

• Knit Lattice needs closed, roughly star-shaped meshes (no holes such as a torus). Use Mesh Edges or Surface Stitches there.
• Chunky and Mega look best on smooth, large shapes.
• Colors from a texture need a valid UV map.
• Tested with Cycles on Blender 5.2.

Support

u2y, [email protected]. License: GPL-3.0-or-later.