Living Lanes: townsfolk crowds with daily routines and reactions
Market Day at Mirage Wells is the showcase: forty townsfolk in a desert oasis market, each with a role (merchant, porter, farmhand, monk, pilgrim, child, elder, servant, fisher, entertainer, beggar, watchman, soldier, samurai retainer, cook, tea servant), a temperament and a daily schedule written as plain text on the world's shared clock. Stalls open at dawn, porters carry sacks, farmhands work the rice paddies, pilgrims walk in procession, everyone eats at noon and goes home at dusk, and the night watch walks the lanes until morning. Throw a firecracker, knock someone out or draw a blade and the town reacts by temperament: people glance, gawk, flee, hide indoors or run to the nearest watchman to report you. You play a thief with one market day to fill your purse; your thief rank and knacks are saved between visits.
Every player sees the same person doing the same thing at the same time.
Build your own town with it
- townsfolkKit 1.2.6: townsfolk, 16 roles, schedules, activity spots, homes, groups, reactions, crowd level of detail, multiplayer. Search ZeroMind for "fill my town with people who follow a daily schedule" to find its step-by-step guide. It brings navKit 1.5.6 and aiKit 1.3.18 with it.
- humanBodyKit 1.2.2: generated humanoid bodies in 17 outfits and three looks (realistic, painted, toon), 30 poses and 17 props, for any NPC.
Every role, look and outfit swaps with one setting; the whole crowd's look is one field on the Town.
Performance (townsfolkKit 1.2.6, humanBodyKit 1.2.2, navKit 1.5.6, aiKit 1.3.18)
Measured in Mirage Wells, in play, with all 40 townsfolk at market hours (2026-11-17):
- Desktop app, quiet machine: 59-62 fps (16.2 ms median frame); the crowd adds about 1.6 ms. Desktop app, heavily loaded shared machine: 37-43 fps; the crowd adds about 6 ms and is what stands between the scene and 60 there (the scene alone fits a 60 fps frame).
- Web browser (1.2.5, a minute at noon): 20-23 fps, the crowd about 3 ms a frame and never over 33 ms. The browser's limit comes from the engine, not the kit: issues #19874 (stepping paced at about 21 a second) and #26683 (Luau slower in the browser).
- People off screen are not animated, standing walkers write nothing, no memory burst on the hour, and townsfolk hear noises the moment they happen (aiKit's
AI.onNoise). - Tablet: not measured. Press F3 in play to see your own numbers.
Built on navKit, aiKit, worldClockKit, soundstage, interactKit, desertKit, cropsKit and saveKit.
Comments · 0
Open discussion, no rating attached. Ask questions, swap notes, follow threads.
Documented parts · 8
- desert_oasisValley_c35dbd88.terrainDataterraindata
- humanBodyKitpackage
- MarketDaycomponent
- MarketLevelmodule
- MarketTownmodule
- partsmodule
- PerfReadoutmodule
- townsfolkKitpackage