Collision과 Trigger로 수집물 만들기

접촉을 비교할 장면 준비하기

Trigger 이벤트에는 양쪽의 Collider2D, 한쪽 이상의 Rigidbody2D, 한쪽 이상의 Is Trigger 설정이 필요합니다. 먼저 Player와 보석을 준비하고, 첫 접촉 로그를 만든 뒤 설정을 하나씩 바꾸는 테스트로 결과를 비교합니다.

기존 장면에서 컴포넌트 준비하기

1. Scene을 다른 이름으로 저장하기

   수업 프로젝트 GameEngineI에서 Assets/Week4/Week04_JumpCourse.unity를 엽니다. Play를 종료한 뒤 File → Save As를 선택해 Assets/Scenes/Week05_MicroLevel.unity로 저장합니다. 기존 캐릭터 스프라이트와 PlayerController, Move·Jump 참조는 그대로 사용합니다.

   확인이동·점프·착지가 이전과 같습니다.

2. Player의 Collider2D와 Rigidbody2D 확인하기

   Hierarchy에서 Player를 선택하고 Inspector의 기존 Collider2D와 Rigidbody 2D를 확인합니다. Collider2D의 체크박스와 Rigidbody 2D의 Simulated는 켜고, Is Trigger는 끕니다. Rigidbody 2D는 Body Type Dynamic, Gravity Scale 1을 유지합니다. 컴포넌트가 없다면 Add Component에서 필요한 2D 컴포넌트를 검색해 추가합니다. 이미 있다면 중복으로 추가하지 않습니다.

   확인Player에 활성화된 Collider2D와 Rigidbody2D가 함께 있습니다.

3. 보석과 접촉 경계 준비하기

   Project 창의 기존 Collectible.prefab을 Scene으로 하나 끌어옵니다. Hierarchy에서 이름을 Collectible로 지정합니다. Inspector에 Box Collider 2D가 없다면 Add Component → Box Collider 2D로 추가합니다. 다음 비교를 위해 처음에는 Is Trigger를 끈 상태로 둡니다. 보석의 그림과 색은 유지합니다.

   확인이전에 사용한 보석과 Collider 경계가 보입니다.

4. 접촉을 관찰할 위치에 배치하기

   보석을 평평한 바닥 위에 놓습니다. Player가 옆으로 걸어가면 닿을 수 있고, 시작할 때는 서로 떨어져 있어야 합니다. 보석이 바닥에 묻히거나 점프해야 닿는 위치라면, 첫 비교가 쉬운 곳으로 옮깁니다.

   확인시작할 때는 영역 밖에 있고, 걸어가면 안으로 들어옵니다.

수업 프로젝트의 보석 Prefab 경로는 Assets/Week2/Prefabs/Collectible.prefab입니다. 폴더를 다르게 정리했다면 같은 보석 Prefab을 찾아 사용하세요. 이번 설정은 Scene에 놓은 오브젝트에만 추가합니다. Transform의 Scale은 물체의 크기를, Box Collider 2D의 Size와 Offset은 접촉 경계의 크기와 중심을 바꿉니다. 투명한 여백까지 경계에 포함되면 Edit Collider로 보석에 맞춥니다.

같은 보석이라도 접촉 경계를 어떻게 설정하느냐에 따라 Player의 움직임이 달라집니다. 이번에는 Collectible의 Is Trigger 하나만 바꿉니다. 보석의 모양과 위치는 유지하고, 앞에서 배치한 보석으로 두 결과를 비교합니다.

1. A · Is Trigger를 끄고 접근하기

   Play를 시작하고 Player를 보석의 옆면으로 이동시킵니다. 경계에서 막히는지 확인한 뒤 Play를 종료합니다.

   확인충돌 경계에서 이동이 제한됩니다.

2. B · Is Trigger를 켜고 접근하기

   Collectible의 Box Collider 2D에서 Is Trigger를 켭니다. 다시 Play를 시작하고 같은 방향으로 보석에 접근합니다.

   확인Player가 통과하며 수집물은 그대로 보입니다.

