Golestan – Persian Carpet Generator for Blender

👉 See all my Blender addons on BlendKit >

Golestan weaves photorealistic hand-knotted Persian carpets inside Blender. Pick a weaving city or tribe, from a Tabriz or Kashan medallion carpet and a silk Qom prayer rug to a tribal Heriz, a Qashqai, a Baluch or a naive Gabbeh with its animals, and the addon draws the whole design knot by knot, then weaves it into a carpet with real pile, flat-woven kilim ends and a knotted fringe.

Every carpet is drawn by the addon, never a tiled photo. Medallions with pendants, corner spandrels, Herati, Shah Abbasi and scrolling-vine fields, main borders with guard stripes, prayer arches, vase and tree-of-life designs, garden panels and Gabbeh figures follow the real carpets of each city. Knot density sets how fine the drawing steps, abrash adds the colour bands of hand-dyed yarn lots, and a hand-drawn slider gives village rugs their charming irregularity.

The look is built for close-ups. Each knot is a tuft of wool or silk with its own normal, roughness and ambient occlusion, silk gets an anisotropic sheen, and the pile slopes down into the flat-woven ends. Age it with one click from New to Used, Antique or Worn Out: traffic lanes wear down to the bare foundation, colours fade in the sun, iron-dyed outlines corrode and grime settles in.

Features
- 22 weaving centres: Tabriz, Kashan, Isfahan, Nain, Qom, Kerman, Mashhad, Sarouk, Heriz, Bidjar, Hamadan, Senneh, Mood, Joshaghan, Bakhtiari, Qashqai, Baluch, Gabbeh, Ardabil, Kenareh runner, Modern and Shah Abbas
- 10 layouts: medallion and corners, open-field medallion, all-over, pole medallions, garden panels, prayer niche, vase, tree of life, tribal and Gabbeh
- 9 field patterns, 4 medallion shapes, 6 main borders and 6 guard stripes, all as pictures in the sidebar
- 19 natural-dye palettes matched to real carpets, or six colours of your own
- Traditional Persian sizes from pushti to palace carpets, runners and rounds, or any custom size
- Wool, wool and silk or all-silk pile on a cotton, wool or silk foundation, 16 to 900 knots per square inch
- Condition New, Used, Antique or Worn Out, plus wear, sun fade, corrosion and dirt sliders
- Kilim ends, knotted or loose fringe, floor lay, wrinkles and a folded corner showing the knotted back
- Game Ready or Hero mesh, export of base colour, normal, roughness, AO and height maps
- Picture-first sidebar with Surprise, Variation and Colours buttons, Shift+A menu and Convert to Mesh

Requires Blender 4.2 or newer. Tested on Blender 4.2, 4.5 and 5.2 LTS.

Installation

In Blender open Edit, Preferences, Get Extensions, then use Install from Disk and pick the iranian_carpet_generator zip.

Usage

• Open the Carpet tab in the 3D viewport sidebar (N). With no carpet selected, click the picture to choose a weaving centre and press Add Carpet to place it at the 3D cursor. You can also use Shift+A, Mesh, Persian Carpet.
• With a carpet selected, the big picture switches it to another weaving centre. Surprise makes a new random carpet, Variation redraws the current one and Colours picks another dye palette.
• The first page holds size, colours (palette picture and six colour swatches), layout, condition, pile material and knot density. The folded sub-panels hold Design (field, medallion, motif scale, abrash), Borders, Pile & Fringe, Age & Placement (wear, fade, corrosion, dirt, lay, wrinkles, folded corner) and Mesh & Export.
• Export Maps writes base colour, normal, roughness, AO and height images for game engines. Convert to Mesh keeps the carpet as plain objects; Delete removes it with all its parts. Generated images are packed into the .blend when you save.

Changing colours or condition never redraws the design, so it updates fast even on large, fine carpets.

Which Blender versions are supported?

Blender 4.2 and newer. It is tested on Blender 4.2, 4.5 and 5.2 LTS.

Can I use the carpets in a game engine?

Yes. Game Ready builds a light mesh with Principled PBR materials, and Export Maps writes base colour, normal, roughness, AO and height images you can use in Unity, Unreal or Godot.

Are the designs photos or tiled textures?

Neither. The addon draws every design itself, knot by knot, so you get endless variations at any size and knot density without repeats.

Does it work in EEVEE?

Yes. The materials look right in both Cycles and EEVEE; silk sheen and the knot detail are strongest in Cycles.