游戏引擎 / 系统课时
按相机朝向计算移动方向
按相机朝向计算移动方向
按下 W 时,玩家通常期待角色朝屏幕前方前进,而不是锁死在世界坐标的某个轴上。本课从输入向量与摄像机的朝向出发,计算贴着地面的三维移动方向,再用 CharacterBody3D 完成移动和碰撞验证。
学习目标
- 理解二维输入与相机局部前向、右向的对应关系。
- 将摄像机朝向投影到世界 XZ 平面,计算水平移动速度。
- 通过旋转镜头验证方向、斜向速度和接地效果。
准备角色、地板和输入
在 Godot 4 新建 Main(Node3D) 场景,添加带 CollisionShape3D 的 Floor(StaticBody3D),用 BoxShape3D 做宽阔地面,并用 MeshInstance3D 提供可见表面。再添加 Player(CharacterBody3D),其子节点包含 CollisionShape3D(使用 CapsuleShape3D)、角色可见网格及 CameraPivot(Node3D)。在 CameraPivot 下放 SpringArm3D,把 Camera3D 作为弹簧臂的直属子节点。
将地板顶面放在世界 Y=0,角色初始中心放在 Y=1,相机枢轴局部高度设为 1.5;弹簧臂长度设为 3.5,相机局部位置保持零,勾选 Camera3D 的 Current。弹簧臂 Shape 留空,使用摄像机近裁剪面进行遮挡检测。
在「项目 → 项目设置 → 输入映射」中添加四个动作:move_left 绑定 A,move_right 绑定 D,move_forward 绑定 W,move_back 绑定 S。这些名称须与脚本完全一致。
把镜头前方向投影到地面
Input.get_vector() 返回 Vector2:按 W 时 y 为负,按 D 时 x 为正。Godot 3D 中相机局部 -Z 指向镜头前方,局部 +X 指向右侧。使用摄像机的世界变换 basis 取出这两根方向向量,才能让移动随着镜头水平转动而变化。
当镜头抬头或俯视时,其前方向含有竖直分量。地面角色只需 XZ 平面上的方向,因此要先将前向、右向的 y 清零,再分别归一化;最后用输入的两个分量组合它们。

用 CharacterBody3D 实现移动
将下面脚本保存为 player.gd,挂到 Player。velocity.x 和 velocity.z 由相机相对方向决定,velocity.y 独立处理重力;move_and_slide() 负责碰撞与沿地面滑动。示例把摇杆输入的幅度保留下来,避免轻推摇杆也始终满速。
extends CharacterBody3D
@export var move_speed: float = 5.0
@export var gravity: float = 18.0
@onready var camera: Camera3D = $CameraPivot/SpringArm3D/Camera3D
@onready var spring_arm: SpringArm3D = $CameraPivot/SpringArm3D
func _ready() -> void:
# 避免弹簧臂把玩家自己的碰撞体当作镜头障碍
spring_arm.add_excluded_object(get_rid())
func _physics_process(delta: float) -> void:
var input_axis := Input.get_vector(
"move_left", "move_right", "move_forward", "move_back"
)
# 相机坐标转为世界水平坐标,忽略镜头俯仰
var forward := -camera.global_transform.basis.z
var right := camera.global_transform.basis.x
forward.y = 0.0
right.y = 0.0
forward = forward.normalized()
right = right.normalized()
var direction := (right * input_axis.x - forward * input_axis.y).limit_length(1.0)
velocity.x = direction.x * move_speed
velocity.z = direction.z * move_speed
if not is_on_floor():
velocity.y -= gravity * delta
else:
velocity.y = 0.0
move_and_slide()预期结果(观察游戏画面中的运动方向):
相机偏航 0°:按 W 沿世界 -Z,按 D 沿世界 +X
相机偏航 +90°:按 W 沿世界 -X,按 D 沿世界 -Z
镜头俯仰改变:按 W 仍在水平面移动,不会朝天空飞起
同时按 W 和 D:斜向移动速度不超过 move_speed验证方向和处理易错点
先让 CameraPivot 的水平旋转为 0°,按 W、D 对照世界坐标轴;再将它的 Y 旋转改为 +90°,重复按键。可在运行时用远程场景树修改旋转,也可停止游戏后在检查器中修改。为了避免相机恰好竖直朝上导致水平前向趋于零,实际第三人称镜头应限制俯仰角。
如果 W 反向,检查组合式中的 -forward * input_axis.y 是否多写或漏写负号;如果镜头转动后方向不变,确认使用的是摄像机的 global_transform.basis 而非角色本地轴。如果出现空中漂移,检查是否把相机前向的 y 分量带进了 velocity.y,或遗漏了物理更新与地板碰撞。角色朝向动画可以另行调整可见模型,不要为转身而无意间改变相机枢轴的方向。