游戏引擎 / 系统课时

给场景补上碰撞形状

给场景补上碰撞形状

地板和墙在 3D 视口里看得见,并不代表玩家会被挡住。本课在 Godot 4 中为静态关卡几何添加物理体和碰撞盒,再用调试轮廓、脚本检查与落体测试确认配置,避免角色穿地或撞上看不见的墙。

学习目标

  • 区分可见网格、静态物理体和碰撞形状的职责。
  • 配置与地板几何对齐的 StaticBody3D 和 BoxShape3D。
  • 根据节点层级、碰撞层与形状偏移定位失效原因。

可见模型不等于物理障碍

MeshInstance3D 负责显示几何和材质,本身不会阻挡角色。StaticBody3D 代表不会被物理引擎推动的关卡物体,适合地板、墙和固定平台;CollisionShape3D 则给它提供真正参与碰撞计算的 Shape3D 资源。三者分别回答“看见什么”“由谁参与物理”“哪里不能穿过”。

最稳妥的结构是让 MeshInstance3D 与 CollisionShape3D 同为 StaticBody3D 的直属子节点。物理形状若隔着其他普通节点挂在更深层,可能不被这个物理体识别;有 CollisionShape3D 节点但没有设置 Shape 资源,也等于没有有效碰撞。

静态地板的节点结构与可见网格、碰撞盒的空间对应关系

在编辑器中搭建静态地板

  1. 在 Godot 4 中新建 3D 场景,将根节点命名为 Main(Node3D),新增 StaticBody3D 并命名为 Floor。
  2. 在 Floor 下新增 MeshInstance3D,为 Mesh 创建 BoxMesh,将 Size 设置为 (8, 0.2, 8),得到宽八米、厚二十厘米的可见地板。
  3. 仍选中 Floor,新增另一个直属子节点 CollisionShape3D;在检查器的 Shape 属性中新建 BoxShape3D,将其 Size 同样设为 (8, 0.2, 8),保持 Disabled 关闭。
  4. 将 Floor 的 Position.y 设为 -0.1。由于网格和碰撞盒都以自身中心为原点,厚度为 0.2,这样顶面恰好落在世界 Y=0。保存场景。

墙体可以复用相同做法,只需同时调整可见 BoxMesh 和物理 BoxShape3D 的尺寸、位置。优先修改形状资源的 Size,不要用非等比缩放 CollisionShape3D 来凑尺寸,否则容易产生碰撞偏差。

检查配置并验证真实阻挡

把下面的完整脚本挂在含有 Floor 的 Main(Node3D) 根节点上,运行当前场景。它检查节点是否存在、是否分配了盒形资源,以及碰撞形状是否启用。

gdscript
extends Node3D

func _ready() -> void:
    # 路径与刚才创建的 Floor 节点结构一致
    var floor := get_node_or_null("Floor") as StaticBody3D
    if floor == null:
        push_error("未找到 Floor 静态体")
        return

    var collider := floor.get_node_or_null("CollisionShape3D") as CollisionShape3D
    # 只有节点而没有 Shape3D 资源,仍然无法参与碰撞
    if collider == null or collider.shape == null:
        push_error("Floor 缺少碰撞形状资源")
        return

    var valid := (collider.shape is BoxShape3D) and (not collider.disabled)
    print("地板碰撞配置就绪: ", valid)

预期输出(使用前面的节点名称与设置):

text
地板碰撞配置就绪: true

这段代码只能证明形状已配置,不能代替物理接触测试。在场景中临时放置一个 RigidBody3D,给它添加直属的 CollisionShape3D(SphereShape3D),置于地板上方;运行时它应落在地板上,而不是继续下坠。通过 Godot 的 Debug > Visible Collision Shapes 打开运行时碰撞轮廓,检查盒形是否与网格重合。为了看到场景,还应配置摄像机与光照。

穿透与卡边应该先检查哪里

如果物体仍然穿过地面,先检查 CollisionShape3D 是否直接位于物理体下、Shape 是否为空或被禁用,再检查碰撞过滤:地板位于默认碰撞层 1 时,移动物体的 Collision Mask 应包含第 1 层。脚本检查返回 true 并不能保证两个物体的层与掩码一定匹配。

如果角色仿佛踩在空中或卡在墙外,通常是可见网格与碰撞盒的尺寸、中心位置不一致。简单的地板和墙优先使用盒形;复杂静态地形可以考虑三角网格碰撞,但不应把凹面三角网格当成可自由运动刚体的通用形状。让碰撞边界服务于实际走位,比逐三角形复制视觉细节更重要。

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

目录与阅读设置

阅读设置

17

记录一个想法

给场景补上碰撞形状

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

登录哪都通