Cloth node · simulation · time dependent
soft_body
Soft body on a closed surface mesh without tetrahedra: XPBD stretch + bend constraints on the surface, a global volume constraint (`pressure` x rest volume) and optional global shape matching that pulls toward the rigid rest shape. Good for balloons, jelly, rubber toys and squishy props that drop and wobble. Input 1: colliders (SDF). Output: deformed mesh with N and point `v`. Defaults: a jelly-like body that falls onto the ground and wobbles.
Inputs
- 0mesh
- 1colliders
Parameters 23
gravityvector 3Gravity (m/s^2).
densityfloatSurface mass density (kg/m^2) used to weight the particles.
pressurefloatTarget volume as a multiple of the rest volume (1 = keeps its volume, 1.3 = inflated balloon, 0 = no volume constraint).
volume_stiffnessfloat0..1 strength of the volume (pressure) constraint.
shape_stiffnessfloat0..1 per-substep pull toward the rigid rest shape (0 = pure balloon/jelly, 0.2 = firm rubber).
stretch_stiffnessfloat0..1 surface stretch stiffness.
bend_stiffnessfloat0..1 surface bending stiffness.
dampingfloatVelocity damping per second.
initial_velocityvector 3Initial velocity of all points.
pin_groupstringPoint group of pinned points (follow the input animation).
pin_expressionstringNumpy expression for extra pinned points, e.g. 'P[:,1] > bbmax[1]-0.01'.
groundtoggleCollide with a ground plane at y = ground_height.
ground_heightfloatY of the ground plane.
spheretoggleCollide with an analytic sphere (sphere_center, sphere_radius).
sphere_centervector 3Collision sphere centre.
sphere_radiusfloatCollision sphere radius.
thicknessfloatCollision offset: how far the cloth stays away from colliders and the ground (m).
frictionfloatCollision friction 0..1 (fraction of sliding removed per substep).
collider_resolutionintVoxel resolution of the collider SDF (input 1).
self_collisiontogglePoint-point self collision (slower). Particles keep 2*thickness apart; use a larger thickness for coarse meshes.
iterationsintConstraint iterations per substep.
substepsintSubsteps per frame.
start_frameintFrame where the simulation starts
Use it
Add it from the node menu (right-click empty graph space or Tab, then type soft_body), ask the AI for it by name, or add it with a graph op from the API or MCP:
{"op":"add","type":"soft_body","name":"my_soft_body","params":{},"inputs":["src"]}Any parameter can also be an expression such as "=sin(F*0.1)". See Parameters & expressions.