游戏引擎 / 系统课时
加入跳跃与加速度控制
加入跳跃与加速度控制
角色已经能落地,但按键后瞬间达到最高速度会显得突兀,跳跃若不检查接地状态又可能在空中反复触发。本课为 Godot 4 的 CharacterBody3D 加入单次起跳、加速、松键减速和有限的空中操控,让移动手感可调且行为能够验证。
学习目标
- 用独立输入动作和接地条件控制一次起跳。
- 使用
move_toward()平滑调整水平速度。 - 验证起跳、落地、反向移动和空中输入的边界行为。
配好角色与跳跃输入
准备 Player(CharacterBody3D)及其胶囊 CollisionShape3D,场景地面采用带盒形碰撞体的 StaticBody3D。将角色放在地板顶面上方,并添加可观察角色的当前 Camera3D,保证两者碰撞层与掩码匹配。
打开「项目 → 项目设置 → 输入映射」,新增动作 jump 并为它绑定空格键。确认 ui_left、ui_right、ui_up、ui_down 已绑定方向键。本示例按世界坐标的 X/Z 轴移动,暂不根据摄像机朝向旋转移动方向。
完整实现跳跃与水平缓动
将以下脚本保存为 Player.gd,挂到 Player 根节点。velocity.y 只负责起跳和重力,velocity.x、velocity.z 单独计算水平目标速度,避免在更新移动方向时意外抹掉垂直速度。
extends CharacterBody3D
@export var move_speed: float = 6.0
@export var ground_acceleration: float = 18.0
@export var ground_deceleration: float = 24.0
@export var air_acceleration: float = 6.0
@export var jump_speed: float = 5.0
@export var gravity_acceleration: float = 9.8
func _physics_process(delta: float) -> void:
var grounded := is_on_floor()
# 只允许已接地的角色在按下动作的瞬间获得向上初速度。
if grounded:
if Input.is_action_just_pressed("jump"):
velocity.y = jump_speed
else:
velocity.y = 0.0
else:
velocity.y -= gravity_acceleration * delta
var axis := Input.get_vector("ui_left", "ui_right", "ui_up", "ui_down")
var target := axis * move_speed
var horizontal := Vector2(velocity.x, velocity.z)
# 地面加速、地面刹车与空中调整采用不同响应率。
var rate := ground_acceleration if axis.length_squared() > 0.0 else ground_deceleration
if not grounded:
rate = air_acceleration
horizontal = horizontal.move_toward(target, rate * delta)
velocity.x = horizontal.x
velocity.z = horizontal.y
move_and_slide()预期结果:角色站稳后按空格会向上跳起,随后减速到最高点并开始下落,触地后才能再次起跳;长按空格或在空中重新按下,都不会产生额外跳跃。按住方向键会逐渐达到最高速度,松键后逐步停下,而不是立即停住。
is_on_floor() 来自上一次 move_and_slide() 的接触结果。因此脚本先判断接地、设置本帧目标速度,最后统一执行碰撞移动。Input.is_action_just_pressed("jump") 只识别按下边沿,而不是一直按住的状态。若玩家在落地前按跳跃,本版不会缓存输入,这是预期边界而非失效。
分清跳跃轨迹与速度曲线
跳跃将 velocity.y 瞬时设为正的 jump_speed;离地后,每个物理步让它减去 gravity_acceleration * delta。上升到最高点时,纵向速度由正变为接近零,之后变负并开始下落。示例参数且没有碰到天花板时,从平地起跳的最高上升距离大约为 1.3 米。
水平部分使用 Vector2.move_toward(target, rate * delta),每个物理步只允许速度朝目标改变有限幅度。以 move_speed=6、ground_acceleration=18 为例,从静止到最高速度约需 0.33 秒;松键后用 ground_deceleration=24 减到零约需 0.25 秒。空中统一使用较小的 air_acceleration=6,避免角色在空中突然掉头。

验证边界并调节手感
- 在平地按一下空格,观察完整起跳与落地;落地前再次按空格,不应二次上升,落地后松开再按则可以重新跳跃。
- 地面持续按右键,再松开并按左键;角色应先减速再反向加速,且不会绕过碰撞体。
- 跳起后尝试改变方向,观察空中转向速度明显低于地面;走出平台再按跳跃,不应凭空起跳。
- 只改一个导出参数后重新测试:提高
jump_speed会跳得更高,提高gravity_acceleration会缩短滞空并压低同初速度的跳跃高度,提高ground_deceleration会更快停住。
调参时先稳定碰撞和接地检测,再定跳跃高度,最后调整地面与空中的水平响应;这样能把“跳不起来”“落地不稳”和“手感生硬”分开定位。