StaticBody

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

float bounce

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.

Vector3 constant_linear_velocity

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.

float friction

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.

PhysicsMaterial 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.