mcpField
S
structural-physics

structural-physics

github.com/bbeierle12Development972 installsUpdated 1d ago
Repository

About structural-physics

Structural Physics is a building-mechanics skill for validating stability and modeling damage. It offers arcade, heuristic, and realistic physics modes for game and engineering simulations.

Key features

  1. 01Validate piece placement and stability
  2. 02Model damage states and propagation
  3. 03Simulate fire spread and cascading collapse
  4. 04Optimize stability checks with caching and batches
  5. 05Choose arcade, heuristic, or realistic modes

Use cases

  1. 01Check whether a building piece can be placed
  2. 02Model structural damage in a survival game
  3. 03Simulate stress and strain in an engineering scenario

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/bbeierle12/skill-mcp-claude --skill structural-physics

After installing, type/structural-physicsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

_meta.json
references/
structural-physics-advanced.md
scripts/
damage-propagation.js
heuristic-validator.js
physics-engine-lite.js
stability-optimizer.js

Details

From the project README

Structural Physics

Stability validation and damage systems for building mechanics.

Quick Start

import { HeuristicValidator } from './scripts/heuristic-validator.js';
import { DamageSystem } from './scripts/damage-propagation.js';

// Rust/Valheim style stability
const validator = new HeuristicValidator({ mode: 'heuristic' });
validator.addPiece(piece);
const result = validator.validatePlacement(newPiece);
// result: { valid: true, stability: 0.85, supports: [...] }

// Damage and collapse
const damage = new DamageSystem(validator);
damage.applyDamage(piece, 50, 'physical');
damage.applyExplosiveDamage(position, 100, 10); // radius damage

Reference

See references/structural-physics-advanced.md for:

  • Physics mode comparison (arcade vs heuristic vs realistic)
  • Material properties and decay rates
  • Damage state thresholds
  • Cascade mechanics

Scripts

  • scripts/heuristic-validator.js - Fast validation (Fortnite/Rust/Valheim modes)
  • scripts/stability-optimizer.js - Caching and batch updates for large structures
  • scripts/damage-propagation.js - Damage states, fire spread, cascading collapse
  • scripts/physics-engine-lite.js - Optional realistic stress/strain simulation

Physics Modes

  • Arcade (Fortnite): Connectivity only, instant collapse, best for combat
  • Heuristic (Rust/Valheim): Stability %, predictable rules, best for survival
  • Realistic: Full stress/strain, computationally expensive, best for engineering sims

Comments

Markdown supported