Unity 2D 플랫폼 게임의 레이캐스트 기반 충돌 검사 시스템

정밀한 지면 및 벽 감지 구현

2D 액션 플랫폼 게임에서 캐릭터의 상태 전환은 물리 엔진의 충돌 정보보다 더 정밀한 감지 방식이 필요할 수 있습니다. 특히 점프 가능 여부나 벽 점프 상황을 판단할 때는 Physics2D.Raycast 를 사용하여 특정 지점에서射线을 발사하는 방식이 널리 쓰입니다. 이를 통해 캐릭터의 발 끝이나 벽 쪽에서 정확한 거리 정보를 얻을 수 있습니다.

플레이어 스크립트 설정

캐릭터 컨트롤러 스크립트에는 감지 지점을 위한 Transform 참조와 레이의 길이, 그리고 충돌을 확인할 레이어 마스크가 필요합니다. 인스펙터에서 빈 GameObject 를 생성하여 발 아래쪽과 벽 쪽에 배치한 후 연결합니다.


using UnityEngine;

public class CharacterController : MonoBehaviour
{
    [Header("Movement Parameters")]
    public float movementSpeed = 10f;
    public float jumpPower = 18f;

    [Header("Collision Sensors")]
    [SerializeField] private Transform floorPivot;
    [SerializeField] private float floorScanRange = 0.1f;
    [SerializeField] private Transform wallSensor;
    [SerializeField] private float wallScanRange = 0.2f;
    [SerializeField] private LayerMask groundMask;
    [SerializeField] private LayerMask wallMask;

    #region Components
    public Animator animator { get; private set; }
    public Rigidbody2D rigidbody2D { get; private set; }
    #endregion

    #region State Machine
    public CharacterStateMachine stateMachine { get; private set; }
    public CharacterStandState standState { get; private set; }
    public CharacterAirborneState airborneState { get; private set; }
    #endregion

    private void Awake()
    {
        stateMachine = new CharacterStateMachine();
        standState = new CharacterStandState(this, stateMachine, "Idle");
        airborneState = new CharacterAirborneState(this, stateMachine, "Fall");
    }

    private void Start()
    {
        animator = GetComponentInChildren<Animator>();
        rigidbody2D = GetComponent<Rigidbody2D>();
        stateMachine.Initialize(standState);
    }

    private void Update()
    {
        stateMachine.CurrentState.Update();
    }

    public void SetVelocity(float xVel, float yVel)
    {
        rigidbody2D.velocity = new Vector2(xVel, yVel);
    }

    public bool HasFloorContact()
    {
        return Physics2D.Raycast(floorPivot.position, Vector2.down, floorScanRange, groundMask);
    }

    private void OnDrawGizmos()
    {
        if (floorPivot != null)
        {
            Gizmos.color = Color.green;
            Gizmos.DrawLine(floorPivot.position, new Vector3(floorPivot.position.x, floorPivot.position.y - floorScanRange));
        }
        
        if (wallSensor != null)
        {
            Gizmos.color = Color.red;
            Gizmos.DrawLine(wallSensor.position, new Vector3(wallSensor.position.x + wallScanRange, wallSensor.position.y));
        }
    }
}

상태 머신 통합

지면 감지 로직은 상태 머신 내부에서 호출되어 상태 전환을 결정합니다. 지면에 서 있을 때는 점프 입력을 대기하며, 공중 상태에서는 지면 접촉 여부를 확인하여 착지 상태로 돌아갑니다.

지면 상태 (Stand State)

캐릭터가 지면에 접촉하고 있을 때 활성화되는 상태입니다. 공간키 입력 시 점프 상태로 전환합니다.


using UnityEngine;

public class CharacterStandState : CharacterState
{
    public CharacterStandState(CharacterController _character, CharacterStateMachine _stateMachine, string _animBool) 
        : base(_character, _stateMachine, _animBool)
    {
    }

    public override void Enter()
    {
        base.Enter();
    }

    public override void Exit()
    {
        base.Exit();
    }

    public override void Update()
    {
        base.Update();

        if (Input.GetKeyDown(KeyCode.Space) && character.HasFloorContact())
        {
            stateMachine.ChangeState(character.airborneState);
        }
    }
}

공중 상태 (Airborne State)

캐릭터가 공중에 있을 때의 로직을 담당합니다. 지면 감지 레이에서 충돌이 발생하면 즉시 지면 상태로 복귀합니다.


using UnityEngine;

public class CharacterAirborneState : CharacterState
{
    public CharacterAirborneState(CharacterController _character, CharacterStateMachine _stateMachine, string _animBool) 
        : base(_character, _stateMachine, _animBool)
    {
    }

    public override void Enter()
    {
        base.Enter();
    }

    public override void Exit()
    {
        base.Exit();
    }

    public override void Update()
    {
        base.Update();

        if (character.HasFloorContact())
        {
            stateMachine.ChangeState(character.standState);
        }
    }
}

디버깅 시각화

OnDrawGizmos 메서드를 통해 에디터 상에서 레이캐스트의 시작점과 방향, 거리를 시각적으로 확인할 수 있습니다. 이는 감지 지점이 캐릭터 스프라이트 안에 숨어 있지 않은지, 혹은 벽을 너무 멀리 감지하지는 않는지 확인하는 데 유용합니다. 녹색 선은 지면 감지, 빨간 선은 벽 감지 범위를 나타냅니다.

태그: Unity3D 2d-platformer physics2d raycast state-machine

10월 12일 16:20에 게시됨