building-mechanics
具有空间索引、结构物理和多人联网功能的Three.js 3D建筑系统。创建生存游戏、沙盒建造者或任何有玩家建造结构的游戏时使用。涵盖性能优化(空间哈希网格、八叉树、区块加载)、结构验证(街机/启发式/逼真物理模式)和多人同步(增量压缩、客户端预测、冲突解决)。
📖 中文导读:具有空间索引、结构物理和多人联网功能的Three.js 3D建筑系统。创建生存游戏、沙盒建造者或任何有玩家建造结构的游戏时使用。涵盖性能优化(空间哈希网格、八叉树、区块加载)、结构验证(街机/启发式/逼真物理模式)和多人同步(增量压缩、客户端预测、冲突解决)。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: building-mechanics description: 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 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, LODreferences/structural-physics-advanced.md- Arcade vs heuristic vs realistic physicsreferences/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 distributionscripts/octree.js- Adaptive queries for clustered basesscripts/chunk-manager.js- World streaming for large mapsscripts/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 updatesscripts/damage-propagation.js- Damage states, cascading collapsescripts/physics-engine-lite.js- Optional realistic physics
Multiplayer (references/multiplayer-networking.md)
scripts/delta-compression.js- Only send changed statescripts/client-prediction.js- Optimistic placement with rollbackscripts/conflict-resolver.js- Handle simultaneous buildsscripts/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.