Up to date

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

CollisionShape3D

Inherits: Node3D < Node < Object

A node that provides a Shape3D to a CollisionObject3D parent.

Description

A node that provides a Shape3D to a CollisionObject3D parent and allows to edit it. This can give a detection shape to an Area3D or turn a PhysicsBody3D into a solid object.

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

Tutorials

• Physics introduction

• 3D Kinematic Character Demo

• 3D Platformer Demo

• Third Person Shooter (TPS) Demo

Properties

bool	disabled	false
Shape3D	shape

Methods

void	make_convex_from_siblings()
void	resource_changed(resource: Resource)

---

Property Descriptions

bool disabled = false 🔗

• void set_disabled(value: bool)

• bool is_disabled()

A disabled collision shape has no effect in the world.

---

Shape3D shape 🔗

• void set_shape(value: Shape3D)

• Shape3D get_shape()

The actual shape owned by this collision shape.

---

Method Descriptions

void make_convex_from_siblings() 🔗

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

---

void resource_changed(resource: Resource) 🔗

Deprecated: Use Resource.changed instead.

This method does nothing.