11강충돌 모양과 레이어·마스크

보이는 것과 부딪히는 것은 다르다#

9강에서 한 번 말했지만, 여기서 못을 박습니다.

이게 불편해 보이지만, 사실 의도적인 설계입니다. 게임에서 "보이는 크기"와 "맞는 크기"는 일부러 다르게 만드는 경우가 훨씬 많기 때문입니다.

레이어와 마스크#

이제 이 강의의 핵심입니다. 초보가 가장 많이 막히는 지점이기도 합니다.

물리 바디와 Area는 각각 두 개의 설정을 가집니다.

충돌은 언제 성립하나#

Area2D는 감지만 하므로 한 방향이면 충분하고, 물리 바디끼리 서로 밀어내려면 양쪽 다 켜져 있어야 합니다.

레이어에 이름 붙이기#

번호만 보면 3일 뒤에 잊어버립니다. Godot은 이름을 붙일 수 있습니다.

프로젝트 설정 → Layer Names → 2D Physics

이 강좌에서 쓸 표준 배치를 정해둡니다.

이름을 붙이면 인스펙터에 체크박스 옆에 이름이 나와서 실수가 확 줄어듭니다.

설정표 — 이대로 하면 된다#

히트박스와 허트박스#

액션 게임의 표준 구조입니다. 이름을 헷갈리지 마세요.

Player              (CharacterBody2D)
                    layer: player / mask: world
├─ Sprite               (Sprite2D)
├─ CollisionShape2D     ← 벽과 부딪히는 몸
├─ Hurtbox          (Area2D)
│                   mask: enemy_hitbox
│   └─ CollisionShape2D ← 맞는 판정 (그림보다 작게)
└─ Attack           (Area2D)
                    layer: player_hitbox / mask: enemy
    └─ CollisionShape2D ← 때리는 판정 (평소엔 꺼둔다)

# 공격 시작
$Attack/CollisionShape2D.disabled = false
# 0.15초 뒤 끄기
await get_tree().create_timer(0.15).timeout
$Attack/CollisionShape2D.disabled = true

실습 — 서로를 통과하는 총알#

목표: 플레이어 총알은 적만 맞히고, 아군과 자기 자신은 통과한다.

1) 레이어 이름 설정#

위 표대로 프로젝트 설정 → Layer Names → 2D Physics 에 1~6번 이름을 채웁니다.

2) 총알 씬#

Bullet              (Area2D)
├─ Sprite2D
└─ CollisionShape2D

인스펙터에서:

• Collision → Layer: player_hitbox (4번)만 체크
• Collision → Mask: enemy(3번), world(1번) 체크

extends Area2D

@export var speed := 900.0
@export var damage := 10

func _ready() -> void:
	# 5초 뒤 자동 소멸 (화면 밖 총알이 쌓이는 걸 막는다)
	await get_tree().create_timer(5.0).timeout
	queue_free()

func _physics_process(delta: float) -> void:
	position += Vector2.RIGHT.rotated(rotation) * speed * delta

func _on_body_entered(body: Node2D) -> void:
	if body.has_method("take_damage"):
		body.take_damage(damage)
	queue_free()

시그널 연결은 12강에서 자세히 다룹니다. 지금은 Area2D를 선택 → 노드 독 → body_entered 를 더블클릭 → 이 스크립트에 연결하면 됩니다.

3) 확인#

• 총알이 적에게 닿으면 사라진다
• 총알이 플레이어를 통과한다
• 총알이 벽에 닿으면 사라진다
• 총알이 다른 총알을 무시한다

다음 강의 — 충돌이 일어났을 때 어떻게 알림을 받는지. Godot의 시그널과 이벤트 기반 사고를 봅니다.