### Godot 4 中 Grounded 功能的替代实现方式 在 Godot 4 中，虽然核心概念保持一致，但由于 API 和模块的变化，`grounded` 的实现方式有所改进。以下是对 Godot 4 中 `grounded` 替代方案的具体分析。 --- #### 使用 CharacterBody2D 或 KinematicBody2D 实现 Grounded 检测 Godot 4 继续支持 `CharacterBody2D` 和 `KinematicBody2D` 类型节点来处理角色运动逻辑。其中，`is_on_floor()` 方法仍然是检测是否接触地面的主要工具[^1]。然而，为了适应更复杂的场景需求，开发者可以通过自定义碰撞检测逻辑进一步扩展功能。 ##### 示例代码 以下是一个基于 `CharacterBody2D` 的实现示例： ```gdscript extends CharacterBody2D var velocity := Vector2.ZERO var gravity := 800 var jump_strength := -400 var grounded := false func _physics_process(delta): # 获取输入并向量计算 var input_dir := Input.get_vector("ui_left", "ui_right", "ui_up", "ui_down") velocity.x = input_dir.x * 200 # 跳跃逻辑 if is_on_floor() and Input.is_action_just_pressed("jump"): velocity.y = jump_strength # 添加重力影响 velocity.y += gravity * delta # 执行移动并更新状态 velocity = move_and_slide(velocity, Vector2.UP) grounded = is_on_floor() ``` 在此代码中，`move_and_slide` 方法会自动调整角色的方向和速度，并返回一个布尔值指示是否正在滑动或站立在表面上。这使得 `is_on_floor()` 成为检测 `grounded` 状态的核心函数[^1]。 --- #### 增强版 Grounded 检测：利用 RayCast2D 尽管 `is_on_floor()` 已经非常强大，但在某些特殊情况下（例如需要更高的精度或定制化检测），可以引入 `RayCast2D` 节点辅助判断。这种方法特别适合于复杂地形或多层平台环境。 ##### 示例代码 以下是结合 `RayCast2D` 的实现方式： ```gdscript extends CharacterBody2D @onready var raycast_node := $RayCast2D var velocity := Vector2.ZERO var gravity := 800 var jump_strength := -400 var grounded := false func _ready(): raycast_node.cast_to = Vector2(0, 16) # 设置射线长度 raycast_node.force_disabled = true # 默认禁用射线 func _physics_process(delta): # 启用射线检测 raycast_node.enabled = true # 计算输入与移动逻辑 var input_dir := Input.get_vector("ui_left", "ui_right", "ui_up", "ui_down") velocity.x = input_dir.x * 200 # 跳跃逻辑 if raycast_node.is_colliding() and Input.is_action_just_pressed("jump"): velocity.y = jump_strength # 添加重力影响 velocity.y += gravity * delta # 执行移动 velocity = move_and_slide(velocity, Vector2.UP) # 更新 grounded 状态 grounded = raycast_node.is_colliding() ``` 此方法通过显式的射线投射确认是否有障碍物位于角色下方，从而提供更为精细的控制能力[^3]。 --- #### MotionMode 参数的影响 需要注意的是，在 Godot 4 中，`CharacterBody2D` 支持两种主要的运动模式： - **MOTION_MODE_GROUNDED**：适用于传统的平台跳跃游戏。 - **MOTION_MODE_FLOATING**：更适合自由飞行或俯视视角的游戏。 不同模式下，`move_and_slide` 行为可能会略有差异。因此，在设计 `grounded` 检测时需考虑当前使用的运动模式及其特性[^2]。 --- #### 总结 综上所述，Godot 4 中的 `grounded` 功能可以通过多种方式进行实现，具体取决于项目的实际需求和技术偏好。无论是依赖内置的 `is_on_floor()` 方法还是借助外部工具如 `RayCast2D`，都可以有效达成目标。 ---