StaticBody

Inherits: PhysicsBody < CollisionObject < Spatial < Node < Object

Category: Core

Brief Description

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.

A static body can also be animated by using simulated motion mode. This is useful for implementing functionalities such as moving platforms. When this mode is active, the body can be animated and automatically computes linear and angular velocity to apply in that frame and to influence other bodies.

Alternatively, 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).

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.