Docs menu · Fairy architecture

Documentation

Fairy architecture

Nine fairy_house variants: cottages, townhouses, a manor with a round tower, towers and a mushroom house
fairy_house with styles cottage, townhouse, manor, tower, mushroom and random, different seeds.

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.

styleWhat you get
cottageOne storey under a big swooping roof
townhouseTwo or three jettied storeys
manorA big house with a round tower
towerA round tower house with a witch-hat roof
mushroomA toadstool house
randomAny 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.
  • street and trees switch the cobbles and trees on or off.
  • seed changes 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 include radius, height, floors, jetty, roof_height, roof_style (terracotta, slate, thatch, copper) and curl. 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 in openings (face, type, position u, 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 a timber_house with matching length / span / height / power / overhang and translate y = the house’s wall_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:

A cottage from parts
{"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.”