mcpField
T
threejs-procedural-architecture

threejs-procedural-architecture

github.com/scottsttsCreative & media946101 installsUpdated 6d ago
Repository

About threejs-procedural-architecture

A skill for designing procedural building generators that create an inspectable plan before emitting meshes. It covers massing, façade semantics, architectural modules, and geometry compilation for Three.js.

Key features

  1. 01Building mass grammar
  2. 02Exposed-surface graph planning
  3. 03Semantic façade and roof placement
  4. 04Material-slot mesh compilation
  5. 05Topology and shadow diagnostics

Use cases

  1. 01Planning procedural building layouts
  2. 02Generating façades with semantic modules
  3. 03Checking geometry across varied seeds

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/scottstts/threejs-awesome-graphics-agent-skills --skill threejs-procedural-architecture

After installing, type/threejs-procedural-architecturein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
assets/procedural-financial-tower/
THIRD_PARTY_LICENSES.md
examples/procedural-financial-tower/
shadow-clipmaps.js
building-system.js
references/
grammar-and-mesh-compiler.md

Details

From the project README

Procedural Architecture

Separate design planning from mesh emission. A building generator should produce an inspectable plan before it produces triangles.

This skill contains exemplary examples and assets beyond descriptive guidance, they're worth studying, referencing, or even copying. Use them sufficiently when relevant and do NOT blindly skip them.

Required architecture

settings
  → mass grammar
  → exposed-surface graph
  → façade/roof placements
  → module registry
  → material-slot mesh writer
  → geometries

Read references/grammar-and-mesh-compiler.md before implementing the generator.

Read the procedural financial tower compiler for seeded tier planning, semantic façade placement, reserved zones, material-slot BufferGeometry output, projected detail, and mechanism-specific diagnostics.

Rules

  • Massing, façade rhythm, and detail modules are separate layers.
  • Resolve exposed edges before façade placement. Do not decorate hidden internal faces.
  • Modules own semantic anchors and construction depth, not global building coordinates.
  • Compile by material slot to reduce draw calls without destroying material separation.
  • Preserve real dimensions for floor height, bay width, trim projection, and texture density.
  • Randomness may select among valid designs; it must not repair invalid geometry.
  • Provide topology, façade ownership, material/geometry, and shadow diagnostics appropriate to the renderer path.

Acceptance

The generated building must survive:

  • silhouette-only view;
  • flat untextured material;
  • grazing light;
  • close inspection of corners and roof transitions;
  • seed variation without broken bays, overlapping ownership, or floating ornament;
  • triangle and module-count reporting.

Routing boundary

Use $threejs-procedural-geometry for a reusable profile, sweep, ring, or mesh writer without a building grammar. This skill owns massing, façade semantics, architectural modules, and building-plan compilation.

Comments

Markdown supported