Particles node · simulation · time dependent
particle_solver
Particle solver. Emits particles from input 0 every frame and simulates them with gravity, drag/wind, curl-noise turbulence, optional attraction, ground-plane and collider bounces, then outputs the live particles as points (no prims). Emission source (input 0, re-cooked every frame so animated emitters work): * polygons -> random points on the surface (area weighted), initial velocity can follow the normal; * a `density` volume (e.g. from pyro_source / volume nodes) -> points inside voxels weighted by density; * points only -> particles born at random source points. Source point attribute `v` is inherited (scaled by `inherit_velocity`). Colliders (input 1): any closed mesh (converted to a signed distance grid) or a geometry with an `sdf` volume. Attractor (input 2): points / curve points that particles are pulled towards. Output point attributes: P, v (velocity m/s), age (s), life (s), id (int, unique, stable over time), pscale (radius-ish size), Cd (colour from `color_ramp` over normalised age age/life), Alpha (fade), plus detail `particle_count`. Sensible values: birth_rate 200-5000 /s, life 1-4 s, gravity (0,-9.8,0) for sparks or (0,0,0) with turbulence 2-5 for magic dust, drag 0.5-2 with wind to blow. Typical chain: sphere -> particle_solver, then particle_trails for streaks, or particles_to_spheres / volume_rasterize_particles for rendering.
Inputs
- 0source
- 1colliders
- 2attractor
Parameters 29
birth_ratefloatParticles born per second.
max_particlesintHard cap on live particles; emission stops at the cap.
velocityvector 3Initial velocity of new particles (m/s).
velocity_variancefloatRandom spherical velocity added at birth (m/s).
normal_speedfloatExtra speed along the surface normal when emitting from polygons.
inherit_velocityfloatMultiplier on the source point attribute `v` (if present).
lifefloatMean lifespan in seconds.
life_variancefloatRelative random variation of life (0..1).
gravityvector 3Gravity acceleration (m/s^2). (0,-9.8,0) for real-world.
dragfloatAir drag (1/s): velocity relaxes toward `wind` at this rate.
windvector 3Wind velocity (m/s) that drag pulls particles toward.
turbulencefloatCurl-noise turbulence acceleration strength. 0 = off.
turb_freqfloatTurbulence spatial frequency (1/m). Higher = smaller swirls.
turb_octavesintTurbulence noise octaves.
swirl_speedfloatHow fast the turbulence field evolves over time.
attract_strengthfloatAcceleration towards the nearest attractor point (input 2). Negative repels.
attract_radiusfloatOnly attract within this distance (0 = unlimited).
groundtoggleCollide with an infinite ground plane at y = ground_height.
ground_heightfloatHeight of the ground plane.
bouncefloatRestitution for ground and collider hits (0 = stick, 1 = elastic).
frictionfloatTangential velocity lost per collision (0..1).
kill_on_collisiontoggleDelete particles when they hit the ground or a collider.
collider_voxelfloatVoxel size for the collider SDF (0 = auto, 1/96 of collider size).
pscalefloatParticle size (pscale attribute).
pscale_variancefloatRelative random variation of pscale.
color_ramprampCd over normalised age (0 = birth, 1 = death); values are RGB lists.
[
[
0,
[
1,
0.95,
0.6
]
],
[
0.3,
[
1,
0.55,
0.15
]
],
[
0.7,
[
0.7,
0.2,
0.08
]
],
[
1,
[
0.25,
0.25,
0.28
]
]
]seedintRandom seed.
start_frameintFrame where the simulation starts
substepsintSolver substeps per frame
Use it
Add it from the node menu (right-click empty graph space or Tab, then type particle_solver), ask the AI for it by name, or add it with a graph op from the API or MCP:
{"op":"add","type":"particle_solver","name":"my_particle_solver","params":{},"inputs":["src"]}Any parameter can also be an expression such as "=sin(F*0.1)". See Parameters & expressions.