CollisionShape3D

继承： Node3D < Node < Object

向 CollisionObject3D 父级提供 Shape3D 的节点。

描述

向 CollisionObject3D 父级提供 Shape3D 并能够对其进行编辑的节点。可以为 Area3D 提供检测形状，也可以将 PhysicsBody3D 变为实体对象。

警告：非均匀缩放的 CollisionShape3D 可能无法按预期运行。请保持在所有轴上使用相同的缩放，需要时可以更改其 shape 资源代替。

教程

• 物理介绍

• 3D 动力学角色演示

• 3D 平台跳跃演示

• 第三人称射击（TPS）演示

属性

Color	debug_color	Color(0, 0, 0, 0)
bool	debug_fill	true
bool	disabled	false
Shape3D	shape

方法

void	make_convex_from_siblings()
void	resource_changed(resource: Resource)

---

属性说明

Color debug_color = Color(0, 0, 0, 0) 🔗

• void set_debug_color(value: Color)

• Color get_debug_color()

碰撞形状的颜色，在编辑器中显示，勾选编辑器顶部的 调试 > 显示碰撞形状 时也会在运行项目时显示。

注意：默认值为 ProjectSettings.debug/shapes/collision/shape_color。这里记录的 Color(0, 0, 0, 0) 值是占位符，不是实际的默认调试颜色。

---

bool debug_fill = true 🔗

• void set_enable_debug_fill(value: bool)

• bool get_enable_debug_fill()

如果为 true，则显示形状时除了显示线框外还会显示填充颜色。

---

bool disabled = false 🔗

• void set_disabled(value: bool)

• bool is_disabled()

禁用的碰撞形状对世界没有任何影响。

---

Shape3D shape 🔗

• void set_shape(value: Shape3D)

• Shape3D get_shape()

该碰撞形状拥有的实际形状。

---

方法说明

void make_convex_from_siblings() 🔗

将碰撞形状的形状设置为其所有凸面 MeshInstance3D 同级几何体的相加。

---

void resource_changed(resource: Resource) 🔗

已弃用： Use Resource.changed instead.

这个方法什么也不做。