游戏引擎 / 系统课时
用节点树搭出第一间场景
用节点树搭出第一间场景
这节课用 Godot 4 的基础 3D 节点制作一个能运行的小场景:方块站在地面上,相机从前上方观察,方向光照亮物体。你将同时弄清节点树的父子结构与三维空间位置,并用一段脚本核对场景是否配置完整。
学习目标
- 用
Node3D、MeshInstance3D、Camera3D和DirectionalLight3D组合可运行场景。 - 根据局部位置与网格尺寸正确摆放地面、方块和相机。
- 运行场景并通过脚本输出定位缺少网格或相机的问题。
区分节点层级和空间位置
Godot 的场景是一棵节点树。Node3D 负责组织 3D 对象并提供位置、旋转和缩放;MeshInstance3D 负责呈现一个 Mesh 资源;Camera3D 决定游戏画面从哪里看;DirectionalLight3D 是 Light3D 的一种,像太阳一样提供方向固定的平行光。
本课让根节点 Main 直接拥有四个子节点:Floor、Cube、Camera3D、DirectionalLight3D。前两个都是 MeshInstance3D,但分别引用不同尺寸的 BoxMesh。节点树决定归属关系,Transform 决定它们在空间里的位置;兄弟节点不表示物体在同一个坐标上。

在编辑器里搭建节点
- 选择新建 3D 场景,以
Node3D作为根节点,将其重命名为Main。 - 给
Main添加MeshInstance3D,命名为Floor;在检查器的 Mesh 属性中新建BoxMesh,设置其 Size 为(8, 0.2, 8),再把Floor的 Position 设为(0, -0.1, 0)。这样地面上表面恰好在Y=0。 - 再添加一个
MeshInstance3D,命名为Cube;为它新建BoxMesh,尺寸保持(1, 1, 1),位置设为(0, 0.5, 0)。方块的底面因此刚好贴在地面上。 - 添加
Camera3D,设 Position 为(0, 3, 6),Rotation Degrees 为(-20, 0, 0)。Godot 相机默认沿局部负 Z 轴观察,这个旋转使它稍微向下看。将相机设为当前相机,或稍后由脚本启用。 - 添加
DirectionalLight3D,将 Rotation Degrees 设为(-45, -30, 0)。方向光的照射方向由旋转决定,位置不会改变平行光的入射方向;如需看到投影,可在检查器中启用阴影。
以上节点都应是 Main 的直属子节点,不要误把 Cube 放到 Floor 下面,否则移动地面时方块也会跟着移动。保存场景为 res://scenes/main.tscn;如果你的项目尚无 scenes 文件夹,先在文件系统面板创建它。
挂载脚本检查场景
选中 Main,新建并附加 GDScript,保存为 res://scripts/main.gd。以下是完整脚本,依赖刚刚建立且名称完全一致的四个子节点:
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) 后,在编辑器的输出面板中应看到脚本打印的四行结果:
Floor Mesh: BoxMesh
Cube Mesh: BoxMesh
Camera current: true
Light: DirectionalLight3D同时,游戏窗口中应能看到地面和方块。如果脚本报找不到 $Floor 等节点,先核对节点大小写和父子层级;如果断言失败,说明某个网格属性尚未配置为 BoxMesh。
从运行画面反查问题
F6 运行的是当前保存的场景;F5 运行整个项目。首次按 F5 时若要求选择主场景,指定 res://scenes/main.tscn 即可,此后它会成为项目启动入口。
遇到编辑器里看得见、游戏窗口里看不见的现象时,应先检查活动相机及其朝向,而不是继续添加模型。还要注意,编辑器的预览太阳光与预览环境不等于运行时的真实光源;本课添加的 DirectionalLight3D 才会随场景运行。
当前的 Floor 和 Cube 只有可见网格,尚无碰撞体或刚体,因此不会自动阻挡角色或进行物理碰撞。只要运行画面中能看到地面、方块与光照,且输出检查通过,这个最小 3D 场景就已经达到验收标准。