유니티 2D 플랫포머 – 플레이어 움직임 구현하기

유니티로 2D 플랫포머 게임 개발에 도전한 초보자 분들 중에, 플레이어의 움직임을 어떤 식으로 구현해야 할 지 막막해 하는 분들이 있습니다. 이런 분들을 대상으로 가장 기본적인 플레이어 움직임을 C# 스크립트로 구현하는 방법을 소개합니다.

프로젝트 생성

제일 먼저 유니티 허브에서 새 2D 프로젝트를 생성합니다.

바닥 스프라이트 생성

다음으로 Assets > Create > 2D > Sprites > Square 를 선택하여 기본 스프라이트를 하나 생성합니다.

이름을 Platform 이라고 지정해 주겠습니다.

드래그해서 씬 하이어라키에 갖다 놓겠습니다. 그리고 가로 스케일을 10으로 늘리겠습니다.

Sprite Renderer에서 색깔을 바꿔 줍니다.

플레이어 스프라이트 생성

이제 같은 요령으로 플레이어 스프라이트를 생성하겠습니다. 이번에는 캡슐(Capsule) 모양을 선택합니다.

이번에는 이름을 Player 로 지정합니다.

하이어라키 뷰로 드래그해서 갖다 놓습니다. 스케일을 0.5로 줄입니다.

색깔을 바꾸고, 위치를 조정해서 플랫폼 위로 옮깁니다.

잘 보면 게임 오브젝트의 이름이 바뀌지 않은 것을 알 수 있습니다. 이 경우 다음과 같이 이름을 바꿔 줍니다. (안 바꿔도 상관은 없습니다)

충돌체와 리지드바디 2D 추가

이제 충돌 감지를 위한 컴포넌트들을 추가하겠습니다. 우선 Player 를 선택하고 Add Component 버튼을 누릅니다. Capsule Collider 2D 를 검색해서 추가합니다.

리지드바디 2D 도 찾아서 붙여 줍니다.

현재 스프라이트는 캡슐 형태라 나중에 좌우로 움직일 때 넘어질 수 있습니다. 이를 방지하기 위해 Rigidbody 2D 의 Constraints 를 열고 Freeze Rotation 을 체크해 줍니다.

다음으로는 Platform 을 선택하고, Box Collider 2D 를 붙여 주겠습니다. 여기에는 리지드바디가 필요 없으니 Box Collider 2D 만 붙여 주시기 바랍니다.

플레이어 캐릭터 동작 스크립트 작성

이 코드에서는 가장 간단한 플레이어 캐릭터 동작만을 구현합니다. 예를 들어 2D 환경에서 플레이어 캐릭터의 좌우 이동 및 점프 기능은 다음과 같은 방식으로 작성할 수 있습니다.

스크립트 생성

먼저, Unity 스크립트를 생성하고 PlayerMovement라는 클래스를 정의합니다.

이제 이 스크립트 파일을 더블 클릭해서 비주얼 스튜디오를 열겠습니다. 기본적으로 MonoBehaviour를 상속받은 빈 스크립트가 생성됩니다.

using UnityEngine;

public class PlayerMovement : MonoBehaviour
{
    void Start()
    {
    }

    void Update()
    {
    }
}

필요한 변수 선언

이제 이동 속도를 나타내는 moveSpeed라는 float 변수를 선언하고 기본값을 5f로 지정합니다.

public class PlayerMovement : MonoBehaviour
{
    public float moveSpeed = 5f;

    void Start()
    {
    }

    ...
}

다음으로, 점프 높이를 결정하는 jumpForce라는 float 변수를 선언하고 기본값을 7f로 지정합니다.

public class PlayerMovement : MonoBehaviour
{
    public float moveSpeed = 5f;
    public float jumpForce = 7f;

    void Start()
    ...
}

점프 가능 여부를 결정하기 위해 groundCheck라는 Transform 변수와 groundLayer라는 LayerMask 변수를 선언합니다.

public class PlayerMovement : MonoBehaviour
{
    public float moveSpeed = 5f;
    public float jumpForce = 7f;
    public Transform groundCheck;
    public LayerMask groundLayer;

    void Start()
    ...
}

이제 Rigidbody2D 컴포넌트를 참조할 rb 변수와 땅에 닿았는지 확인하기 위한 isGrounded 불 변수를 선언합니다. 또한, 땅에 닿았는지 확인하는 데 사용되는 원의 반지름을 나타내는 groundCheckRadius 변수를 0.2f로 초기화합니다.

public class PlayerMovement : MonoBehaviour
{
    public float moveSpeed = 5f;
    public float jumpForce = 7f;
    public Transform groundCheck;
    public LayerMask groundLayer;

    private Rigidbody2D rb;
    private bool isGrounded;
    private float groundCheckRadius = 0.2f;

    
    ...
}

Start 및 Update 메서드 구현

Start() 메서드에서 Rigidbody2D 컴포넌트를 가져와 rb 변수에 할당합니다.

void Start()
{
    rb = GetComponent<Rigidbody2D>();
}

Update() 메서드에서 먼저 groundCheck 위치를 중심으로 반지름이 groundCheckRadius인 원이 groundLayer에 겹치는지 확인하여 isGrounded 변수에 할당합니다.

