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
- 0pieces
- 1constraints
- 2colliders
Parameters 37
gravityvector 3Gravity acceleration (m/s^2).
groundtoggleCollide with an infinite ground plane at y = ground_height.
ground_heightfloatY of the ground plane.
ground_frictionfloatFriction of ground and colliders (combined with piece friction by geometric mean).
densityfloatDefault density in kg/m^3 (prim `density` overrides). Mass = density * piece volume.
frictionfloatDefault piece friction coefficient (prim `friction` overrides). 0.3 slippery, 0.6 stone, 1.0 rubbery.
bouncefloatDefault restitution (prim `bounce` overrides). 0 = no bounce, 0.5 = bouncy.
linear_dampingfloatLinear velocity damping per second (air drag).
angular_dampingfloatAngular velocity damping per second.
collision_detailintSurface 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_iterationsintContact solver sweeps per substep. More = stiffer stacks and less creep on slopes.
max_depenetrationfloatMax speed (m/s) at which pre-existing overlaps are pushed apart (prevents pops from interpenetrating input).
activationmenuall: 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 3Centre for activation='radius'.
activation_radiusfloatRadius for activation='radius'.
activate_speedfloatA static (inactive) or sleeping piece becomes dynamic when hit with a relative normal speed above this (m/s).
initial_velocityvector 3Initial velocity added to all dynamic pieces (point `v` on the input is also used).
projectilemenuauto: a heavy ball is fired at the bbox centre of the pieces along +X. manual: use projectile_start/velocity. off: none.
projectile_startvector 3Manual projectile start position.
projectile_velocityvector 3Manual projectile velocity (m/s).
projectile_speedfloatAuto projectile speed (m/s).
projectile_radiusfloatProjectile radius; 0 = auto (8% of the pieces' bbox diagonal).
projectile_massfloatProjectile mass in kg; 0 = auto (3x the average piece mass).
projectile_frameintFrames after start_frame before the projectile is released (it waits at its start position).
show_projectiletoggleAppend the projectile sphere to the output (piece name 'projectile').
explosiontoggleApply an explosion impulse once.
explosion_centervector 3Explosion centre.
explosion_strengthfloatVelocity (m/s) added at the explosion centre, falling off linearly to 0 at explosion_radius. Also breaks glue weaker than the local kick.
explosion_radiusfloatExplosion radius.
explosion_frameintFrames after start_frame when the explosion happens.
glue_strength_scalefloatMultiplier for the glue network's `strength` (break threshold in m/s).
sleepingtoggleFreeze pieces that have come to rest (faster and removes jitter).
sleep_speedfloatSpeed (m/s, linear + angular*size) below which a resting piece counts as still.
sleep_framesintFrames a piece must stay still before it sleeps.
collider_resolutionintVoxel resolution (longest axis) of the static-collider SDF.
substepsintSolver substeps per frame. 10..20 for stable stacking; raise for fast projectiles.
start_frameintFrame 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.