游戏引擎 / 系统课时

用节点树搭出第一间场景

用节点树搭出第一间场景

这节课用 Godot 4 的基础 3D 节点制作一个能运行的小场景:方块站在地面上,相机从前上方观察,方向光照亮物体。你将同时弄清节点树的父子结构与三维空间位置,并用一段脚本核对场景是否配置完整。

学习目标

  • 用 Node3D、MeshInstance3D、Camera3D 和 DirectionalLight3D 组合可运行场景。
  • 根据局部位置与网格尺寸正确摆放地面、方块和相机。
  • 运行场景并通过脚本输出定位缺少网格或相机的问题。

区分节点层级和空间位置

Godot 的场景是一棵节点树。Node3D 负责组织 3D 对象并提供位置、旋转和缩放;MeshInstance3D 负责呈现一个 Mesh 资源;Camera3D 决定游戏画面从哪里看;DirectionalLight3D 是 Light3D 的一种,像太阳一样提供方向固定的平行光。

本课让根节点 Main 直接拥有四个子节点:Floor、Cube、Camera3D、DirectionalLight3D。前两个都是 MeshInstance3D,但分别引用不同尺寸的 BoxMesh。节点树决定归属关系,Transform 决定它们在空间里的位置;兄弟节点不表示物体在同一个坐标上。

Godot 场景节点树与三维摆放关系

在编辑器里搭建节点

  1. 选择新建 3D 场景,以 Node3D 作为根节点,将其重命名为 Main。
  2. 给 Main 添加 MeshInstance3D,命名为 Floor;在检查器的 Mesh 属性中新建 BoxMesh,设置其 Size 为 (8, 0.2, 8),再把 Floor 的 Position 设为 (0, -0.1, 0)。这样地面上表面恰好在 Y=0。
  3. 再添加一个 MeshInstance3D,命名为 Cube;为它新建 BoxMesh,尺寸保持 (1, 1, 1),位置设为 (0, 0.5, 0)。方块的底面因此刚好贴在地面上。
  4. 添加 Camera3D,设 Position 为 (0, 3, 6),Rotation Degrees 为 (-20, 0, 0)。Godot 相机默认沿局部负 Z 轴观察,这个旋转使它稍微向下看。将相机设为当前相机,或稍后由脚本启用。
  5. 添加 DirectionalLight3D,将 Rotation Degrees 设为 (-45, -30, 0)。方向光的照射方向由旋转决定,位置不会改变平行光的入射方向;如需看到投影,可在检查器中启用阴影。

以上节点都应是 Main 的直属子节点,不要误把 Cube 放到 Floor 下面,否则移动地面时方块也会跟着移动。保存场景为 res://scenes/main.tscn;如果你的项目尚无 scenes 文件夹,先在文件系统面板创建它。

挂载脚本检查场景

选中 Main,新建并附加 GDScript,保存为 res://scripts/main.gd。以下是完整脚本,依赖刚刚建立且名称完全一致的四个子节点:

gdscript
extends Node3D

@onready var floor: MeshInstance3D = $Floor
@onready var cube: MeshInstance3D = $Cube
@onready var camera: Camera3D = $Camera3D
@onready var sunlight: DirectionalLight3D = $DirectionalLight3D

func _ready() -> void:
    # 空的 MeshInstance3D 节点不会自动出现几何体
    assert(floor.mesh is BoxMesh and cube.mesh is BoxMesh)
    # 显式指定活动相机,防止后续增加相机时切错视角
    camera.make_current()
    print("Floor Mesh: ", floor.mesh.get_class())
    print("Cube Mesh: ", cube.mesh.get_class())
    print("Camera current: ", camera.current)
    print("Light: ", sunlight.get_class())

使用 运行当前场景(F6) 后,在编辑器的输出面板中应看到脚本打印的四行结果:

text
Floor Mesh: BoxMesh
Cube Mesh: BoxMesh
Camera current: true
Light: DirectionalLight3D

同时,游戏窗口中应能看到地面和方块。如果脚本报找不到 $Floor 等节点,先核对节点大小写和父子层级;如果断言失败,说明某个网格属性尚未配置为 BoxMesh。

从运行画面反查问题

F6 运行的是当前保存的场景;F5 运行整个项目。首次按 F5 时若要求选择主场景,指定 res://scenes/main.tscn 即可,此后它会成为项目启动入口。

遇到编辑器里看得见、游戏窗口里看不见的现象时,应先检查活动相机及其朝向,而不是继续添加模型。还要注意,编辑器的预览太阳光与预览环境不等于运行时的真实光源;本课添加的 DirectionalLight3D 才会随场景运行。

当前的 Floor 和 Cube 只有可见网格,尚无碰撞体或刚体,因此不会自动阻挡角色或进行物理碰撞。只要运行画面中能看到地面、方块与光照,且输出检查通过,这个最小 3D 场景就已经达到验收标准。

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

目录与阅读设置

阅读设置

17

记录一个想法

用节点树搭出第一间场景

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

登录哪都通