Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


Surface Effector 2D reference

Explore the properties of the Surface Effector 2D used to create conveyor belts.
Read time 2 minutesLast updated 14 days ago

The Surface Effector 2D applies tangent forces along the surfaces of colliders used by the effector in an attempt to match a specified speed along the surface. This is analogous to a conveyor belt.
Colliders that you use with the effector would typically be set as non-triggers so that other colliders can come into contact with the surface.

Properties

Property

Function

Use Collider MaskEnable this to use the Collider Mask property. If this not enabled, the global collision matrix will be used as the default for all Collider 2Ds.
Collider MaskThe mask used to select specific Layers allowed to interact with the effector. Note that this option only displays if you have selected Use Collider Mask.
SpeedEnter the speed to keep along the surface.
Speed VariationEnter a value here to apply a random increase in speed, where Unity selects a random number between 0 and the Speed Variation value. Entering a negative number here will result in a random reduction in speed instead, where Unity selects a random negative number between 0 and the Speed Variation value.
Force ScaleEnter a value to scale the force that's applied when the effector attempts to meet the specified Speed along the surface. If this is 0, then Unity applies no force. If this is 1, then Unity applies full force. Note: Entering 1 to apply full force can counteract any other forces being applied to the target object and cause unwanted movement or behavior. It's recommended to enter a value less than 1 to prevent this issue from happening.
Use Contact ForceEnable this to have Unity apply force at the point of contact between the surface and the target collider. Enabling contact forces can cause the target object to rotate when in contact with a surface.
Use FrictionEnable this to enable friction between the collider and the surface it contacts.
Use BounceEnable this to enable bounce between the collider and the surface it contacts.