Description

A node that provides aShape3D to aCollisionObject3D parent and allows to edit it. This can give a detection shape to anArea3D or turn aPhysicsBody3D into a solid object.

Warning: A non-uniformly scaledCollisionShape3D will likely not behave as expected. Make sure to keep its scale the same on all axes and adjust itsshape resource instead.

Tutorials

• Physics introduction

• 3D Kinematic Character Demo

• 3D Platformer Demo

• Third Person Shooter (TPS) Demo

Properties

Methods

Property Descriptions

Colordebug_color =Color(0,0,0,0)🔗

• voidset_debug_color(value:Color)

• Colorget_debug_color()

The collision shape color that is displayed in the editor, or in the running project ifDebug > Visible Collision Shapes is checked at the top of the editor.

Note: The default value isProjectSettings.debug/shapes/collision/shape_color. TheColor(0,0,0,0) value documented here is a placeholder, and not the actual default debug color.

booldebug_fill =true🔗

• voidset_enable_debug_fill(value:bool)

• boolget_enable_debug_fill()

Iftrue, when the shape is displayed, it will show a solid fill color in addition to its wireframe.

booldisabled =false🔗

• voidset_disabled(value:bool)

• boolis_disabled()

A disabled collision shape has no effect in the world.

Shape3Dshape🔗

• voidset_shape(value:Shape3D)

• Shape3Dget_shape()

The actual shape owned by this collision shape.

Method Descriptions

voidmake_convex_from_siblings()🔗

Sets the collision shape's shape to the addition of all its convexedMeshInstance3D siblings geometry.

voidresource_changed(resource:Resource)🔗

Deprecated: UseResource.changed instead.

This method does nothing.