3. 비교를 마치고 설정 저장하기

   비교가 끝나면 Play를 종료합니다. Player와 바닥의 Collider는 유지하고, Collectible의 Is Trigger를 켠 상태로 Scene을 저장합니다.

   확인Collectible만 통과할 수 있고, 바닥과 발판에는 계속 착지합니다.

일반 충돌이 발생했을 때는 OnCollisionEnter2D(Collision2D collision)로 알림을 받을 수 있습니다. 이번 수집물은 통과할 수 있어야 하므로 OnTriggerEnter2D(Collider2D other)를 사용합니다. 두 메서드는 이름과 매개변수의 자료형이 다릅니다. 이제 화면에서 확인한 진입을 Console에도 기록해 봅시다.

보석을 지나간 순간을 Console에 남겨 봅시다. 첫 코드는 접촉을 기록하는 일만 합니다. 어느 오브젝트의 코드가 실행됐고, 어떤 상대가 들어왔는지를 로그 한 줄로 확인합니다.

1. Collectible.cs 만들기

   Play가 종료된 상태에서 Assets/Scripts에 Collectible.cs를 만듭니다. 파일 내용을 아래 전체 코드로 교체합니다. 기본으로 생성된 Start·Update가 있다면 함께 지우고 아래 코드만 남깁니다.

   확인파일 이름과 class 이름이 Collectible로 같습니다.

2. 보석에 스크립트 붙이기

   파일을 저장하고 Unity의 컴파일 오류가 없는지 확인합니다. Hierarchy에서 Collectible을 선택한 뒤 Collectible.cs를 Inspector에 추가합니다. 이번 코드를 실행할 오브젝트는 보석이므로 스크립트도 보석에 붙입니다.

   확인수집물에 Sprite Renderer, Box Collider 2D, Collectible 컴포넌트가 있습니다.

using UnityEngine;

public class Collectible : MonoBehaviour
{
    private void OnTriggerEnter2D(Collider2D other)
    {
        Debug.Log("[접촉] 자신: " + gameObject.name + " / 상대: " + other.name);
    }
}

1. Console 준비하기

   Console을 열고 검색어를 지웁니다. 일반 Log 표시를 켜고 Clear를 누릅니다. 같은 메시지도 한 줄씩 볼 수 있도록 Collapse는 끕니다.

   확인같은 메시지가 나와도 진입할 때마다 한 줄씩 보입니다.

2. 영역 밖에서 안으로 들어오기

   Play를 시작하고 Player를 보석의 Collider 안으로 이동시킵니다.

   확인[접촉] 자신: Collectible / 상대: Player 한 줄이 나옵니다.

3. 머무를 때와 다시 들어올 때 비교하기

   영역 안에 잠시 머물러 봅니다. 이어서 완전히 밖으로 나갔다가 다시 들어옵니다.

   확인머무는 동안 추가 Enter 로그는 없고 재진입할 때 한 줄 더 나옵니다.

[접촉] 자신: Collectible / 상대: Player
[접촉] 자신: Collectible / 상대: Player

Enter는 영역에 들어오는 순간을 뜻합니다. 같은 오브젝트도 밖으로 나갔다가 다시 들어오면 새 로그를 남깁니다. 확인을 마치면 Play를 종료합니다. 이제 이 정상 결과를 기준으로 물리 설정을 하나씩 바꿔 봅시다.

앞에서 만든 1단계 코드를 그대로 사용합니다. 각 테스트는 Play를 종료한 상태에서 시작합니다. 설정 하나만 바꾸고 Console을 비운 뒤 새 Play로 비교합니다. 확인이 끝나면 Play를 종료하고 바꾼 설정을 복구합니다.

1. A · 보석의 Collider2D를 끄고 접근하기

   Collectible의 Box Collider 2D 제목 왼쪽 체크박스를 끕니다. Sprite Renderer와 Is Trigger 값은 유지합니다. Play를 시작하고 Player로 보석을 통과합니다. 확인 후 Play를 종료하고 Box Collider 2D를 다시 켭니다.

   확인보석은 보이지만 [접촉] 로그가 나오지 않습니다.

