Unity玩家Teleport时与方块碰撞及地面误判问题求助

问题分析 #

1. 方块附近传送的碰撞穿透问题 #

原代码直接将玩家位置设置为点击坐标，若点击点距离方块过近，玩家碰撞体会瞬间嵌入方块碰撞体，物理引擎的碰撞纠正机制会将玩家弹出，导致视觉上的"瞬移后回弹"现象。

2. 垂直墙面点击的地面误判问题 #

IsGrounded()方法使用Physics2D.BoxCast向下方检测地面，但该BoxCast的起始位置是玩家Transform中心，若groundChecker范围过大或检测层未区分地面与墙面，当玩家靠近垂直墙面时，BoxCast会触碰到墙面碰撞体，误判为"地面"，导致传送逻辑异常生效。

解决方案 #

方案1：用OverlapBox检测目标位置合法性 #

传送前先检查目标位置是否能完整容纳玩家碰撞体，避免嵌入障碍物。使用Physics2D.OverlapBoxNonAlloc高效检测指定区域内的碰撞体，避免频繁内存分配。

方案2：修复地面检测逻辑 #

调整BoxCast的起始位置与检测范围，确保仅检测玩家正下方的地面，排除垂直墙面的干扰。

修改后的完整代码 #

using UnityEngine;

public class PlayerTeleport : MonoBehaviour
{
    public GameObject player;
    public Vector2 groundCheckerSize; // 设置为贴合玩家脚部的尺寸
    public float groundCheckDistance;
    public LayerMask groundLayer;
    public LayerMask obstacleLayer; // 配置所有不可穿透的障碍物层
    public float teleportRange = 3f;

    private BoxCollider2D playerCollider;
    private Vector2 playerColliderSize;

    void Awake()
    {
        // 提前获取玩家碰撞体，避免重复调用GetComponent
        playerCollider = player.GetComponent<BoxCollider2D>();
        if (playerCollider != null)
        {
            playerColliderSize = playerCollider.size;
        }
    }

    void Update()
    {
        // 仅当玩家在地面且点击左键时触发传送
        if (Input.GetMouseButtonDown(0) && IsGrounded())
        {
            Vector2 playerPos = player.transform.position;
            Vector2 targetPos = Camera.main.ScreenToWorldPoint(Input.mousePosition);
            targetPos.z = playerPos.z; // 保持2D游戏的Z轴一致

            // 1. 检查是否在传送范围内
            float distance = Vector2.Distance(playerPos, targetPos);
            if (distance > teleportRange)
            {
                return;
            }

            // 2. 检查目标位置是否无障碍物（能容纳玩家碰撞体）
            if (IsTargetPositionValid(targetPos))
            {
                player.transform.position = targetPos;
            }
        }
    }

    /// <summary>
    /// 检测目标位置是否可安全放置玩家
    /// </summary>
    private bool IsTargetPositionValid(Vector2 targetPos)
    {
        // 预分配结果数组，避免GC
        Collider2D[] results = new Collider2D[5];
        // 用与玩家碰撞体相同大小的盒子检测目标区域
        int hitCount = Physics2D.OverlapBoxNonAlloc(targetPos, playerColliderSize, 0f, results, obstacleLayer);

        // 无障碍物则返回有效
        return hitCount == 0;
    }

    /// <summary>
    /// 修复后的地面检测：仅检测玩家正下方区域
    /// </summary>
    private bool IsGrounded()
    {
        // 计算BoxCast起始点：玩家碰撞体底部中心
        Vector2 castOrigin = new Vector2(transform.position.x, transform.position.y - playerColliderSize.y / 2);
        // 向正下方发射BoxCast，仅检测地面层
        RaycastHit2D hit = Physics2D.BoxCast(castOrigin, groundCheckerSize, 0f, Vector2.down, groundCheckDistance, groundLayer);
        
        // 调试用：绘制检测射线
        Debug.DrawRay(castOrigin, Vector2.down * groundCheckDistance, Color.green);
        return hit.collider != null;
    }

    private void OnDrawGizmosSelected()
    {
        // 绘制传送范围
        Gizmos.DrawWireSphere(player.transform.position, teleportRange);

        // 绘制地面检测的Box范围
        if (playerCollider != null)
        {
            Vector2 castOrigin = new Vector2(transform.position.x, transform.position.y - playerColliderSize.y / 2);
            Gizmos.DrawWireCube(castOrigin + Vector2.down * groundCheckDistance / 2, groundCheckerSize);
        }
    }
}

关键改动说明 #

1. 组件命名优化：将PlayerSpawner改为PlayerTeleport，功能定位更清晰。
2. 性能优化：在Awake中提前获取玩家碰撞体，避免Update循环中重复调用GetComponent。
3. 目标位置校验：
   • 新增obstacleLayer，明确指定不可穿透的场景物体层（如方块、墙面）。
   • 使用OverlapBoxNonAlloc检测目标区域，确保玩家碰撞体不会嵌入障碍物。
4. 地面检测修复：
   • 将BoxCast起始点改为玩家碰撞体底部中心，仅检测正下方区域。
   • 固定检测方向为Vector2.down，避免因玩家旋转导致的方向错误。
5. 调试辅助：新增Gizmos绘制，可视化传送范围与地面检测区域，方便调试。

配置注意事项 #

• 在Inspector中，groundCheckerSize设置为略小于玩家脚部的尺寸，避免触碰到侧面墙面。
• groundLayer仅包含地面类物体，不要包含墙面或其他障碍物。
• obstacleLayer需包含所有不可穿透的场景物体，确保传送校验准确。

内容的提问来源于stack exchange，提问作者Seyit Şahin