void Update()
{
    isGrounded = Physics2D.OverlapCircle(groundCheck.position, groundCheckRadius, groundLayer);
}

이제, 수평 입력을 받아 moveInput 변수에 저장합니다. 이 값은 -1, 0, 또는 1이 될 수 있으며, 각각 왼쪽, 정지, 오른쪽을 나타냅니다.

void Update()
{
    isGrounded = Physics2D.OverlapCircle(groundCheck.position, groundCheckRadius, groundLayer);

    float moveInput = Input.GetAxis("Horizontal");
}

Rigidbody2D의 속도를 업데이트하여 캐릭터가 좌우로 움직이도록 합니다. moveInput에 moveSpeed를 곱하고, y축 속도는 그대로 유지합니다.

void Update()
{
    isGrounded = Physics2D.OverlapCircle(groundCheck.position, groundCheckRadius, groundLayer);

    float moveInput = Input.GetAxis("Horizontal");
    rb.velocity = new Vector2(moveInput * moveSpeed, rb.velocity.y);
}

마지막으로, 점프 키가 눌렸을 때(Input.GetButtonDown(“Jump”))와 캐릭터가 땅에 있을 때(isGrounded) 점프를 실행합니다. Rigidbody2D의 y축 속도를 jumpForce로 설정하여 캐릭터가 위로 점프하도록 합니다.

void Update()
{
    isGrounded = Physics2D.OverlapCircle(groundCheck.position, groundCheckRadius, groundLayer);

    float moveInput = Input.GetAxis("Horizontal");
    rb.velocity = new Vector2(moveInput * moveSpeed, rb.velocity.y);

    if (Input.GetButtonDown("Jump") && isGrounded)
    {
        rb.velocity = Vector2.up * jumpForce;
    }
}

완성된 코드

이제 완성된 코드는 다음과 같습니다.

using System.Collections;
using System.Collections.Generic;
using UnityEngine;

public class PlayerMovement : MonoBehaviour
{
    public float moveSpeed = 5f;
    public float jumpForce = 7f;
    public Transform groundCheck;
    public LayerMask groundLayer;

    private Rigidbody2D rb;
    private bool isGrounded;
    private float groundCheckRadius = 0.2f;

    void Start()
    {
        rb = GetComponent<Rigidbody2D>();
    }

    void Update()
    {
        isGrounded = Physics2D.OverlapCircle(groundCheck.position, groundCheckRadius, groundLayer);

        float moveInput = Input.GetAxis("Horizontal");
        rb.velocity = new Vector2(moveInput * moveSpeed, rb.velocity.y);

        if (Input.GetButtonDown("Jump") && isGrounded)
        {
            rb.velocity = Vector2.up * jumpForce;
        }
    }
}

Player 에 스크립트 추가

이제 하이어라키 뷰에서 Player를 선택하고, 방금 작성한 PlayerMovement 스크립트를 플레이어 캐릭터의 게임 오브젝트에 추가합니다.

충돌 체크 기준점 추가

다음으로 캐릭터가 서있을 때 땅에 닿는 부분 근처에 새로운 빈 게임 오브젝트를 생성하고, 이 오브젝트를 groundCheck로 지정합니다. 이 오브젝트는 캐릭터가 땅에 닿았는지 확인하는 기준점 역할을 합니다.

먼저 Player 를 선택하고 마우스 우측 버튼 > Create Empty 를 선택해서 빈 게임 오브젝트를 만듭니다.

이름을 groundCheck 로 변경하고 Y 값을 -1로 조정해서 플레이어 캐릭터 바닥에 맞춥니다.

이제 Player 를 선택하고, 방금 만든 groundCheck 를 드래그해서 Player Movement 스크립트의 Ground Check 에 갖다 놓습니다.

Ground 레이어 생성

이제 지면(Platform)에 별도의 레이어 (예: “Ground”)를 지정하여 지상 오브젝트를 분류해야 합니다. 이를 위해 먼저 Platform 을 선택하고, 인스펙터 상단의 Layer 를 선택한 뒤 ‘Add Layer’를 클릭합니다.

빈 레이어를 찾아 Ground 라는 이름을 지정해 줍니다.

다시 Platform 을 선택하고, Layer 를 방금 새로 만든 Ground 로 바꿔 줍니다.

이제 마지막으로 Player 를 선택한 뒤, PlayerMovement 스크립트에서 Ground Layer 변수에 Ground 레이어를 할당합니다. 이 레이어는 캐릭터가 땅에 닿았는지 판단하는 데 사용됩니다.

이제 모든 준비가 끝났습니다. 코드가 원하는대로 동작하도록 설정되면, 플레이어는 좌우 방향키나 A와 D 키를 사용하여 좌우로 움직일 수 있습니다. 또한, 스페이스바를 눌러 점프할 수 있습니다. 이때, 캐릭터가 땅에 닿아 있어야만 점프가 가능하며, 점프 중에는 다시 점프할 수 없습니다. 이 기능들은 2D 플랫포머 게임에서 일반적으로 사용되는 기본 움직임입니다.

게임 플레이 화면

다음은 게임을 실행한 장면의 영상입니다.