游戏引擎 / 系统课时

用场景实例复用关卡部件

用场景实例复用关卡部件

如果把同一箱子复制成十组互不关联的节点,调整材质或碰撞时就得逐个返工。本课把箱子封装成独立的 Godot 4 场景,在关卡里复用、验证源场景更新与局部覆盖,再用 PackedScene 在运行时生成多个实例。

学习目标

  • 将网格与碰撞封装为可复用的 .tscn 场景。
  • 识别源场景更新、实例独立变换与属性覆盖的边界。
  • 使用 PackedScene.instantiate() 在运行时批量创建关卡部件。

把箱子做成独立场景

Godot 的场景不仅可以表示整张关卡,也可以表示一个门、箱子或平台。保存后的 .tscn 文件类似模板:每次实例化都会建立一份独立的节点树,但网格、材质等资源可以被共享。这样可以统一维护部件结构,而不必把重复逻辑写进每个关卡。

  1. 在项目中新建 props 文件夹,创建新 3D 场景,以 StaticBody3D 为根节点,命名 Crate。
  2. 为根节点添加直属的 MeshInstance3D,指定 BoxMesh,将 Size 设为 (1, 1, 1);再添加直属的 CollisionShape3D,指定 BoxShape3D,也设置为 (1, 1, 1)。
  3. 保持场景内部节点的变换尽量归零,将该场景保存为 res://props/crate.tscn。这是一只固定箱子;若设计要求被推倒或受重力作用,应将根物理体改为适当的 RigidBody3D。

再新建 levels 文件夹,创建 Level(Node3D) 场景并保存为 res://levels/level.tscn。从文件系统面板把 crate.tscn 拖到关卡根节点下,或用场景面板的实例化场景按钮添加。选中实例复制两次,让三个箱子的 X 坐标分别为 0、2、4;若地面顶面位于 Y=0,则三个实例的 Position.y 都设为 0.5,使底面贴地。

源场景与实例覆盖如何协作

三个箱子并不是同一个节点对象:它们可以各自移动、旋转、接收信号,并拥有不同的运行时状态,但仍指向同一份 crate.tscn 结构。回到源场景修改一个未被覆盖的属性,保存后相应变化会反映到关卡中的实例;在关卡里单独改某个实例的位置,则不会移动其他实例,也不会改写源文件。

箱子源场景与关卡中三个实例的继承和覆盖关系

可以做一次直观验证:在源场景更换 BoxMesh 的材质,再打开关卡,观察三个实例的外观一起变化;随后只修改 Crate_2 的根节点位置,其他箱子应保持原位。若实例已覆盖某项属性,该属性不会再直接跟随源场景的默认值。修改共享的材质或碰撞形状资源也可能影响多个实例;确实需要独立资源时,应单独创建或使资源对场景本地化。

用脚本批量生成三个实例

固定布景在编辑器中拖放最方便;随机掉落物、程序化关卡或按波次生成的障碍则适合脚本实例化。另建一个根节点为 Node3D 的空测试场景 LevelRuntime.tscn,把以下脚本挂在根节点上,并确保先前的 res://props/crate.tscn 已保存,且根节点确实是 StaticBody3D。

gdscript
extends Node3D

const CRATE_SCENE: PackedScene = preload("res://props/crate.tscn")

func _ready() -> void:
    var created := 0
    # 每个位置都生成新的节点实例,而非重复添加同一节点
    for index in range(3):
        var crate := CRATE_SCENE.instantiate() as StaticBody3D
        crate.name = "Crate_%d" % (index + 1)
        crate.position = Vector3(index * 2.0, 0.5, 0.0)
        add_child(crate)
        created += 1

    # 运行时生成的节点不会自动保存进场景文件
    print("已创建箱子实例: ", created)

预期输出:

text
已创建箱子实例: 3

运行当前测试场景后,查看调试器中的远程场景树,应出现 Crate_1、Crate_2、Crate_3。这个最小测试场景没有摄像机,因此即使输出正确,游戏窗口也可能没有可见物体;需要直观看到箱子时再添加 Camera3D 和光照。instantiate() 创建节点,add_child() 才把节点接入正在运行的场景树,二者缺一不可。

验证复用关系而不是只看数量

检查关卡文件中的三个编辑器实例仍保有源场景引用;编辑源场景的未覆盖属性,再重新打开关卡,确认变化传播。脚本实例则在每次运行时重新生成,不会自动回写 LevelRuntime.tscn,也不应与手动摆放的同一批箱子叠加,否则会产生重复物件。

若出现资源路径找不到,核对 preload() 的 res:// 路径与实际文件名;若类型转换失败,检查 crate.tscn 的根节点是否为 StaticBody3D;若箱子看得见却能被穿过,返回源场景核对碰撞盒及碰撞层。对于门、平台等部件,同样优先封装“可独立维护的一件事”,再决定是在编辑器中复用还是运行时实例化。

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

目录与阅读设置

阅读设置

17

记录一个想法

用场景实例复用关卡部件

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

登录哪都通