2. B · Rigidbody2D의 Simulated를 끄고 겹쳐 보기

   Player의 Rigidbody 2D에서 Simulated만 끕니다. Play를 시작하면 물리 이동이 멈춥니다. Scene 뷰의 이동 도구로 Player를 보석과 겹쳐 봅니다. 확인 후 Play를 종료하고 Simulated를 다시 켭니다.

   확인그림을 겹쳐도 [접촉] 로그가 나오지 않습니다.

3. C · Is Trigger를 끄고 접근하기

   Collectible의 Box Collider 2D는 켠 채 Is Trigger만 끕니다. Play를 시작하고 Player로 보석의 옆면에 접근합니다. 확인 후 Play를 종료하고 Is Trigger를 다시 켭니다.

   확인보석의 경계에 막히고, [접촉] 로그는 나오지 않습니다.

4. 설정을 복구하고 다시 통과하기

   양쪽 Collider2D와 Player의 Simulated가 켜져 있는지 확인합니다. Is Trigger는 보석에서만 켭니다. Console을 비우고 Play를 시작해 보석에 들어갑니다. 확인 후 Play를 종료하고 Scene을 저장합니다.

   확인보석을 통과할 때 [접촉] 로그가 다시 나옵니다.

B에서는 Rigidbody2D를 삭제하지 않고 물리 참여 여부를 비교했습니다. Simulated를 끄면 Rigidbody2D와 연결된 Collider2D가 함께 물리 계산에서 제외됩니다. 이번 장면에서는 Player의 Rigidbody2D가 한쪽 몸체 조건을 충족하므로 보석에 Rigidbody2D를 추가하지 않습니다.

로그는 Player가 들어올 때마다 한 줄씩 나왔습니다. Unity가 진입을 감지해 OnTriggerEnter2D를 호출했기 때문입니다. 3주차의 Start와 Update도 Unity가 정해진 시점에 호출했습니다. 이번에는 그 시점이 Trigger 영역에 들어오는 순간입니다. 이처럼 사건이 발생했을 때 Unity가 호출하는 메서드를 이벤트 콜백이라고 부릅니다.

OnTriggerEnter2D는 class 안에서 다른 메서드와 나란히 정의합니다. Update 안에서 직접 호출할 필요는 없습니다. Unity가 호출할 수 있도록 메서드 이름의 철자·대소문자·2D 표기와 매개변수 자료형을 정확히 작성합니다.

로그에서 “자신”은 스크립트가 붙은 Collectible이고, “상대”는 들어온 Player입니다. gameObject.name으로 자신의 이름을, other.name으로 상대 Collider가 붙은 오브젝트의 이름을 읽습니다. +는 이 이름들을 문자열에 이어 붙입니다. 먼저 스크립트가 붙은 위치를 짚으면 두 이름을 구분하기 쉽습니다.

Collider2D other · 들어온 상대를 받는 매개변수

other에는 이번에 들어온 상대의 Collider가 전달됩니다. Player가 들어오면 Player의 Collider를, 다른 물체가 들어오면 그 물체의 Collider를 받습니다. 매개변수 이름은 바꿀 수 있지만 메서드 안에서 사용하는 이름도 함께 바꿔야 합니다. 이번에는 other로 통일합니다.

접촉을 알게 되었으니 수집의 규칙을 정할 차례입니다. 이번 규칙은 “Player가 들어왔을 때만 반응한다”입니다. 3주차에 배운 if로 상대의 Tag를 확인합니다. 이 단계에서는 확인 로그까지만 출력하고 보석은 남겨 둡니다.

Inspector에서 Player Tag 설정하기

1. Play를 종료하고 Player 선택하기

   Play 버튼을 눌러 실행을 종료합니다. Project 창의 스크립트나 보석 대신 Hierarchy의 Player 오브젝트를 선택합니다. Inspector에 Player의 이름과 Collider2D, Rigidbody 2D가 보이는지 확인합니다.

   확인Player 오브젝트의 Inspector를 보고 있습니다.

2. 이름 아래의 Tag 드롭다운 열기

   Inspector 맨 위에서 오브젝트 이름 바로 아래에 있는 Tag를 찾습니다. 보통 현재 값은 Untagged입니다. 그 드롭다운을 클릭합니다. 옆의 Layer나 Add Component가 아니라 Tag 항목을 엽니다.

   확인Untagged, Player 등이 있는 태그 목록이 열립니다.

