OptionalcapsulesWhole-body capsule proxies swept against the ground (#1185): each is a
from → to bone segment with a radius, and its lowest surface point
(min(from.y, to.y) − radius, sampled per endpoint against a heightfield)
must stay above the ground, so a hand, hip, elbow, or prop clipping through
the floor is no longer invisible the way the foot-point check leaves it. A
capsule on a missing or detached bone is a type error, not a silent skip
(the totality contract the point check does not carry). Omit to check only
footBones.
OptionalfootBones treated as ground-contact points. Defaults to both humanoid feet.
OptionalgroundGround height: plane scalar or (x, z) → y source. Defaults to 0.
OptionaljointOptional clinical-axis remap for rigs authored in semantic axes.
Motion clip to sample.
OptionalpathJSON path of the motion being checked. Defaults to $input.
OptionalphysicsMarker that opts the clip out of the ground-contact expectation: a deliberate pass-through (a phasing ghost, a stylized float) sets this and the matching warnings are suppressed.
OptionalrestOptional rest-frame remap for clinical authoring.
OptionalsampleSamples per second used by the validator. Defaults to 24.
Skeleton used for forward kinematics.
OptionaltoleranceAllowed penetration depth before violation. Defaults to 0.
Sample FK and compare configured foot points and valid capsule endpoints to scalar/height-source ground minus tolerance.