3D Building Mechanics

Complete building system for Three.js games with performance optimization, structural physics, and multiplayer networking.

Quick Start

import { SpatialHashGrid } from './scripts/spatial-hash-grid.js'; import { HeuristicValidator } from './scripts/heuristic-validator.js';

// Spatial indexing for fast queries const spatialIndex = new SpatialHashGrid(10); spatialIndex.insert(piece, piece.position); const nearby = spatialIndex.queryRadius(position, 15);

// Structural validation (Rust/Valheim style) const validator = new HeuristicValidator({ mode: 'heuristic' }); validator.addPiece(piece); const canPlace = validator.validatePlacement(newPiece);

Reference Files

Read these for detailed implementation guidance:

• references/performance-at-scale.md

• Spatial partitioning, chunk loading, instancing, LOD

• references/structural-physics-advanced.md

• Arcade vs heuristic vs realistic physics

• references/multiplayer-networking.md

• Authority models, delta sync, conflict resolution

Scripts

Performance (references/performance-at-scale.md)

• scripts/spatial-hash-grid.js

• O(1) queries for uniform distribution

• scripts/octree.js

• Adaptive queries for clustered bases

• scripts/chunk-manager.js

• World streaming for large maps

• scripts/performance-profiler.js

• Benchmarking utilities

Structural Physics (references/structural-physics-advanced.md)

• scripts/heuristic-validator.js

• Fast validation (Fortnite/Rust/Valheim modes)

• scripts/stability-optimizer.js

• Caching and batch updates

• scripts/damage-propagation.js

• Damage states, cascading collapse

• scripts/physics-engine-lite.js

• Optional realistic physics

Multiplayer (references/multiplayer-networking.md)

• scripts/delta-compression.js

• Only send changed state

• scripts/client-prediction.js

• Optimistic placement with rollback

• scripts/conflict-resolver.js

• Handle simultaneous builds

• scripts/building-network-manager.js

• Complete server/client system

Key Patterns

Spatial Indexing Selection

Pieces Distribution Use

<1,000 Any Array

1-5k Uniform SpatialHashGrid

1-5k Clustered Octree

5k+ Any ChunkManager + Octree

Physics Mode Selection

• Arcade (Fortnite): Connectivity only, instant collapse, best for combat

• Heuristic (Rust/Valheim): Stability %, predictable, best for survival

• Realistic: Full stress/strain, expensive, best for engineering sims

Multiplayer Pattern

Server-authoritative with client prediction. Use delta compression for sync.