游戏引擎 / 系统课时

区分碰撞体与可检测区域

区分碰撞体与可检测区域

角色撞到地板应停下,进入拾取范围却不应被挡住;向前探测障碍则只需要一次查询结果。本课把阻挡、触发和查询拆成不同的 Godot 4 物理能力,并通过一个会下落的测试物体验证它们不会互相替代。

学习目标

  • 区分物理体、CollisionShape3D、Area3D 和射线查询的职责。
  • 正确配置碰撞层、碰撞遮罩与区域监控。
  • 使用 body_entered 验证进入事件,同时保留地板的实体阻挡。

阻挡、触发与查询分别解决什么问题

阻挡由 StaticBody3D、CharacterBody3D、RigidBody3D 等物理体及其形状参与:墙壁、地板需要实体接触,角色的移动方法也必须处理碰撞。CollisionShape3D 本身只是把 BoxShape3D、CapsuleShape3D 等形状交给父级物理对象;单独放一个形状节点并不会形成墙。

触发使用 Area3D:它通过自身的形状监控重叠,发出进入、离开事件,但不会像实体墙一样阻止物体运动。拾取范围、检查点、伤害区适合采用这种方式。

查询使用 RayCast3D 或物理空间查询 API:按指定方向检测命中物和位置,不会自动触发拾取逻辑,也不会替角色执行避障。

实体阻挡、区域触发与射线查询的区别

搭建既能阻挡又能触发的测试场景

在 Godot 4 新建 Node3D 主场景,添加以下节点并设置形状。使用会自然下落的 RigidBody3D,可以在没有角色控制脚本的情况下独立验证本课;正式玩家换成 CharacterBody3D 后,区域监听方式不变。

  1. 添加 Floor (StaticBody3D),其子节点 CollisionShape3D 使用 BoxShape3D;将地板顶面放在 Y=0,设置地板碰撞层为第 1 层。
  2. 添加 TestBody (RigidBody3D),子节点使用 CapsuleShape3D,初始中心位于 Y=5;设置碰撞层为第 2 层、碰撞遮罩包含第 1 层,并将它加入 player 群组。
  3. 添加 PickupZone (Area3D),子节点使用半径约 0.8 米的 SphereShape3D,把区域中心放在 Y=3;测试物体从区域外落入,之后继续穿过区域并停在地板上。

collision_layer 表示“我属于哪些层”,collision_mask 表示“我检测哪些层”。这里让测试物体扫描第 1 层地板,让区域扫描第 2 层测试物体。两者职责不同:区域发现重叠不等于为物体提供阻挡。

监听进入事件并观察输出

为 PickupZone 附加以下完整 GDScript。检测区不需要实体碰撞层,只需要监控目标所在的层。代码用群组过滤,避免其他刚体进入时误判为玩家。

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("玩家进入拾取区")

预期输出(测试物体从区域外落入时):

text
玩家进入拾取区

继续观察测试物体:它会穿过球形区域,但被地板的碰撞盒挡住。同一次进入通常只打印一次,离开后再次进入才会重新触发。

触发失败时检查哪些条件

如果物体穿过检测区却没有输出,依次确认 PickupZone 的 CollisionShape3D 已指定形状且未禁用、monitoring 为 true、区域遮罩包含物体所在层,以及物体确实加入 player 群组。body_entered 侦测物理体;若要侦测另一个 Area3D,应使用 area_entered,并检查相关区域的 monitorable 设置。

如果物体连地板也穿过去,先检查地板是否真有 StaticBody3D 和有效碰撞形状,再检查测试物体是否扫描地板所在层。不要通过把拾取区改成实体墙来修复地板问题:阻挡、触发与查询应独立配置,才能同时满足通行、事件和探测需求。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

区分碰撞体与可检测区域

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通