mcpField
B
building-mechanics

building-mechanics

github.com/bbeierle12开发974 次安装1 天前更新
代码仓库

关于 building-mechanics

3D Building Mechanics 是面向 Three.js 游戏开发者的建筑系统技能与脚本集，涵盖空间查询、结构稳定性、规模化性能和多人同步。

主要功能

  1. 01空间哈希网格与八叉树
  2. 02区块加载与性能分析
  3. 03结构稳定性与损伤传播
  4. 04可选的真实物理引擎
  5. 05增量同步与冲突处理

适用场景

  1. 01高效查询附近的建筑部件
  2. 02验证游戏中的建筑稳定性
  3. 03流式加载大型建筑世界
  4. 04同步多人建造状态

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/bbeierle12/skill-mcp-claude --skill building-mechanics

安装后在 Claude Code 中输入/building-mechanics确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

_meta.json
references/
multiplayer-networking.md
performance-at-scale.md
structural-physics-advanced.md
scripts/
building-network-manager.js
chunk-manager.js
client-prediction.js
conflict-resolver.js
damage-propagation.js
delta-compression.js
heuristic-validator.js
octree.js
performance-profiler.js
physics-engine-lite.js
spatial-hash-grid.js
stability-optimizer.js

详细介绍

3D 建筑力学

适用于 Three.js 游戏的完整建筑系统，提供性能优化、结构物理和多人网络功能。

快速开始

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);

参考文件

阅读以下文件，了解详细的实现指南：

  • references/performance-at-scale.md - 空间分区、分块加载、实例化、LOD
  • references/structural-physics-advanced.md - 街机式、启发式和逼真物理
  • references/multiplayer-networking.md - 权威模型、增量同步、冲突解决

脚本

性能（references/performance-at-scale.md）
  • scripts/spatial-hash-grid.js - 为均匀分布提供 O(1) 查询
  • scripts/octree.js - 为聚集的基地提供自适应查询
  • scripts/chunk-manager.js - 大型地图的世界流式加载
  • scripts/performance-profiler.js - 基准测试工具
结构物理（references/structural-physics-advanced.md）
  • scripts/heuristic-validator.js - 快速验证（Fortnite/Rust/Valheim 模式）
  • scripts/stability-optimizer.js - 缓存和批量更新
  • scripts/damage-propagation.js - 损伤状态、连锁坍塌
  • scripts/physics-engine-lite.js - 可选的逼真物理
多人游戏（references/multiplayer-networking.md）
  • scripts/delta-compression.js - 仅发送已更改的状态
  • scripts/client-prediction.js - 乐观放置并支持回滚
  • scripts/conflict-resolver.js - 处理同时建造的情况
  • scripts/building-network-manager.js - 完整的服务端/客户端系统

核心模式

空间索引选择
部件数量分布使用方案
<1,000任意Array
1-5k均匀SpatialHashGrid
1-5k聚集Octree
5k+任意ChunkManager + Octree
物理模式选择
  • 街机式（Fortnite）：仅考虑连通性，立即坍塌，最适合战斗
  • 启发式（Rust/Valheim）：稳定性百分比、结果可预测，最适合生存游戏
  • 逼真：完整的应力/应变计算，开销大，最适合工程模拟
多人游戏模式

采用服务端权威模式并配合客户端预测。使用增量压缩进行同步。

评论

支持 Markdown