游戏引擎 / 系统课时
区分碰撞体与可检测区域
区分碰撞体与可检测区域
角色撞到地板应停下,进入拾取范围却不应被挡住;向前探测障碍则只需要一次查询结果。本课把阻挡、触发和查询拆成不同的 Godot 4 物理能力,并通过一个会下落的测试物体验证它们不会互相替代。
学习目标
- 区分物理体、
CollisionShape3D、Area3D和射线查询的职责。 - 正确配置碰撞层、碰撞遮罩与区域监控。
- 使用
body_entered验证进入事件,同时保留地板的实体阻挡。
阻挡、触发与查询分别解决什么问题
阻挡由 StaticBody3D、CharacterBody3D、RigidBody3D 等物理体及其形状参与:墙壁、地板需要实体接触,角色的移动方法也必须处理碰撞。CollisionShape3D 本身只是把 BoxShape3D、CapsuleShape3D 等形状交给父级物理对象;单独放一个形状节点并不会形成墙。
触发使用 Area3D:它通过自身的形状监控重叠,发出进入、离开事件,但不会像实体墙一样阻止物体运动。拾取范围、检查点、伤害区适合采用这种方式。
查询使用 RayCast3D 或物理空间查询 API:按指定方向检测命中物和位置,不会自动触发拾取逻辑,也不会替角色执行避障。

搭建既能阻挡又能触发的测试场景
在 Godot 4 新建 Node3D 主场景,添加以下节点并设置形状。使用会自然下落的 RigidBody3D,可以在没有角色控制脚本的情况下独立验证本课;正式玩家换成 CharacterBody3D 后,区域监听方式不变。
- 添加
Floor (StaticBody3D),其子节点CollisionShape3D使用BoxShape3D;将地板顶面放在 Y=0,设置地板碰撞层为第 1 层。 - 添加
TestBody (RigidBody3D),子节点使用CapsuleShape3D,初始中心位于 Y=5;设置碰撞层为第 2 层、碰撞遮罩包含第 1 层,并将它加入player群组。 - 添加
PickupZone (Area3D),子节点使用半径约 0.8 米的SphereShape3D,把区域中心放在 Y=3;测试物体从区域外落入,之后继续穿过区域并停在地板上。
collision_layer 表示“我属于哪些层”,collision_mask 表示“我检测哪些层”。这里让测试物体扫描第 1 层地板,让区域扫描第 2 层测试物体。两者职责不同:区域发现重叠不等于为物体提供阻挡。
监听进入事件并观察输出
为 PickupZone 附加以下完整 GDScript。检测区不需要实体碰撞层,只需要监控目标所在的层。代码用群组过滤,避免其他刚体进入时误判为玩家。
extends Area3D
func _ready() -> void:
# 区域负责检测第 2 层的物体,不充当实体墙
collision_layer = 0
collision_mask = 1 << 1
monitoring = true
body_entered.connect(_on_body_entered)
func _on_body_entered(body: Node3D) -> void:
# 只处理加入 player 群组的测试物体或玩家
if body.is_in_group("player"):
print("玩家进入拾取区")预期输出(测试物体从区域外落入时):
玩家进入拾取区继续观察测试物体:它会穿过球形区域,但被地板的碰撞盒挡住。同一次进入通常只打印一次,离开后再次进入才会重新触发。
触发失败时检查哪些条件
如果物体穿过检测区却没有输出,依次确认 PickupZone 的 CollisionShape3D 已指定形状且未禁用、monitoring 为 true、区域遮罩包含物体所在层,以及物体确实加入 player 群组。body_entered 侦测物理体;若要侦测另一个 Area3D,应使用 area_entered,并检查相关区域的 monitorable 设置。
如果物体连地板也穿过去,先检查地板是否真有 StaticBody3D 和有效碰撞形状,再检查测试物体是否扫描地板所在层。不要通过把拾取区改成实体墙来修复地板问题:阻挡、触发与查询应独立配置,才能同时满足通行、事件和探测需求。