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