3. 기본 제공되는 Player 선택하기

   목록에서 대문자 P로 시작하는 Player를 선택합니다. Player는 Unity의 기본 태그이므로 Add Tag…로 새로 만들 필요가 없습니다. 목록이 닫힌 뒤 Tag 칸에 Player가 표시되는지 확인합니다.

   확인오브젝트의 이름과 별개로 Tag 값이 Player입니다.

4. 선택을 바꾸었다가 다시 확인하고 저장하기

   Hierarchy에서 Collectible을 선택했다가 Player를 다시 선택합니다. Player의 Tag가 Player로 유지되면 File → Save로 Scene을 저장합니다. Play 중 변경한 값은 실행을 종료하면 돌아갈 수 있으므로, 태그 설정과 저장은 Play를 종료한 상태에서 합니다.

   확인저장한 Scene에서 Player의 Tag가 Player로 남아 있습니다.

같은 파일에 조건문 추가하기

태그 설정을 마쳤다면 같은 Collectible.cs 파일을 아래 전체 코드로 교체하고 저장합니다. Unity에서 컴파일이 끝났는지 확인합니다. 보석에 붙어 있는 Collectible 컴포넌트 하나를 계속 사용합니다. 첫 [접촉] 로그 다음에 조건문과 [확인] 로그가 추가됩니다.

using UnityEngine;

public class Collectible : MonoBehaviour
{
    private void OnTriggerEnter2D(Collider2D other)
    {
        Debug.Log("[접촉] 자신: " + gameObject.name + " / 상대: " + other.name);

        if (other.CompareTag("Player"))
        {
            Debug.Log("[확인] Player Tag");
        }
    }
}

비교 결과가 true일 때는 if의 중괄호 안을 실행합니다. false일 때는 그 부분을 건너뛰고 메서드 끝으로 갑니다. 첫 [접촉] 로그는 if 앞에 있으므로 두 경우 모두 출력됩니다.

이제 코드는 접촉한 상대가 Player인지 구분할 수 있습니다. [확인] 로그가 나온 자리에 보석의 수집 반응을 넣어 봅시다.

이제 Console에서 확인한 접촉을 화면의 변화로 이어 봅시다. if 안의 [확인] 로그를 [수집] 로그로 바꾸고, 바로 다음에 보석 자신을 비활성화하는 한 줄을 추가합니다. Player를 확인하는 조건은 그대로 사용합니다.

Play를 종료하고 Player의 Tag가 Player인지, Collectible의 Is Trigger가 켜져 있는지 확인합니다. 같은 Collectible.cs를 아래 코드로 교체한 뒤 저장하고 컴파일을 기다립니다.

using UnityEngine;

public class Collectible : MonoBehaviour
{
    private void OnTriggerEnter2D(Collider2D other)
    {
        Debug.Log("[접촉] 자신: " + gameObject.name + " / 상대: " + other.name);

        if (other.CompareTag("Player"))
        {
            Debug.Log("[수집] Collectible 비활성화");
            gameObject.SetActive(false);
        }
    }
}

접촉 한 번에 실행되는 코드 따라가기

이 코드에서 gameObject는 Collectible, other.gameObject는 들어온 Player를 가리킵니다. 따라서 gameObject.SetActive(false)는 “Collectible을 비활성화한다”라고 읽습니다. other.gameObject에 이 메서드를 호출하면 Player가 비활성화되므로, 동작과 함께 그 대상도 확인합니다.

1. 로그와 화면의 변화 확인하기

   Console을 비우고 Play를 시작합니다. Player를 움직여 보석에 닿게 합니다.

   확인접촉 로그 다음에 수집 로그가 나오고 보석이 사라집니다.

2. Hierarchy에서 비활성 상태 확인하기

   Play를 유지한 채 Hierarchy에서 Collectible의 이름과 활성 상태를 살펴봅니다.

   확인Collectible의 이름이 흐리게 남아 있고, 활성 상태가 꺼져 있습니다.

