Geometry Nodes
BLUX writes simulation results as attributes on the BLUX_Render mesh (point domain). You can use them in any Geometry Nodes tree.
| Attribute | Meaning |
|---|---|
velocity |
Particle velocity. |
speed |
Velocity magnitude. |
material_id |
Which material the particle belongs to. |
temperature |
Particle temperature. |
damage |
Accumulated damage. |
wetness |
How wet the particle is. |
blux_color |
The particle colour. |
The attribute reader
Section titled “The attribute reader”Add the Particle Attribute Reader (the BLUX_Particle_Data node group) with the Particle Attributes (Geometry Nodes) button in Viewport Display, or from the Add menus.
It outputs these sockets:
Geometry, Position, Velocity, Speed, Temperature, Material ID, Damage, Wetness, Color, Is Liquid (material ID 0) and Is Debris (material ID 99).
Use it to drive procedural debris instancing, secondary particle scattering, foam trails or vertex deformation.
The BLUX_Particles modifier
Section titled “The BLUX_Particles modifier”Particles drawn as points, micro-grains or instances are the BLUX_Particles object, which carries a Geometry Nodes modifier. The controls are the modifier’s inputs, so you can change them without opening a node tree.
| Input | Default | What it does |
|---|---|---|
| Base Radius | set by BLUX | The drawn radius at Radius Scale 1. BLUX rewrites it on every sync: from the particle spacing for Atom, from the Output node’s Particle Radius for other solvers. Change Radius Scale instead. |
| Radius Scale | 1 | Size of each drawn particle relative to the automatic size (0.01 to 20). |
| Grains per Particle | 7 | Micro-grains only (Atom sand and snow as points). Grains each particle becomes (1 to 64). A new object starts with the Output node’s Micro-Grains value. |
| Grain Size Variation | 0.4 | Micro-grains only. Random spread of the grain size: 0.4 draws 0.6× to 1.4×. |
| Seed | 0 | Micro-grains only. Reshuffles every grain. |
| Grains in Viewport | off | Micro-grains only. Shows the grains in the viewport too. Slow for millions of particles. |
Radius Scale and the grain inputs are yours: BLUX never overwrites them after you set them, and carries them across a change of display mode. A tree from an older version of the add-on is rebuilt in place and keeps the values you had.
Inspecting data
Section titled “Inspecting data”For Impact shards, turn on Stream to Mesh Attributes in the Shard Inspector to write velocity, damage, cluster ID and sleep state into mesh attributes on every step or bake. Then use the Spreadsheet Editor or Geometry Nodes to inspect them.
Surfaces
Section titled “Surfaces”Liquid surfaces are streamed by a Geometry Nodes tree that imports the cached PLY files. It is generated for you. The surface carries velocity, normals and the other attributes, so Cycles motion blur works. See Surface meshing.