achrefelouafi/basicproceduralbuilding

This project is a web based building configurator built with Three.js. It lets you design a small building in the browser by adjusting sliders for width, length, and height, plus a window seed number and a ground floor style. The interesting part is where the logic came from: the original design was made in Blender using a geometry nodes graph, and this project is a faithful TypeScript port of that same graph. The author checked the port instance by instance against Blender's own evaluated output, so the positions, rotations, and window choices match exactly for a given seed. Each wall of the building is treated as a grid of cells. The top row becomes the roof edge, the last column becomes a corner pillar, the ground row alternates between doors and shop windows, and the rest of the cells get one of two window styles chosen by the same random number method Blender uses internally. The building sits on a small floating platform with grass, soil, a plaza area, and simple low poly trees, bushes, and lamps, all generated in code rather than loaded from image textures. There are lighting presets for golden hour, day, and night, each changing the sky, fog, lighting rig, clouds, and how the windows glow after dark. A post processing stack adds bloom, tone mapping, vignette, grain, and color grading. The app also includes optional snow and rain effects with many adjustable settings, such as snowfall density and accumulation, or rain streaks and surface wetness, all applied directly to the building's materials without adding extra geometry. For people who want to edit the original 3D model, the README includes Blender 4.2 and newer command line steps to re export the building parts, dump the node graph to JSON, and generate reference data used to verify the web version still matches Blender after any changes. To run it locally you install dependencies and start the dev server with npm. This is a niche, technically focused project aimed at developers interested in procedural generation or porting Blender logic to the web, rather than a general purpose tool.