Dynamics node · simulation · time dependent

rbd_solver

Rigid body destruction solver (XPBD rigid bodies, surface points vs per-piece signed distance fields). Input 0: pieces. Every distinct prim attribute `name` is one rigid body (output of voronoi_fracture, plane_fracture, assemble...). If there is no `name`, connected components are used. Optional per-piece prim attributes (from rbd_configure): `density`, `friction`, `bounce`, `active` (0 = static until hit, used when activation="attribute"). Optional point `v` = initial velocity. Input 1: optional glue constraint network from glue_constraints (2-point polylines with prim `strength` and `anchor`, points with `name`). Glue bonds hold pieces together and break when the relative velocity they must cancel within one substep exceeds `strength` (m/s) x glue_strength_scale. Input 2: optional static colliders (any mesh, closed or a single ground quad; or a geometry with an `sdf` volume). Output: the input pieces moved per frame (all attributes kept), point `v` (velocity), point+prim `active` (1 dynamic, 0 static/inactive), prim `sleeping`, detail `glue_broken` (count) and `rbd_bodies`. The projectile (if enabled and show_projectile) is appended as a piece named "projectile". Defaults give a nice shot with zero params: gravity, a ground plane at y=0 and an auto-aimed projectile fired at the bbox centre along +X (speed 12 m/s). Units: metres, kg (density 1000 = water-like), seconds. Typical: 20..300 pieces, substeps 10..20. Pieces settle and fall asleep. For a wall that only breaks near an impact: activation="radius" with activation_center/radius, or glue. Explosion: explosion=True, explosion_center, explosion_strength (m/s at the centre), explosion_radius.

Inputs

Parameters 37

gravityvector 3
Default [0, -9.81, 0]

Gravity acceleration (m/s^2).

groundtoggle
Default on

Collide with an infinite ground plane at y = ground_height.

ground_heightfloat
Default 0

Y of the ground plane.

ground_frictionfloat
Default 0.8Range 0 to 2

Friction of ground and colliders (combined with piece friction by geometric mean).

densityfloat
Default 1000Range 0.001 to …

Default density in kg/m^3 (prim `density` overrides). Mass = density * piece volume.

frictionfloat
Default 0.6Range 0 to 2

Default piece friction coefficient (prim `friction` overrides). 0.3 slippery, 0.6 stone, 1.0 rubbery.

bouncefloat
Default 0.15Range 0 to 1

Default restitution (prim `bounce` overrides). 0 = no bounce, 0.5 = bouncy.

linear_dampingfloat
Default 0.05Range 0 to …

Linear velocity damping per second (air drag).

angular_dampingfloat
Default 0.3Range 0 to …

Angular velocity damping per second.

collision_detailint
Default 8Range 2 to 40

Surface sample points per piece diameter used for contacts (each piece also gets a 16^3 signed distance grid). 6..12 typical; higher = tighter edge contact, slower.

contact_iterationsint
Default 3Range 1 to 20

Contact solver sweeps per substep. More = stiffer stacks and less creep on slopes.

max_depenetrationfloat
Default 2Range 0.01 to …

Max speed (m/s) at which pre-existing overlaps are pushed apart (prevents pops from interpenetrating input).

activationmenu
Default allOptions all attribute radius

all: every piece is dynamic. attribute: prim/point `active` (0 = static until hit). radius: only pieces whose centre lies within activation_radius of activation_center start dynamic; the others are static until something hits them faster than activate_speed.

activation_centervector 3
Default [0, 0, 0]

Centre for activation='radius'.

activation_radiusfloat
Default 1Range 0 to …

Radius for activation='radius'.

activate_speedfloat
Default 1Range 0 to …

A static (inactive) or sleeping piece becomes dynamic when hit with a relative normal speed above this (m/s).

initial_velocityvector 3
Default [0, 0, 0]

Initial velocity added to all dynamic pieces (point `v` on the input is also used).

projectilemenu
Default autoOptions auto manual off

auto: a heavy ball is fired at the bbox centre of the pieces along +X. manual: use projectile_start/velocity. off: none.

projectile_startvector 3
Default [-4, 1, 0]

Manual projectile start position.

projectile_velocityvector 3
Default [18, 0, 0]

Manual projectile velocity (m/s).

projectile_speedfloat
Default 12Range 0 to …

Auto projectile speed (m/s).

projectile_radiusfloat
Default 0Range 0 to …

Projectile radius; 0 = auto (8% of the pieces' bbox diagonal).

projectile_massfloat
Default 0Range 0 to …

Projectile mass in kg; 0 = auto (3x the average piece mass).

projectile_frameint
Default 0Range 0 to …

Frames after start_frame before the projectile is released (it waits at its start position).

show_projectiletoggle
Default on

Append the projectile sphere to the output (piece name 'projectile').

explosiontoggle
Default off

Apply an explosion impulse once.

explosion_centervector 3
Default [0, 0.5, 0]

Explosion centre.

explosion_strengthfloat
Default 10Range 0 to …

Velocity (m/s) added at the explosion centre, falling off linearly to 0 at explosion_radius. Also breaks glue weaker than the local kick.

explosion_radiusfloat
Default 1.5Range 0 to …

Explosion radius.

explosion_frameint
Default 0Range 0 to …

Frames after start_frame when the explosion happens.

glue_strength_scalefloat
Default 1Range 0 to …

Multiplier for the glue network's `strength` (break threshold in m/s).

sleepingtoggle
Default on

Freeze pieces that have come to rest (faster and removes jitter).

sleep_speedfloat
Default 0.08Range 0 to …

Speed (m/s, linear + angular*size) below which a resting piece counts as still.

sleep_framesint
Default 8Range 1 to …

Frames a piece must stay still before it sleeps.

collider_resolutionint
Default 64Range 8 to 256

Voxel resolution (longest axis) of the static-collider SDF.

substepsint
Default 12Range 1 to 100

Solver substeps per frame. 10..20 for stable stacking; raise for fast projectiles.

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 rbd_solver), ask the AI for it by name, or add it with a graph op from the API or MCP:

{"op":"add","type":"rbd_solver","name":"my_rbd_solver","params":{},"inputs":["src"]}

Any parameter can also be an expression such as "=sin(F*0.1)". See Parameters & expressions.