Up to date

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

SeparationRayShape3D

Inherits: Shape3D < Resource < RefCounted < Object

Separation ray shape resource for 3D physics.

Description

3D separation ray shape to be added as a direct child of a PhysicsBody3D or Area3D using a CollisionShape3D node. A ray is not really a collision body; instead, it tries to separate itself from whatever is touching its far endpoint. It's often useful for characters.

Performance: Being a primitive collision shape, SeparationRayShape3D is fast to check collisions against.

Properties

float

length

1.0

bool

slide_on_slope

false

Property Descriptions

float length = 1.0

  • void set_length ( float value )

  • float get_length ( )

The ray's length.

bool slide_on_slope = false

  • void set_slide_on_slope ( bool value )

  • bool get_slide_on_slope ( )

If false (default), the shape always separates and returns a normal along its own direction.

If true, the shape can return the correct normal and separate in any direction, allowing sliding motion on slopes.