structural-physics_skill

Overview

This skill provides structural validation and damage systems tailored for Three.js building games. It supports arcade, heuristic, and realistic physics modes to balance performance and realism for combat, survival, and engineering scenarios. Use it to determine placement validity, compute stability percentages, and simulate damage propagation and cascading collapse.

How this skill works

The system inspects piece connectivity, support relationships, and material properties to produce placement validation and a stability score. In arcade mode it uses connectivity rules for instant collapse behavior; in heuristic mode it computes stability percentages and predictable failure rules; in realistic mode it runs stress/strain simulations for detailed structural response. A damage subsystem maps hits, explosions, and fire into damage states and triggers cascade or collapse based on thresholds.

When to use it

• Implementing building stability for survival games (Rust/Valheim style).
• Fast, combat-oriented collapse behavior (Fortnite-style arcade mode).
• Engineering or sandbox simulations that need realistic stress calculations.
• Adding damage propagation, fire spread, or explosive radius effects to structures.
• Optimizing large structures with caching and batch stability updates.

Best practices

• Choose physics mode by gameplay need: arcade for responsiveness, heuristic for predictability, realistic for accuracy.
• Use the stability optimizer or caching layer for large or frequently updated structures.
• Tune material decay rates and damage thresholds to match desired fragility and repair mechanics.
• Run heuristic validation on placement to provide player feedback before committing new pieces.
• Limit realistic-mode calculations to crucial components or run them asynchronously to avoid frame spikes.

Example use cases

• A survival base builder that requires support checks and a stability percent to determine when parts fall.
• A battle royale game where destructive builds collapse instantly when critical connections break.
• A simulation tool that evaluates bridge or tower designs with stress/strain analysis on demand.
• A game feature where explosions propagate damage through connected pieces and cause cascading failures.
• Server-side batch validation to quickly verify many simultaneous placements during large raids or edits.