OptionalanchorAttachment point in bodyA's local frame. Defaults to its origin.
OptionalanchorAttachment point in bodyB's local frame. Defaults to its origin.
OptionalaxisReference axis of the swing cone in bodyA's local frame, only
meaningful when SphericalJointDescriptor.limits is present.
Defaults to +Y, §7a's up.
First constrained body. Must differ from JointDescriptorBase.bodyB.
Second constrained body.
OptionalbreakReaction force, in newtons, above which the joint breaks (§28 "break force"). Omitted means the joint never breaks under load.
Enforced by PhysicsWorld, not by the solver (plan P6-2): the world reads
the joint's reaction impulse after every fixed step, divides by the step
delta, and destroys the joint when the magnitude exceeds this value —
strictly, so a joint sitting exactly at its threshold survives. Requires an
adapter that reports reactions (SolverJointAccess.reportsJointReactions);
addJoint refuses a breakable joint on an adapter that does not, rather
than accepting a threshold it can never enforce.
OptionalbreakReaction torque, in newton-metres, above which the joint breaks (§28 "break torque"). See JointDescriptorBase.breakForce; either threshold alone is enough to break the joint.
OptionalcollisionWhether the two jointed bodies still collide with each other (§28
"collision enable/disable"). Defaults to false, the usual choice for
bodies that overlap by construction.
OptionallimitsSwing cone and optional twist, or free rotation when omitted.
A ball joint: three rotational degrees of freedom about a shared point (§28 "spherical/ball").
"3d"only (plan P6-1).