Skip to main content

Physics Material

Whether you want to create a static, rigid body, kinematic rigid body, or character controller, one thing is true:

The values set in this component help determine how the physics body will react during collision.

For example, when a physics body collides with another the average of their physics material values (e.g. static friction, dynamic friction, restitution) will be used to resolve the collision.

Physics Material Component

Physics Material

physics_material

Physics material which represents a set of physical surface properties.

contactVelocity

Vector3

Default: [0,0,0]

The velocity applied to the contact between this physics body and another body. Only applies if modifyContact is true.

dynamicFriction

Float

Default: 0.5

The friction coefficient applied between this surface and another surface if they are moving relative to each other. Usually a value from 0 to 1. A value of zero feels like ice, a value of 1 will make it very hard to get the object moving. If set to greater than staticFriction, the effective value of staticFriction will be increased to match. Resulting dynamic friction of a physics body colliding with another is determined by the average of both bodies' dynamic friction coefficient.

isTrigger

Boolean

Default: false

Whether to consider the geometry associated to this physics material as a trigger or not.

modifyContact

Boolean

Default: false

Whether to modify the contact when this physics body collides with another body.

restitution

Float

Default: 0

Restitution coefficient, or bounciness of surface. A coefficient of 0 indicates as little bounce as possible, higher values up to 1.0 result in more bounce. Should be in the range [0,1]. Resulting bounciness of a physics body colliding with another is determined by the average of both bodies' restitution.

staticFriction

Float

Default: 0.5

The friction coefficient applied between this surface and another surface if they are not moving lateral to each other. Usually a value from 0 to 1. A value of zero feels like ice, a value of 1 will make it very hard to get the object moving. Resulting static friction of a physics body colliding with another is determined by the average of both bodies' static friction coefficient.

For further information on the modifyContact and contactVelocity attributes, refer to Contact Velocity.