3. Play를 종료하고 보석 확인하기

   Play를 종료한 뒤 Scene에서 보석이 다시 보이는지 확인합니다.

   확인보석이 다시 활성화되어 다음 실행을 준비할 수 있습니다.

코드가 길어질수록 어느 경우에 실행을 마치는지가 눈에 잘 들어와야 합니다. 이번에는 Player가 아니면 먼저 메서드 실행을 마치는 방식으로 정리합니다. Player인 경우에는 return을 건너뛰고 수집 코드를 실행하므로, 앞 단계와 수집 결과는 같습니다.

Play를 종료한 상태에서 같은 Collectible.cs를 아래 코드로 교체하고 저장합니다. Tag와 Trigger 설정은 유지합니다.

using UnityEngine;

public class Collectible : MonoBehaviour
{
    private void OnTriggerEnter2D(Collider2D other)
    {
        Debug.Log("[접촉] 자신: " + gameObject.name + " / 상대: " + other.name);

        if (!other.CompareTag("Player"))
        {
            return;
        }

        Debug.Log("[수집] Collectible 비활성화");
        gameObject.SetActive(false);
    }
}

여기서 return이 끝내는 범위는 이번 OnTriggerEnter2D 메서드 실행입니다. Player의 이동과 게임 실행은 계속됩니다. 수집 코드가 if의 중괄호 밖에 있어도, return을 실행한 경우에는 그 아래 줄로 내려가지 않습니다.

3주차에서 조건에 따라 메서드의 남은 작업을 건너뛴 것과 같은 방식입니다. 2교시에는 이 부분에 “이미 수집했는가”, “진행 상태 컴포넌트가 있는가”라는 확인을 추가합니다.

보석을 통과했는데도 그림이 남아 있다면, 실행은 어디까지 진행된 걸까요? 로그에는 코드가 지나온 흔적이 남습니다. 4단계의 [접촉]과 [수집] 로그를 비교하면 메서드가 호출됐는지, 수집 처리까지 도달했는지를 나누어 확인할 수 있습니다.

Tag를 바꾸어 오류를 만들고 복구하기

앞 단계에서 확인한 정상 결과를 기준으로 오류를 만들어 봅시다. Play를 종료하고, return 직전에 중단 이유를 출력하는 로그 한 줄을 추가합니다. 아래 관찰용 코드로 교체·저장한 뒤 컴파일을 확인합니다. 이후 두 실행에서는 코드를 유지하고 Player의 Tag만 바꿉니다. Trigger와 컴포넌트 연결도 그대로 둡니다.

using UnityEngine;

public class Collectible : MonoBehaviour
{
    private void OnTriggerEnter2D(Collider2D other)
    {
        Debug.Log("[접촉] 자신: " + gameObject.name + " / 상대: " + other.name);

        if (!other.CompareTag("Player"))
        {
            Debug.Log("[중단] Player Tag가 아닙니다.");
            return;
        }

        Debug.Log("[수집] Collectible 비활성화");
        gameObject.SetActive(false);
    }
}

1. Tag를 Untagged로 바꾸기

   Play가 종료된 상태에서 Player의 Tag를 Untagged로 바꿉니다. Console을 비우고 다시 Play를 시작해 같은 보석에 들어갑니다.

   확인[접촉] → [중단], Collectible은 남음

2. 실행이 끝난 줄 찾기

   [중단] 로그 다음의 return을 찾아보세요. 이 줄에서 메서드 실행이 끝난다는 점을 근거로 [수집] 로그가 나오지 않은 이유를 설명합니다.

   확인접촉은 감지됐고, Tag 조건에서 실행을 마쳤습니다.

3. Tag를 복구하고 다시 실행하기

   Play를 종료하고 Tag를 Player로 되돌립니다. 관찰용 코드는 유지한 채 Console을 비웁니다. 다시 Play를 시작하고 같은 보석에 들어갑니다.

   확인[접촉] → [수집]이 돌아오고 수집물이 비활성화됩니다.

[접촉] 자신: Collectible / 상대: Player
[중단] Player Tag가 아닙니다.

[접촉] 자신: Collectible / 상대: Player
[수집] Collectible 비활성화

