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