如何在Godot 3D中检测碰撞但不立即处理碰撞？

针对你不用内置碰撞系统的需求，这里提供两种可靠的手动碰撞检测方法，直接适配你的CharacterBody3D控制器逻辑：

方法一：射线投射检测（推荐用于平台游戏地面检测） #

射线检测能精准判断角色是否踩在地板上，避免AABB重叠带来的误判。

步骤1：定义基础变量 #

先在脚本头部添加碰撞相关的变量：

# 角色碰撞盒半尺寸（根据你的角色大小调整，比如0.5宽、1.0高、0.5深）
var half_extents = Vector3(0.5, 1.0, 0.5)
# 存储所有地板的碰撞盒（提前把地板加入"floors"组）
var floor_aabbs: Array[AABB] = []

步骤2：初始化地板碰撞盒 #

在_ready函数中预加载所有地板的全局AABB：

func _ready():
    for floor in get_tree().get_nodes_in_group("floors"):
        # 将地板本地AABB转换为全局坐标
        var global_aabb = floor.get_global_transform().xform(floor.get_aabb())
        floor_aabbs.append(global_aabb)

步骤3：实现碰撞检测函数 #

func is_on_floor() -> bool:
    # 射线起点：角色脚底的全局位置
    var ray_start = global_position - Vector3(0, half_extents.y, 0)
    # 射线长度：当前下落速度的绝对值+缓冲值，避免高速下落漏检
    var ray_length = abs(yvel) + 0.02
    # 射线终点：起点向下延伸ray_length的距离
    var ray_end = ray_start - Vector3(0, ray_length, 0)

    # 遍历所有地板AABB，检测射线是否相交
    for aabb in floor_aabbs:
        if aabb.intersects_ray(ray_start, ray_end):
            return true
    return false

步骤4：整合到你的移动逻辑 #

修改原_process函数，替换测试按键检测：

func _process(delta):
    # 应用重力（注意：若你用Godot默认Y轴向上，这里应该是yvel += gravity，否则调整符号）
    yvel -= gravity
    var new_ypos = ypos + yvel

    # 临时更新位置用于检测
    global_position = Vector3(xpos, new_ypos, zpos)
    
    # 检测到地板碰撞则执行解决逻辑
    if is_on_floor():
        resolve_collision_forcefully()
    else:
        # 无碰撞则正式更新位置
        ypos = new_ypos
        global_position = Vector3(xpos, ypos, zpos)

方法二：AABB重叠检测 #

若需要检测全方位碰撞（不止地面），可以用轴对齐包围盒的重叠判断：

实现碰撞检测函数 #

func check_floor_collision() -> bool:
    # 计算角色当前的全局AABB
    var player_aabb = AABB(global_position - half_extents, half_extents * 2)

    for floor_aabb in floor_aabbs:
        # 检测AABB是否重叠，且角色处于下落状态（根据你的坐标系调整yvel的判断）
        if player_aabb.intersects(floor_aabb) and yvel > 0:
            return true
    return false

整合到移动逻辑 #

直接替换原测试代码即可：

func _process(delta):
    yvel -= gravity
    ypos += yvel
    global_position = Vector3(xpos, ypos, zpos)

    if check_floor_collision():
        resolve_collision_forcefully()

关键注意事项 #

• 坐标系适配：Godot默认Y轴向上，若你的代码里Y轴向下（ypos越大越靠下），需调整重力、速度的符号，以及碰撞检测中的方向判断。
• 性能优化：当地板数量较多时，可通过空间划分（比如将场景分成网格，只检测角色所在网格内的地板）减少遍历次数。
• 碰撞盒精度：确保角色和地板的AABB尺寸与视觉模型匹配，避免出现“穿模”或“悬空”的问题。

内容的提问来源于stack exchange，提问作者user22692191