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

Parameters 23

gravityvector 3
Default [0, -9.81, 0]

Gravity (m/s^2).

densityfloat
Default 2Range 0.00001 to …

Surface mass density (kg/m^2) used to weight the particles.

pressurefloat
Default 1Range 0 to …

Target volume as a multiple of the rest volume (1 = keeps its volume, 1.3 = inflated balloon, 0 = no volume constraint).

volume_stiffnessfloat
Default 1Range 0 to 1

0..1 strength of the volume (pressure) constraint.

shape_stiffnessfloat
Default 0.05Range 0 to 1

0..1 per-substep pull toward the rigid rest shape (0 = pure balloon/jelly, 0.2 = firm rubber).

stretch_stiffnessfloat
Default 0.8Range 0 to 1

0..1 surface stretch stiffness.

bend_stiffnessfloat
Default 0.1Range 0 to 1

0..1 surface bending stiffness.

dampingfloat
Default 0.5Range 0 to …

Velocity damping per second.

initial_velocityvector 3
Default [0, 0, 0]

Initial velocity of all points.

pin_groupstring
Default pin

Point group of pinned points (follow the input animation).

pin_expressionstring
Default ""

Numpy expression for extra pinned points, e.g. 'P[:,1] > bbmax[1]-0.01'.

groundtoggle
Default on

Collide with a ground plane at y = ground_height.

ground_heightfloat
Default 0

Y of the ground plane.

spheretoggle
Default off

Collide with an analytic sphere (sphere_center, sphere_radius).

sphere_centervector 3
Default [0, 1, 0]

Collision sphere centre.

sphere_radiusfloat
Default 0.5Range 0 to …

Collision sphere radius.

thicknessfloat
Default 0.01Range 0 to …

Collision offset: how far the cloth stays away from colliders and the ground (m).

frictionfloat
Default 0.3Range 0 to 1

Collision friction 0..1 (fraction of sliding removed per substep).

collider_resolutionint
Default 64Range 8 to 256

Voxel resolution of the collider SDF (input 1).

self_collisiontoggle
Default off

Point-point self collision (slower). Particles keep 2*thickness apart; use a larger thickness for coarse meshes.

iterationsint
Default 2Range 1 to 50

Constraint iterations per substep.

substepsint
Default 10Range 1 to 100

Substeps per frame.

start_frameint
Default 1

Frame 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.