📔(2D) Player 컨트롤러 코드

How to Use

컨트롤러 코드를 Player에 적용할 때 키바인딩을 위한 Input Action Asset을 만들어야합니다.

Input Action Asset "W키와 위쪽 화살표가 Move다" — 키바인딩 설정
PlayerController2D.cs "Move 입력값으로 캐릭터를 움직인다" — 로직

1. Input Action Asset 생성

Project 창 우클릭 → Create > Input Actions
파일 이름을 정확히 PlayerInputActions 로 지정

2. Asset 열기

생성된 PlayerInputActions 파일 더블클릭 → Input Action 에디터 오픈

3. Action Map 설정

좌측 Action Maps 패널의 이름을 Player 로 변경
(List is empty의 경우 + 눌러서 생성)

4. Move Action 설정

중앙 Actions 패널에서 기본 생성된 Action 이름을 Move 로 변경
우측 Properties에서

Action Type → Value
Control Type → Vector 2

5. 바인딩 추가 — WASD

Move 아래 + 클릭 → Add Up/Dow/Left/Right Composite 선택 → 2D Vector 항목 생성
각 방향 클릭 후 우측 Path에서 바인딩: (Listen을 클릭 후 해당 키 누르기)

Up → W [Keyboard]
Down → S [Keyboard]
Left → A [Keyboard]
Right → D [Keyboard]

6. 바인딩 추가 — 화살표키

Move 아래 + 클릭 → Add 2D Vector Composite 한 번 더 추가

Up → Up Arrow [Keyboard]
Down → Down Arrow [Keyboard]
Left → Left Arrow [Keyboard]
Right → Right Arrow [Keyboard]

바인딩이 끝난 후 Save Asset 클릭하여 설정 저장

7. C# 클래스 자동 생성

Asset에서 PlayerInputActions 선택 → Inspector에서

• Generate C# Class 항목에 체크
• C# Class File의 경로를 확인 후 Apply 클릭

PlayerInputActions.cs 파일이 자동 생성됩니다. PlayerController2D.cs가 있는 폴더에 함께 넣습니다.

PlayerController2D.cs

Unity 6+ / New Input System / Rigidbody2D / Top-down 2D

using UnityEngine;

[RequireComponent(typeof(Rigidbody2D))]
public class PlayerController2D : MonoBehaviour
{
  // ===================================================
  // Inspector Fields
  // ===================================================

  [Header("이동 설정")]
  public float moveSpeed = 3.5f;

  [Header("컴포넌트 참조")]
  [SerializeField] private Rigidbody2D rb;
  [SerializeField] private Animator animator;

  // ===================================================
  // Animator Parameter Hashes
  // 매 프레임 문자열 해시 변환 비용을 없애기 위해 미리 캐싱
  // ===================================================

  private static readonly int HashMoveX = Animator.StringToHash("moveX");
  private static readonly int HashMoveY = Animator.StringToHash("moveY");
  private static readonly int HashIsMoving = Animator.StringToHash("isMoving");
  private static readonly int HashLastMoveX = Animator.StringToHash("lastMoveX");
  private static readonly int HashLastMoveY = Animator.StringToHash("lastMoveY");

  // ===================================================
  // Runtime State
  // ===================================================

  private PlayerInputActions input;

  // 현재 프레임의 이동 입력값 (FixedUpdate에서 물리 이동에 사용)
  private Vector2 moveInput = Vector2.zero;

  // 마지막으로 이동한 방향 — 정지 시 idle 방향 결정에 사용
  // 초기값 down: 게임 시작 시 캐릭터가 아래를 바라보는 상태로 시작
  private Vector2 lastMoveDirection = Vector2.down;

  // ===================================================
  // Unity Lifecycle
  // ===================================================

