Log inGet started
World

Crumple Zone: Crash Test Dummy Simulator

Branchmain
Commit8d4e06b8c8

README.md

dummies

The crash test dummy API of the crashDummies package: require("crashDummies.dummies").

Builds ragdoll crash test dummies out of rigid bodies (capsules, boxes, spheres) joined by hinge and generic joints with anatomical limits and capped spring-damper "muscle tone", seats them at a vehicle's seat_<x> H-point frame, belts them to the vehicle's belt_<seat>_* anchors with compliant one-sided webbing (slack, retractor spool-out, pyro pretensioner, load limiter), and draws the webbing on every peer.

  • spawn(opts) -> handle — { kind, look, belt, vehicle, seat = "seat_driver", synced = true, tone = 0.5, handsInLap? }
  • despawn(handle), setTone(handle, 0..1)
  • instrument(handle) -> { read, reset, peak, trace, belt, stop } — motion probes on head / chest / pelvis
  • catalog(), looks(), belts() — the variants with their masses and settings
  • COLLISION_GROUP — the membership bit (21) every dummy collider carries

Called by game code and by the package's CrashDummy component (which runs the belts each physics step on the simulating peer). See the package README for the full contract and measured numbers.