＋ 부록

용어 사전

강좌 본문에 나오는 노드와 용어 76개입니다. 본문에서 Area2D 같은 이름을 누르면 그 자리에서 요약이 뜨고, 여기서는 전체를 훑어볼 수 있습니다.

노드 37개

AnimatedSprite2D 여러 장의 그림을 이름 붙은 애니메이션으로 묶어 재생한다.
AnimationPlayer 아무 노드의 아무 속성이나 시간축에 올려 애니메이션한다. 타임라인 편집기.
Area2D 감지만 하는 영역. 밀어내지 않고 "들어왔다·나갔다"를 알려준다.
AspectRatioContainer 자식의 가로세로 비율을 유지한다.
AudioStreamPlayer2D 위치가 있는 소리. 멀면 작게, 좌우로 치우쳐 들린다.
Button 누를 수 있는 버튼. pressed 시그널을 쏜다.
Camera2D 화면이 어디를 비출지 정한다.
CanvasItem 화면에 뭔가를 그리는 노드들의 공통 조상. Node2D 와 Control 이 여기서 갈린다.
CanvasLayer 카메라의 영향을 받지 않는 별도의 그리기 층.
CenterContainer 자식을 가운데 놓는다.
CharacterBody2D 내가 매 프레임 어디로 갈지 정하고, 엔진은 "거기 벽이 있다"만 알려주는 바디.
CollisionShape2D 충돌 판정용 도형. 물리 바디와 Area2D 는 이게 없으면 아무것도 못 한다.
Control UI 의 기본 단위. 점이 아니라 사각형(위치 + 크기)을 가진다.
GPUParticles2D 입자를 뿌린다. 계산을 GPU 가 한다.
GridContainer 자식을 격자로 배치한다. columns 로 열 수를 정한다.
HBoxContainer 자식을 가로로 나열한다.
Label 글자를 표시한다.
Light2D 2D 조명. 주변을 밝히거나 그림자를 만든다.
Line2D 점을 이어 선을 그린다.
MarginContainer 자식 주위에 여백을 준다.
Marker2D 기능은 Node2D 와 같고, 에디터에서 십자 아이콘이 크게 보인다.
MultiplayerSpawner 서버가 만든 노드를 클라이언트에도 자동으로 만들어 준다.
MultiplayerSynchronizer 지정한 속성을 자동으로 네트워크에 실어 보낸다.
Node 모든 노드의 뿌리. 기능 한 조각을 담는 가장 기본 단위다.
Node2D 위치·회전·크기를 가진 2D 노드. 화면에 놓이는 거의 모든 것의 부모다.
PanelContainer 배경 패널을 그리고 그 안에 여백을 두어 자식을 담는다.
Polygon2D 점을 찍어 만든 다각형을 색이나 텍스처로 채운다.
ProgressBar 0~100 사이 값을 막대로 보여준다.
RayCast2D 이 점에서 저 방향으로 선을 그어, 처음 만나는 것을 알려준다.
RigidBody2D 던져 놓으면 물리 엔진이 알아서 굴려주는 물체.
ShapeCast2D 선이 아니라 도형을 그 방향으로 밀어보며 검사한다.
Sprite2D 이미지 한 장을 그린다. 그게 전부다.
StaticBody2D 움직이지 않고 밀리지도 않는 벽. 남이 부딪히는 대상.
TileMapLayer 격자 칸에 타일 번호를 찍어 지형을 만든다. 한 노드가 한 레이어를 담당한다.
Timer 시간을 재고 끝나면 timeout 시그널을 쏜다.
VBoxContainer 자식을 세로로 쌓는다.
Viewport 화면이 그려지는 영역. 크기·입력 처리의 기준이 된다.

리소스 9개

