Trigger Shape Block reference

The Trigger Shape Block defines a shape that detects particle collisions without physically interacting with the particles. Instead of blocking or altering particle movement, it triggers specific events when particles collide with it. You can use this block in combination with a Trigger Event Block set to Collide mode to spawn child particles or perform other actions.

If you change the Behavior property of the block, the Block changes to the following:

• A Collision Shape Block if you set Behavior to Collision.
• A Kill Shape Block if you set Behavior to Kill.

Block compatibility

You can add the Trigger Shape Block to the following Contexts:

• Initialize
• Update

To add a Trigger Shape Block to your graph, open the menu for adding a graph element then select Collision > Trigger Shape.

Block settings

Property	Type	Description
Shape	Enum	Sets the shape for particles to collide with. For more information, refer to the Shape dropdown section.
Mode	Enum	Specifies how particles interact with the collider. The options are: Solid: Destroys particles when they enter the shape. If you set Shape to Plane, particles collide with the plane when they travel away from the normal of the plane. Inverted: Destroys particles when they leave the shape. If you set Shape to Plane, particles collide with the plane when they travel in the same direction as the normal of the plane.
Radius Mode	Enum	Sets the collision radius of the particles. The options are: None: Sets the collision radius to zero. From Size: Sets the collision radius for each particle to its individual size. Custom: Sets the collision radius to the value of Radius in the Block properties.
Collision Attributes	Enum	Specifies whether Unity stores data in the collision attributes of particles. The options are: No Write: Doesn't write or store collision attributes. Write Punctual Contact only: Updates the collision attribute only when a specific, single-point collision occurs. This setting has no effect in a Trigger Shape Block. Write Always: Updates the collision attribute every time a collision occurs.

Shape dropdown

Shape	Description
Sphere	Sets the collision shape as a spherical volume.
Oriented Box	Sets the collision shape as a box volume.
Cone	Sets the collision shape as truncated cone volume.
Plane	Sets the collision shape as a flat plane with infinite length and width.
Signed Distance Field	Sets the collision shape as a signed distance field (SDF), so you can create precise complex collision with an existing asset. To generate a signed distance field asset, use the SDF Bake Tool or an external digital content creation (DCC) tool.

Block properties

Input	Type	Description
Sphere	Sphere	Sets the sphere that particles collide with. This property is available only if you set Shape to Sphere.
Box	OrientedBox	Sets the box that particles collide with. This property is available only if you set Shape to Box.
Cone	Cone	Sets the cone that particles collide with. This property is available only if you set Shape to Cone.
Plane	Plane	Sets the plane that particles collide with. This property is available only if you set Shape to Plane.
Distance Field	Signed distance field	Sets the signed distance field (SDF) that particles collide with. This property is available only if you set Shape to Signed Distance Field.
Field Transform	Transform	Sets the position, size, and rotation of the Distance Field. This property is available only if you set Shape to Signed Distance Field.
Radius	Float	Sets the collision radius of the particles. This property is available only if you set Radius Mode to Custom.

Inspector window properties

Property	Type	Description
Behavior	Enum	Specifies how particles behave when they collide with the shape. The options are: None: Changes the Block to a Trigger Shape Block, so particles don't bounce off the shape. Collision: Changes the Block to a Collision Shape Block, so particles bounce off the shape. Kill: Destroys a particle when it collides with the shape.