Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

PhysicsMaterial

Inherits: Resource < RefCounted < Object

Holds physics-related properties of a surface, namely its roughness and bounciness.

Description

Holds physics-related properties of a surface, namely its roughness and bounciness. This class is used to apply these properties to a physics body.

Properties

bool

absorbent

false

float

bounce

0.0

float

friction

1.0

bool

rough

false


Property Descriptions

bool absorbent = false

  • void set_absorbent ( bool value )

  • bool is_absorbent ( )

If true, subtracts the bounciness from the colliding object's bounciness instead of adding it.


float bounce = 0.0

  • void set_bounce ( float value )

  • float get_bounce ( )

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

Note: Even with bounce set to 1.0, some energy will be lost over time due to linear and angular damping. To have a PhysicsBody3D that preserves all its energy over time, set bounce to 1.0, the body's linear damp mode to Replace (if applicable), its linear damp to 0.0, its angular damp mode to Replace (if applicable), and its angular damp to 0.0.


float friction = 1.0

  • void set_friction ( float value )

  • float get_friction ( )

The body's friction. Values range from