Documentation
Fairy architecture

fairy_house
One node, one complete fairy-tale building: a half-timbered body on a stone plinth (with jettied upper floors for townhouses), a bell-cast tiled roof, chimney, dormers, turrets, round towers or a toadstool house.
| style | What you get |
|---|---|
cottage | One storey under a big swooping roof |
townhouse | Two or three jettied storeys |
manor | A big house with a round tower |
tower | A round tower house with a witch-hat roof |
mushroom | A toadstool house |
random | Any of the above, chosen by the seed (default) |
The seed changes everything else: size, number of storeys, roof style and colour, chimney, dormers, turret and colours. Every seed is a different house, so you get endless variety from one node. Place it with translate and rotate_y; it stands on the ground.
fairy_village
A winding street lined on both sides with varied fairy_house buildings that face the street, with a cobbled path and trees in the gaps, and no overlapping houses.
houses(default 9),street_length(60 m),street_curve(how much the street wiggles),spacing(extra gap between neighbours).mix: varied, cottages, townhouses, towers or mushrooms.streetandtreesswitch the cobbles and trees on or off.seedchanges the whole village.
Open the Fairy village example to start from a finished street.
Towers and mushroom houses
fairy_tower: a round tower house with a stone plinth, jettied half-timbered plaster floors on brackets, arched windows, a door with steps and a curling witch-hat roof. Controls includeradius,height,floors,jetty,roof_height,roof_style(terracotta, slate, thatch, copper) andcurl. Great alone or attached to a cottage.mushroom_house: a bulging plaster stem with a round door and windows, a spotted cap (cap: red, orange, purple, blue or yellow) with gills underneath, a little chimney and stepping stones.
The crooked look
Every fairy node has a crooked parameter: the fairy-tale lean, bowed walls and wavy lines. 0 is perfectly straight; the default (0.45 on houses and villages) is gently storybook; push it higher for a properly wonky, hand-drawn look. Scrub it while watching the viewport.
Sculpted detail
Turn on sculpted on fairy_house or fairy_village for a hand-sculpted pass: wood grain and chipped edges on beams, rough stone, lumpy plaster and warped tiles. It is heavier (about 5 seconds and around 700k triangles per house), so switch it on at the end. sculpt_amount sets the strength. For more control, use the sculpt_detail node instead.
Building from parts
The fairy nodes are built from parts you can use directly for full control:
timber_house: the half-timbered body. Rubble plinth, plaster walls with real timber framing (posts, studs, rails, corner braces), gable walls that exactly fill a storybook roof, recessed arched windows with flower boxes, an arched plank door with a hood and steps. Doors and windows are a JSON list inopenings(face, type, positionu, width, height, sill).storybook_roof: a bell-cast gable roof (or a flared cone for turrets) with sagging ridge, flared corners, rounded overlapping tiles with moss, bargeboards and finials. Put it on atimber_housewith matching length / span / height / power / overhang andtranslatey = the house’swall_height.stone_chimney: a crooked rubble-stone stack with a corbelled cap and terracotta pots.
Keep the roof matched to the house with ch() expressions:
{"ops": [
{"op":"add","type":"timber_house","name":"house","params":{"width":7,"depth":5,"wall_height":3}},
{"op":"add","type":"storybook_roof","name":"roof","params":{
"length":"=ch(\"house.width\")", "span":"=ch(\"house.depth\")",
"translate":[0,"=ch(\"house.wall_height\")",0], "style":"slate"}},
{"op":"add","type":"stone_chimney","name":"chimney"},
{"op":"add","type":"merge","name":"cottage","inputs":["house","roof","chimney"]},
{"op":"add","type":"null","name":"OUT_cottage","inputs":["cottage"],"display":true}
]}The Storybook fairy cottage example is a complete, more detailed version. After assembling parts, the AI runs check_layout to make sure the roof sits on the house and the chimney isn’t floating.
Prompt ideas
- “A fairy village of 12 houses along a curving street, mostly townhouses, sculpted.”
- “A crooked witch’s tower with a slate roof next to a purple mushroom house.”
- “Three fairy cottages around a well, with a fence and trees, then send it to Unreal.”