How do I install the Building Mechanics skill?

Run npx skillmds@latest add diegosouzapw/building-mechanics in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Building Mechanics safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Building Mechanics?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Building Mechanics free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Building Mechanics?

diegosouzapw (@diegosouzapw) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Building Mechanics by diegosouzapw — Agent Skill

Name: Building Mechanics
Rating: 4.5 (4 reviews)
Author: diegosouzapw

Building Mechanics

Three.js 3D building system with spatial indexing, structural physics, and multiplayer networking. Use when creating survival games, sandbox builders, or any game with player-constructed structures. Covers performance optimization (spatial hash grids, octrees, chunk loading), structural validation (arcade/heuristic/realistic physics modes), and multiplayer sync (delta compression, client prediction, conflict resolution).

diegosouzapw Updated Sep 8, 2026 54 repo stars

File contents

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.

---name: building-mechanicsdescription: Three.js 3D building system with spatial indexing, structural physics, and multiplayer networking. Use when creating survival games, sandbox builders, or any game with player-constructed structures. Covers performance optimization (spatial hash grids, octrees, chunk loading), structural validation (arcade/heuristic/realistic physics modes), and multiplayer sync (delta compression, client prediction, conflict resolution).---# 3D Building MechanicsComplete building system for Three.js games with performance optimization, structural physics, and multiplayer networking.## Quick Start```javascriptimport { SpatialHashGrid } from './scripts/spatial-hash-grid.js';import { HeuristicValidator } from './scripts/heuristic-validator.js';// Spatial indexing for fast queriesconst 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 FilesRead 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 PatternServer-authoritative with client prediction. Use delta compression for sync.

Frequently asked questions