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 対応