  private void Awake()
  {
    // Inspector에서 할당되지 않았을 경우 GetComponent로 fallback
    // [RequireComponent]가 있으므로 null 반환 없음이 보장됨
    rb = rb != null ? rb : GetComponent<Rigidbody2D>();
    animator = animator != null ? animator : GetComponent<Animator>();

    // 탑뷰: 중력 불필요, 물리 회전 고정
    rb.gravityScale = 0f;
    rb.freezeRotation = true;

    // 입력 시스템 인스턴스 생성
    input = new PlayerInputActions();
  }

  // 오브젝트 활성화 시 입력 활성화
  private void OnEnable()
  {
    input.Enable();
  }

  // 오브젝트 비활성화 시 입력 비활성화 (씬 전환, 일시정지 등 대응)
  private void OnDisable()
  {
    input.Disable();
  }

  private void Update()
  {
    // --- 입력 읽기 ---
    // New Input System: ReadValue는 Polling 방식으로 현재 입력 상태를 즉시 반환
    // WASD와 화살표키는 Input Action Asset에서 동일 Action에 바인딩되어 있으므로
    // 어느 키를 눌러도 동일한 Vector2 값으로 들어옴
    Vector2 rawInput = input.Player.Move.ReadValue<Vector2>();

    // --- 대각선 속도 보정 ---
    // 예: W + D 동시 입력 시 rawInput = (1, 1), sqrMagnitude = 2
    // normalized 없이 이동하면 대각선 방향이 수평/수직보다 √2 ≈ 1.41배 빠름
    // sqrMagnitude > 1 조건: 단일 축 입력(크기 = 1)은 불필요한 normalized 연산 스킵
    if (rawInput.sqrMagnitude > 1f)
      rawInput = rawInput.normalized;

    moveInput = rawInput;

    // --- 마지막 이동 방향 갱신 ---
    // 입력이 있을 때만 갱신 → 정지 시 직전 방향을 유지
    // Animator의 idle 블렌드 트리에서 어느 방향 idle을 재생할지 결정하는 데 사용
    bool isMoving = moveInput.sqrMagnitude > 0f;
    if (isMoving)
      lastMoveDirection = moveInput;

    UpdateAnimation(moveInput, isMoving);
  }

  private void FixedUpdate()
  {
    // MovePosition: Rigidbody2D의 sweep 기반 이동
    // linearVelocity 직접 할당보다 얇은 충돌체 터널링에 안전
    // Time.fixedDeltaTime을 곱해 물리 스텝 간격에 정확히 대응
    Vector2 targetPosition = rb.position + moveInput * moveSpeed * Time.fixedDeltaTime;
    rb.MovePosition(targetPosition);
  }

  // ===================================================
  // Animation
  // ===================================================

  // Animator 파라미터 일괄 업데이트
  // 블렌드 트리 구성:
  //   moveX / moveY     → 이동 중 방향별 walk 애니메이션
  //   isMoving          → idle ↔ walk 전환 트리거
  //   lastMoveX / lastMoveY → 정지 시 마지막 방향의 idle 애니메이션
  private void UpdateAnimation(Vector2 currentMove, bool isMoving)
  {
    animator.SetFloat(HashMoveX, currentMove.x);
    animator.SetFloat(HashMoveY, currentMove.y);
    animator.SetBool(HashIsMoving, isMoving);
    animator.SetFloat(HashLastMoveX, lastMoveDirection.x);
    animator.SetFloat(HashLastMoveY, lastMoveDirection.y);
  }

  // ===================================================
  // Public API
  // ===================================================

  // 넉백 등 외부에서 순간 힘을 가할 때 사용
  // AddForce 후 moveInput을 초기화하지 않으므로
  // 넉백 중에도 플레이어 입력이 즉시 재개됨
  public void AddImpulse(Vector2 force)
  {
    rb.AddForce(force, ForceMode2D.Impulse);
  }

  // 읽기 전용 프로퍼티 — 외부 시스템(카메라, UI 등)에서 상태 참조용
  public Vector2 MoveInput => moveInput;
  public Vector2 LastMoveDirection => lastMoveDirection;
  public bool IsMoving => moveInput.sqrMagnitude > 0f;
}