로그가 없을 때 순서대로 확인하기

먼저 Console의 검색어와 Log 표시, 컴파일 오류를 확인합니다. 이어서 Collectible 스크립트의 연결 위치, 메서드 철자, 두 Collider의 실제 겹침을 살펴봅니다. 마지막으로 Is Trigger, Player Rigidbody2D의 Simulated, Layer의 접촉 설정을 확인합니다. 한 항목씩 확인하고 다시 실행해야 원인을 구분할 수 있습니다.

보석을 줍는 순간과 길 안내를 받는 순간은 화면에서 서로 다른 경험입니다. 두 장면 모두 Player가 어떤 영역에 들어왔다는 사실에서 시작합니다. 이번에는 Player가 들어오면 안내를 출력하고, 구역은 계속 남아 있는 GuideZone을 생각해 봅시다. 해설을 열기 전에 수집 코드에서 유지할 부분과 바꿀 부분을 구분하세요.

해설과 적용 코드 · GuideZone.cs

같은 진입 감지, 서로 다른 반응

항목	Collectible	GuideZone
진입 감지	OnTriggerEnter2D	같은 메서드 사용
대상	Player Tag	같은 조건 사용
반응	수집 로그와 자기 비활성화	안내 로그만 출력
재진입	비활성화되어 새 접촉 없음	구역이 남아 있으므로 다시 안내

gameObject.SetActive(false)를 빼고 [수집] 로그를 안내 문장으로 바꿉니다. 안내는 Player 확인을 통과한 뒤에 출력합니다. GuideZone이 활성 상태로 남아 있으므로 재진입할 때도 반응합니다. 첫 진입에 한 번, 머무는 동안에는 추가 출력이 없고, 다시 들어오면 한 번 더 출력됩니다.

GuideZone.cs · 적용 문제 전체 코드코드 복사

using UnityEngine;

public class GuideZone : MonoBehaviour
{
    private void OnTriggerEnter2D(Collider2D other)
    {
        if (!other.CompareTag("Player"))
        {
            return;
        }

        Debug.Log("안내: 오른쪽 발판으로 이동하세요.");
    }
}

예측한 내용을 시연으로 확인하기

미리 준비한 GuideZone을 켜고 Console을 비운 뒤 Play를 시작합니다. Player가 들어와 머무르고, 밖으로 나갔다가 다시 들어오는 모습을 함께 봅시다. 안내가 출력되는 횟수를 예상과 비교하세요. 수업에서는 반응의 차이를 확인하고, 직접 만드는 방법은 아래 절차로 복습합니다.

시연을 마치면 Play를 종료하고 GuideZone을 비활성화합니다. Collectible의 4단계 코드와 정상 설정을 유지한 채 Scene을 저장합니다. 마지막 3분은 핵심 개념과 다음 교시의 준비 상태를 확인하는 데 씁니다.

보석 하나를 수집하는 짧은 순간에 접촉 감지, 상대 확인, 반응 실행이 이어졌습니다. 이제 그 과정을 자신의 말로 설명해 봅시다. 아래 세 질문에 먼저 답한 뒤 해설을 열어 확인하세요.

보석이 화면에서 사라진 뒤에도 게임은 몇 개를 모았는지 기억해야 합니다. 지금 코드는 수집 개수를 기록하지 않습니다. 2교시에는 수집한 결과를 Player에 남기는 방법을 배웁니다. 오늘의 “접촉 → 상대 확인 → 반응”에 다른 컴포넌트의 메서드를 호출하는 과정을 이어 붙입니다.

• Rigidbody2D.simulated ↗몸체와 연결된 Collider2D의 물리 시뮬레이션 참여
• Tags · 태그 지정 ↗Inspector의 Tag 위치 · 기본 Player 태그 · 태그 생성과 지정
• OnTriggerEnter2D ↗호출 시점 · 상대 Collider · 필요한 물리 설정
• CompareTag ↗Tag 비교와 true·false 반환
• GameObject.SetActive ↗GameObject와 컴포넌트의 활성 상태
• Layer Collision Matrix ↗Layer 사이의 접촉 허용 설정