Help guide

Physics Joint node

Updated June 21, 2026

Physics Joint node

Product media placeholder

Replace this area with a screenshot or short walkthrough video during the media sweep.

F367 step 5 v2 — one constraint between two bodies. Backed by the engine's impulse-joint set. Four kinds: `distance` (rope-like, fixed length between anchors), `revolute` (pin joint, free rotation around anchor), `prismatic` (slider along axis), `weld` (fully fixed pose). Wire `bodyA` / `bodyB` from `physicsBody.id` outputs OR from indexed entries of `physicsBodyStagger.bodyIds` to address bodies inside a stagger.

Type physicsJointCategory solversContext sharedDynamic ports noCompound no

Inputs

PortTypeDescription
worldanyWorld
bodyAfloatFirst body endpoint. Wire from `physicsBody.id` or an `arrayPick` of `physicsBodyStagger.bodyIds`.
bodyBfloatSecond body endpoint.
enabledfloatEnabled

Outputs

PortTypeDescription
idfloatEngine handle for the joint; useful for debug introspection.

Parameters

ParameterTypeDefaultDescription
jointKindenum"distance"Joint Kind options distance, revolute, prismatic, weld
localAnchorAstring[0,0]Body-A-local px offset of the joint anchor as JSON `[x, y]`. [0,0] = body centre.
localAnchorBstring[0,0]Body-B-local px offset as JSON `[x, y]`.
lengthfloat100Distance joint: rest length between anchors. Ignored for other kinds. min 0; step 10
lowerAnglefloatnullLower Angle (rad) — revolute only step 0.1
upperAnglefloatnullUpper Angle (rad) — revolute only step 0.1
lowerTranslationfloatnullLower Translation (px) — prismatic only
upperTranslationfloatnullUpper Translation (px) — prismatic only
localAxisAstring[1,0]Slider axis as a 2D vector [x, y]. Normalised internally.

Use cases

  • Tetherball — one ball jointed to a fixed anchor body via `distance`. Distance acts as the rope length; the ball swings under gravity.
  • Skeleton ragdoll — `revolute` joints between adjacent bone bodies with `lowerAngle` / `upperAngle` limits modelling joint stops. Triggered by a state-machine impulse.
  • Cloth banner — N bone bodies in a row + N-1 `distance` joints with low stiffness. Combined with a wind force from `physicsApplyForce` driven by Perlin-noise expression.

Related nodes

Envelope

Use physicsJoint as the node type inside a graph node envelope. Add id, optional params, optional connections, and optional activeWhen based on the guide context.

Generated source

Registry faster-motion-docs/node-registry.jsonCategory page /help/faster-motion/faster-motion-node-category-solvers/

Was this guide helpful?

Sunny Arora

Written by

Sunny Arora

Get technical deep dives delivered to your inbox

Join creators and developers who get exclusive insights, tutorials, and behind-the-scenes content every week.

No spam. Unsubscribe anytime.

Continue Exploring

You might also enjoy