AtlasTexture 큰 이미지(아틀라스)의 한 영역만 가리키는 텍스처.
CapsuleShape2D 알약 모양 충돌 도형. 횡스크롤 캐릭터의 기본값.
CircleShape2D 원형 충돌 도형. 모서리가 없어 벽을 따라 부드럽게 미끄러진다.
PackedScene 노드 트리를 통째로 담은 씬 파일. instantiate() 로 찍어낸다.
RectangleShape2D 사각형 충돌 도형. 가장 흔하고 가장 빠르다.
Resource 데이터를 담는 파일. 텍스처·사운드·씬이 모두 Resource 이고, 직접 만들 수도 있다.
SpriteFrames AnimatedSprite2D 가 쓰는, 이름 붙은 애니메이션 묶음.
TileSet 타일 목록·물리 레이어·터레인 규칙을 담은 리소스.
TileSetAtlasSource 이미지 한 장을 일정 크기로 잘라 타일을 공급한다.

콜백 6개

_draw 노드의 로컬 좌표 기준으로 직접 그린다.
_input 모든 입력을 가장 먼저 받는다. UI 보다도 앞이다.
_physics_process 고정된 주기(기본 초당 60회)로 불린다. delta 가 항상 같다.
_process 프레임을 그릴 때마다 불린다. 빈도는 기기 성능과 주사율에 따라 변한다.
_ready 노드가 씬 트리에 들어와 자식까지 준비된 뒤 딱 한 번 불린다.
_unhandled_input UI 가 먹지 않은 입력만 여기로 온다. 게임플레이 입력의 제자리.

메서드 5개

instantiate PackedScene 을 실제 노드로 찍어낸다.
is_on_floor 바닥에 서 있는지 알려준다. move_and_slide() 다음에 불러야 값이 갱신된다.
move_and_collide 주어진 거리만큼 움직이고, 뭔가에 닿으면 그 자리에서 멈춘 뒤 충돌 정보를 돌려준다.
move_and_slide velocity 방향으로 움직이되, 벽에 부딪히면 멈추지 않고 벽을 따라 미끄러진다.
queue_free "이번 프레임이 끝나면 지워라". 즉시 지우지 않는다.

속성 8개

collision_layer "나는 누구인가". 내가 어떤 부류에 속하는지 선언한다.
collision_mask "나는 누구를 보는가". 내가 감지하고 부딪힐 부류를 고른다.
global_position 화면 세계 전체를 기준으로 한 절대 위치.
motion_mode CharacterBody2D 의 이동 알고리즘을 고른다. 옵션이 아니라 갈림길이다.
position 부모를 기준으로 한 상대 위치.
up_direction CharacterBody2D 가 "위쪽"으로 삼는 방향. 기본 (0, -1).
velocity CharacterBody2D 의 속도. 단위는 초당 픽셀이다.
z_index 그리기 순서를 강제로 올리거나 내린다. 클수록 앞에 온다.

시그널 2개

area_entered Area2D 에 다른 Area2D 가 들어왔을 때 발생한다.
body_entered Area2D 에 물리 바디가 들어왔을 때 발생한다.

문법 5개

@export 변수를 에디터 인스펙터에 노출한다. 개발자가 아닌 사람에게 손잡이를 넘기는 문법.
@onready _ready 시점에 변수를 채운다. 자식 노드를 잡을 때 쓴다.
class_name 스크립트를 새로운 타입으로 등록한다.
preload 컴파일 시점에 리소스를 읽는다. 경로가 고정일 때 쓴다.
signal "이런 일이 일어났다"를 방송한다. 내보내는 쪽은 누가 듣는지 모른다.

개념 4개

delta 직전 프레임 이후 실제로 흐른 시간(초).
ENetMultiplayerPeer UDP 위에 "이건 꼭 보내줘 / 이건 잃어도 돼"를 골라 쓸 수 있게 얹은 게임용 연결.
SceneTree 지금 떠 있는 노드 전체를 담고 있는 나무. get_tree() 로 접근한다.
Tween 어떤 값을 A에서 B로 시간에 걸쳐 바꾸는 도구. 코드로 만든다.