Unity实现2.5D抓钩绳索物理时玩家速度短时间归零问题

架构老林

2026-8-30

问题描述

实现2.5D抓钩绳索物理功能，目标是支持玩家绕场景物体摆荡实现快速转向，但当前代码运行异常：触发抓钩后玩家会在短时间内完全丧失所有运动速度。
原实现代码如下：

public Transform player;
private float tikTok;
public LayerMask layerMask;
Vector3 tetherPoint;
Transform tetherObject;
Vector3 currentTether;
float tetherLength;
bool isTethered;
Vector3 previousPlayerPosition;

// 注：原逻辑未声明生命周期函数，默认放在Update中执行
if (Input.GetKey(KeyCode.Space) && Time.time >= tikTok && !isTethered) {
// 本部分功能运行正常
    Ray ray = new Ray(player.position, player.forward);
    if (Physics.Raycast(ray, out RaycastHit hit, float.MaxValue, layerMask)) {
        tetherPoint = hit.point;
        tetherObject = hit.transform;
        currentTether = tetherObject.position;
        tetherLength = Vector3.Distance(player.position, tetherPoint);
        isTethered = true;
    }
} else if (isTethered && Input.GetKey(KeyCode.Space)) {
// 本部分功能存在异常
    if (Vector3.Distance(player.position, tetherPoint) > tetherLength) {
        player.position -= (Vector3.Distance(player.position, tetherPoint) - tetherLength) * (player.position - tetherPoint).normalized;
        print((player.position - previousPlayerPosition).normalized);
        player.gameObject.GetComponent<Rigidbody>().velocity = player.gameObject.GetComponent<Rigidbody>().velocity.magnitude * (player.position - previousPlayerPosition).normalized;
    }
} else if (isTethered && !Input.GetKey(KeyCode.Space)) {
    isTethered = false;
    tetherPoint = Vector3.zero;
    tetherObject = null;
    currentTether = Vector3.zero;
    tetherLength = 0;
}
if (tetherObject != null) {
    if (currentTether != tetherObject.position) {
        tetherPoint += currentTether - tetherObject.position;
        currentTether = tetherObject.position;
    }
}
previousPlayerPosition = player.position;

故障原因

直接修改player.position会和Rigidbody物理驱动逻辑冲突：Unity物理引擎在FixedUpdate周期根据刚体速度计算位置，直接篡改Transform位置会打断速度积分流程，直接导致速度计算失真。
速度计算顺序完全错误：先强制把玩家位置拉回绳长限制范围，再用修正后的位置和上一帧位置计算运动方向，此时得到的位移混合了「玩家自身运动位移」和「强制拉回位置产生的偏移」，根本不是真实的摆荡切线方向；如果帧间修正幅度过大，会得到和运动方向完全相反的向量，或是位移过小导致归一化后得到零向量，直接把速度清零。
摆荡物理逻辑错误：真实绳索摆荡不会改变玩家速度大小，只会抵消沿绳索方向向外的速度分量，保留切线方向速度，靠帧间位置差反推速度方向的方案数值稳定性极差，速度会快速衰减。
帧率不匹配：抓钩约束属于物理计算，放在Update中执行会因为渲染帧率波动导致误差累积，进一步加剧速度异常。

修复方案

输入检测留在Update保证响应灵敏度，所有抓钩物理约束逻辑移至FixedUpdate生命周期执行。
禁止直接修改transform.position，位置修正用Rigidbody.MovePosition实现，避免打断物理积分。
移除帧间位置差算速度方向的逻辑，直接对刚体速度做向量投影：当玩家超出绳长时，抵消速度中沿绳索向外的分量，仅保留切线方向的摆荡速度，数值稳定性更高。
提前缓存Rigidbody组件，不要每帧调用GetComponent产生额外性能开销。

修复后的核心逻辑代码：

public Transform player;
private float tikTok;
public LayerMask layerMask;
Vector3 tetherPoint;
Transform tetherObject;
Vector3 currentTether;
float tetherLength;
bool isTethered;
private Rigidbody playerRb;

void Awake()
{
    playerRb = player.GetComponent<Rigidbody>();
}

void Update()
{
    // 输入检测留在Update保证响应及时
    if (Input.GetKey(KeyCode.Space) && Time.time >= tikTok && !isTethered) {
        Ray ray = new Ray(player.position, player.forward);
        if (Physics.Raycast(ray, out RaycastHit hit, float.MaxValue, layerMask)) {
            tetherPoint = hit.point;
            tetherObject = hit.transform;
            currentTether = tetherObject.position;
            tetherLength = Vector3.Distance(player.position, tetherPoint);
            isTethered = true;
        }
    } else if (isTethered && !Input.GetKey(KeyCode.Space)) {
        isTethered = false;
        tetherPoint = Vector3.zero;
        tetherObject = null;
        currentTether = Vector3.zero;
        tetherLength = 0;
    }
}

void FixedUpdate()
{
    if (isTethered)
    {
        Vector3 playerToAnchor = tetherPoint - player.position;
        float currentDistance = playerToAnchor.magnitude;
        
        if (currentDistance > tetherLength)
        {
            // 修正位置到绳长边界
            Vector3 correctionDir = playerToAnchor.normalized;
            float correctionDistance = currentDistance - tetherLength;
            playerRb.MovePosition(player.position + correctionDir * correctionDistance);
            
            // 抵消沿绳索向外的速度分量，保留切线摆荡速度
            Vector3 ropeOutDir = -correctionDir;
            float outwardSpeed = Vector3.Dot(playerRb.velocity, ropeOutDir);
            if (outwardSpeed > 0)
            {
                playerRb.velocity -= ropeOutDir * outwardSpeed;
            }
        }
    }

    // 移动锚点跟随逻辑
    if (tetherObject != null)
    {
        if (currentTether != tetherObject.position)
        {
            tetherPoint += currentTether - tetherObject.position;
            currentTether = tetherObject.position;
        }
    }
}

手感优化提示：如果需要更顺滑的摆荡效果，抵消向外速度时可以保留5%~10%的余量，或是给绳索加少量弹性，避免硬拉扯的生硬感。

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