StaticBody

Inherits: PhysicsBody < CollisionObject < Spatial < Node < Object

Static body for 3D physics.

Description

Static body for 3D physics. A static body is a simple body that is not intended to move. In contrast to RigidBody, they don't consume any CPU resources as long as they don't move.

Additionally, a constant linear or angular velocity can be set for the static body, so even if it doesn't move, it affects other bodies as if it was moving (this is useful for simulating conveyor belts or conveyor wheels).

Tutorials

Properties

float

bounce

Vector3

constant_angular_velocity

Vector3( 0, 0, 0 )

Vector3

constant_linear_velocity

Vector3( 0, 0, 0 )

float

friction

PhysicsMaterial

physics_material_override

Property Descriptions

Setter

set_bounce(value)

Getter

get_bounce()

The body's bounciness. Values range from 0 (no bounce) to 1 (full bounciness).

Deprecated, use PhysicsMaterial.bounce instead via physics_material_override.


  • Vector3 constant_angular_velocity

Default

Vector3( 0, 0, 0 )

Setter

set_constant_angular_velocity(value)

Getter

get_constant_angular_velocity()

The body's constant angular velocity. This does not rotate the body, but affects other bodies that touch it, as if it was in a state of rotation.


Default

Vector3( 0, 0, 0 )

Setter

set_constant_linear_velocity(value)

Getter

get_constant_linear_velocity()

The body's constant linear velocity. This does not move the body, but affects other bodies that touch it, as if it was in a state of movement.


Setter

set_friction(value)

Getter

get_friction()

The body's friction, from 0 (frictionless) to 1 (full friction).

Deprecated, use PhysicsMaterial.friction instead via physics_material_override.


Setter

set_physics_material_override(value)

Getter

get_physics_material_override()

The physics material override for the body.

If a material is assigned to this property, it will be used instead of any other physics material, such as an inherited one.