Skip to main content
Version: 5.x

Nodes > Particles > Particle ( Modify Attribute )

Particle ( Modify Attribute )

Modifies particle attributes. Use the Attribute dropdown to select which attribute to modify, and the Operation dropdown to determine how the value is applied.

The particle attributes available from this node are:

  • Position (vec3): the particle position
  • Velocity (vec3): the particle velocity
  • Life (float): the lifespan of the particle, in seconds
  • Force (vec3): external force acting on the particle
  • Mass (float): the mass of the particle
  • Color (rgba): the color of the particle
  • Size (float): the size of the particle
  • Matrix (mat4): the particle transformation matrix
  • Custom (user-defined): create a custom attribute with configurable name, channels, precision, and buffer capacity tracking

Inputs

NameTypeDescription
EnabledfloatToggle the node's operation. Non-zero values enable the node, zero disables it. Only visible when Dynamic Enable is checked.
DefaultfloatDefault value for custom attributes when particles first spawn. Only visible when Attribute is set to Custom and the node is outside the Spawn container.

Outputs

This node has no visible outputs. It modifies particle data in-place within the particle container.

Properties

NameTypeDescription
AttributedropdownThe particle attribute to modify. Options: Position, Velocity, Life, Force, Mass, Color, Size, Matrix, or Custom. The input port type and name will change based on the selected attribute.
OperationdropdownWhat operation to perform on the selected attribute. Set: overwrites the attribute with the input value. Add: adds the input value to the existing attribute. Multiply: multiplies the existing attribute by the input value.
Dynamic EnableboolExposes the Enabled input port to dynamically toggle the node's operation at runtime. When enabled, the node only executes if the Enabled input is non-zero.
AccessdropdownWhen using custom attributes, this option defines where the custom attribute can be accessed in the node graph. Local means the custom attribute can only be accessed in the same graph level as where it was created. For example, if the custom attribute was created inside a sub-graph, it can't be accessed outside the sub-graph. Global means the custom attribute can be accessed anywhere in the graph. Note that this increases the risk of potential attribute naming conflicts.
NamestringName of the custom attribute. If an attribute with this name already exists in the same scope, this node will reuse it instead of creating a new one.
ChannelsdropdownNumber of channels for the custom attribute (1, 2, 3, or 4). Determines whether the attribute is a float, float2, float3, or float4.
InfostringDisplays status messages. Shows "Reusing existing attribute" when an attribute with the same name already exists, or "Disabled" when the node is disabled via checkbox.
PrecisiondropdownPrecision format for custom attributes: Float 32 (full precision raw float32), Float 16 (half precision raw float16, default), or Normalized 8-bit (UNORM8, normalized 0-1 range). Higher precision uses more buffer capacity.
Buffer 1stringDisplays Buffer 1 usage in bits (e.g. "192/352 bits"). Buffer 1 has 352 bits total capacity. Shows combined usage of built-in and custom attributes.
Buffer 2stringDisplays Buffer 2 usage when Buffer 1 is full (e.g. "160/512 bits"). Buffer 2 has 512 bits total capacity. Shows ❌ warning if total usage exceeds 864 bits (352+512).
Was this page helpful?
Yes
No