Unity 3D第一人称控制器玩家瞬移失效问题排查求助

问题背景 #

使用Unity Starter Assets默认第一人称控制器，实现玩家踩上圆形触发区域时的瞬移功能：

• PlayerCapsule父物体标签设为Player，挂载Character Controller、First Person Controller等核心脚本
• 子物体Capsule带碰撞器组件
• 触发区域的OnTriggerEnter能正常打印玩家和目标位置的Debug日志，但玩家始终无法瞬移到目标点，尝试添加IsKinematic的Rigidbody也无效

核心原因 #

Starter Assets的第一人称控制器依赖Character Controller组件，直接修改transform.position会被Character Controller的内置更新逻辑覆盖——它会在下一帧将角色位置重置回原有状态，导致瞬移操作失效。

解决方案 #

必须通过Character Controller提供的API来完成瞬移，以下两种方案均可：

方案1：使用CharacterController.Move()方法 #

通过计算位移差，调用Move()方法让Character Controller主动移动到目标位置：

public class Teleport : MonoBehaviour
{
    public Transform teleportTarget;

    private void OnTriggerEnter(Collider other)
    {
        if (other.CompareTag("Player"))
        {
            Debug.Log($"Player position: {other.transform.position}\nTarget position: {teleportTarget.position}");
            
            CharacterController characterController = other.GetComponent<CharacterController>();
            if (characterController != null)
            {
                // 计算从当前位置到目标位置的位移
                Vector3 teleportOffset = teleportTarget.position - other.transform.position;
                // 调用Move方法完成瞬移
                characterController.Move(teleportOffset);
            }
        }
    }
}

方案2：临时禁用Character Controller #

先关闭Character Controller的更新逻辑，修改位置后再重新启用：

public class Teleport : MonoBehaviour
{
    public Transform teleportTarget;

    private void OnTriggerEnter(Collider other)
    {
        if (other.CompareTag("Player"))
        {
            Debug.Log($"Player position: {other.transform.position}\nTarget position: {teleportTarget.position}");
            
            CharacterController characterController = other.GetComponent<CharacterController>();
            if (characterController != null)
            {
                // 禁用Character Controller，避免位置被重置
                characterController.enabled = false;
                // 修改玩家位置到目标点
                other.transform.position = teleportTarget.position;
                // 重新启用Character Controller
                characterController.enabled = true;
            }
        }
    }
}

注意事项 #

• 确保teleportTarget已在Inspector面板中正确赋值为瞬移目标的Transform对象
• 瞬移目标位置不要处于地形或其他碰撞体内部，避免角色出现穿模、被弹开的异常情况
• 无需给玩家对象添加Rigidbody组件，Starter Assets第一人称控制器不依赖Rigidbody，添加后可能引发逻辑冲突

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