Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

타일맵 사용하기

이 페이지에서는 귀하가 이미 TileSet을 생성하거나 다운로드했다고 가정합니다. 그렇지 않은 경우 TileMap을 생성하려면 TileSet이 필요하므로 먼저 :ref:`doc_using_tilesets`를 읽어보세요.

소개

타일맵은 게임 레이아웃을 만드는 데 사용되는 타일 그리드입니다. TileMapLayer 노드를 사용하여 레벨을 디자인하면 여러 가지 이점이 있습니다. 첫째, 타일을 그리드에 "페인팅"하여 레이아웃을 그릴 수 있습니다. 이는 개별 Sprite2D 노드를 하나씩 배치하는 것보다 훨씬 빠릅니다. 둘째, 많은 수의 타일을 그리는 데 최적화되어 있기 때문에 훨씬 더 큰 레벨을 허용합니다. 마지막으로 타일에 충돌, 폐색 및 탐색 모양을 추가하여 TileMap에 더 많은 기능을 추가할 수 있습니다.

노드에서 시그널 연결하기

:ref:`doc_using_tilesets`의 이전 페이지를 따랐다면 TileMapLayer 노드에 내장된 TileSet 리소스가 있어야 합니다. 이는 프로토타입 제작에는 좋지만 실제 프로젝트에서는 일반적으로 동일한 타일 세트를 재사용하는 여러 레벨이 있습니다.

여러 TileMapLayer 노드에서 동일한 TileSet을 재사용하는 권장 방법은 TileSet을 외부 리소스에 저장하는 것입니다. 이렇게 하려면 TileSet 리소스 옆에 있는 드롭다운을 클릭하고 **저장**을 선택합니다.

여러 TileMapLayer와 설정

타일맵 작업 시 일반적으로 적절한 경우 여러 TileMapLayer 노드를 사용하는 것이 좋습니다. 여러 레이어를 사용하면 유리할 수 있습니다. 예를 들어 전경 타일과 배경 타일을 구별하여 더 나은 구성을 제공할 수 있습니다. 주어진 위치에 레이어당 하나의 타일을 배치할 수 있으며, 이를 통해 레이어가 두 개 이상인 경우 여러 타일을 함께 겹칠 수 있습니다.

각 TileMapLayer 노드에는 조정할 수 있는 여러 속성이 있습니다.

활성화됨: ``true``인 경우 편집기와 프로젝트 실행 시 레이어가 표시됩니다.
TileSet TileMapLayer 노드에서 사용되는 타일 세트입니다.

렌더링

Y 정렬 원점: 각 타일의 Y 정렬에 사용할 수직 오프셋(픽셀 단위)입니다. CanvasItem 설정에서 **Y 정렬 활성화**가 ``true``인 경우에만 유효합니다.
X 그리기 순서 역순 타일이 X축에 그려지는 순서를 반대로 바꿉니다. CanvasItem 설정에서 **Y 정렬 활성화**가 ``true``여야 합니다.
렌더링 사분면 크기 사분면은 최적화 목적으로 단일 CanvasItem에 함께 그려진 타일 그룹입니다. 이 설정은 지도 좌표계에서 정사각형 변의 길이를 정의합니다. 이 경우 타일은 Y 위치로 그룹화되므로 사분면 크기는 Y로 정렬된 TileMapLayer에 적용되지 않습니다.

물리

충돌 활성화 충돌을 활성화하거나 비활성화합니다.
운동학적 몸체 사용 실제 TileMapLayer 충돌 모양이 운동학적 몸체로 인스턴스화될 때.
충돌 가시성 모드 TileMapLayer의 충돌 모양이 표시되는지 여부입니다. 기본값으로 설정하면 충돌 디버그 표시 설정에 따라 달라집니다.

내비게이션

탐색 활성화됨 탐색 영역 활성화 여부입니다.
Navigation Visible TileMapLayer의 탐색 메시가 표시되는지 여부입니다. 기본값으로 설정하면 탐색 표시 디버그 설정에 따라 달라집니다.

팁

TileMap 내장 탐색에는 길 찾기 성능과 경로 따르기 품질이 떨어지는 많은 실질적인 제한 사항이 있습니다.

TileMap을 디자인한 후 NavigationRegion2D 또는 :ref:`NavigationServer2D <class_NavigationServer2D>`을 사용하여 이를 보다 최적화된 탐색 메시로 베이킹하고 TileMap NavigationLayer를 비활성화하는 것을 고려하십시오. 자세한 내용은 :ref:`doc_navigation_using_navigationmeshes`를 참조하세요.

경고

2D 내비게이션 메시는 "계층화"되거나 시각적 또는 물리적 모양처럼 서로 쌓일 수 없습니다. 동일한 내비게이션 지도에 내비게이션 메시를 스택하려고 하면 경로 찾기를 중단시키는 병합 및 논리적 오류가 발생합니다.

렌더링

씬 탭에서 해당 노드를 끌어서 놓아 레이어 순서를 변경할 수 있습니다. TileMap 편집기의 오른쪽 상단에 있는 버튼을 사용하여 작업 중인 TileMapLayer 노드 간에 전환할 수도 있습니다.

참고

나중에 기존 타일에 영향을 주지 않고 레이어를 생성하거나 이름을 바꾸거나 순서를 변경할 수 있습니다. 하지만 레이어를 *제거*하면 해당 레이어에 배치된 타일도 모두 제거되므로 주의하세요.

타일맵 편집기 열기

TileMapLayer 노드를 선택하고 나서 편집기의 하단에서 타일맵 패널을 엽니다:

편집기의 하단에서 타일맵 패널이 열립니다. TileMapLayer 노드가 먼저 선택되어야 합니다.

페인팅에 사용할 타일 선택

먼저, 위에서 추가 레이어를 만든 경우 칠할 레이어를 선택했는지 확인하세요.

팁

2D 편집기에서 현재 동일한 TileMapLayer 노드에서 편집하고 있지 않은 레이어는 TileMap 편집기에 있는 동안 회색으로 표시됩니다. 레이어 선택 메뉴 옆에 있는 아이콘을 클릭하면 이 동작을 비활성화할 수 있습니다(선택한 타일맵 레이어 강조 표시 툴팁).

TileMap 편집기에 들어갈 때 첫 번째 레이어가 자동으로 선택되므로 추가 레이어를 생성하지 않은 경우 위 단계를 건너뛸 수 있습니다.

2D 편집기에서 타일을 배치하려면 먼저 편집기 하단에 있는 타일맵 패널에서 타일을 하나 이상 선택해야 합니다. 이렇게 하려면 TileMap 패널에서 타일을 클릭하거나 마우스 버튼을 누른 채 여러 타일을 선택합니다.

팁

2D 및 TileSet 편집기에서와 마찬가지로 마우스 가운데 또는 오른쪽 버튼을 사용하여 TileMap 패널을 이동하고 왼쪽 상단 모서리에 있는 마우스 휠 또는 버튼을 사용하여 확대/축소할 수 있습니다.

:kbd:`Shift`을 길게 눌러 현재 선택 항목에 추가할 수도 있습니다. 하나 이상의 타일을 선택하면 페인팅 작업을 수행할 때마다 여러 타일이 배치됩니다. 이는 한 번의 클릭으로 여러 타일로 구성된 구조물(예: 대형 플랫폼 또는 나무)을 그리는 데 사용할 수 있습니다.

최종 선택은 연속적일 필요는 없습니다. 선택한 타일 사이에 빈 공간이 있으면 2D 편집기에서 그려질 패턴에서 빈 공간으로 남게 됩니다.

TileSet에 대체 타일을 생성한 경우 기본 타일 오른쪽에 페인팅하기 위해 해당 타일을 선택할 수 있습니다.

마지막으로 TileSet에 *장면 컬렉션*을 만든 경우 TileMap에 씬 타일을 배치할 수 있습니다.

인스턴스 편집하기

TileMap 편집기 상단에 있는 도구 모음을 사용하면 여러 페인팅 모드와 도구 중에서 선택할 수 있습니다. 이러한 모드는 TileMap 패널 자체가 아님 2D 편집기를 클릭할 때의 작동에 영향을 미칩니다.

왼쪽에서 오른쪽으로 선택할 수 있는 페인팅 모드와 도구는 다음과 같습니다.

반사

단일 타일을 클릭하여 타일을 선택하거나, 2D 편집기에서 마우스 왼쪽 버튼을 누른 채 직사각형으로 여러 개를 선택하여 타일을 선택합니다. 빈 공간은 선택할 수 없습니다. 직사각형 선택을 생성하면 비어 있지 않은 타일만 선택됩니다.

현재 선택 항목에 추가하려면 :kbd:`Shift`을 누른 다음 타일을 선택하세요. 현재 선택에서 제거하려면 :kbd:`Ctrl`을 누른 다음 타일을 선택하세요.

그런 다음 선택 항목을 다른 페인팅 모드에서 사용하여 이미 배치된 패턴의 복사본을 빠르게 만들 수 있습니다.

:kbd:`Del`을 눌러 TileMap에서 선택한 타일을 제거할 수 있습니다.

그림판 모드에서 :kbd:`Ctrl`을 누른 다음 선택을 수행하면 이 모드를 일시적으로 전환할 수 있습니다.

팁

You can copy and paste tiles that were already placed by performing a selection, pressing Ctrl + C then pressing Ctrl + V. The selection will be pasted after left-clicking. You can press Ctrl + V another time to perform more pastes this way. Right-click or press Escape to cancel pasting.

칠하기

표준 페인트 모드에서는 마우스 왼쪽 버튼을 클릭하거나 길게 눌러 타일을 배치할 수 있습니다.

마우스 오른쪽 버튼을 클릭하면 현재 선택된 타일이 타일맵에서 삭제됩니다. 즉, 빈 공간으로 대체됩니다.

TileMap에서 여러 타일을 선택하거나 선택 도구를 사용하여 선택한 경우 마우스 왼쪽 버튼을 누른 채 마우스를 클릭하거나 드래그할 때마다 해당 타일이 배치됩니다.

팁

페인트 모드에 있는 동안 마우스 왼쪽 버튼을 누르기 전에 :kbd:`Shift`를 누른 다음 마우스를 선의 끝점으로 드래그하여 선을 그릴 수 있습니다. 이는 아래 설명된 선 도구를 사용하는 것과 동일합니다.

마우스 왼쪽 버튼을 누르기 전에 Ctrl 및 :kbd:`Shift`을 누른 다음 마우스를 직사각형의 끝점으로 드래그하여 직사각형을 그릴 수도 있습니다. 이는 아래 설명된 직사각형 도구를 사용하는 것과 동일합니다.

마지막으로 :kbd:`Ctrl`을 누른 다음 타일을 클릭(또는 마우스를 누른 상태로 드래그)하여 2D 편집기에서 기존 타일을 선택할 수 있습니다. 그러면 현재 칠해진 타일이 방금 클릭한 타일로 전환됩니다. 이는 아래 설명된 Picker 도구를 사용하는 것과 동일합니다.

라인

선 그리기 모드를 선택한 후 방향에 관계없이 항상 타일 1개 두께의 선을 그릴 수 있습니다.

선 그리기 모드에서 마우스 오른쪽 버튼을 클릭하면 선이 지워집니다.

TileMap에서 여러 타일을 선택했거나 선택 도구를 사용하여 타일을 선을 따라 반복되는 패턴으로 배치할 수 있습니다.

페인트 또는 지우개 모드에 있는 동안 :kbd:`Shift`을 누른 후 그리기를 통해 이 모드를 일시적으로 전환할 수 있습니다.

두 개의 타일을 선택한 후 선 도구를 사용하여 플랫폼을 대각선으로 그립니다.

직사각형

직사각형 페인트 모드를 선택한 후 축 정렬 직사각형을 그릴 수 있습니다.

직사각형 페인트 모드에서 마우스 오른쪽 버튼을 클릭하면 축 정렬된 직사각형이 지워집니다.

TileMap에서 여러 타일을 선택했거나 선택 도구를 사용하여 타일을 직사각형 내에서 반복 패턴으로 배치할 수 있습니다.

그림판 또는 지우개 모드에 있는 동안 Ctrl 및 :kbd:`Shift`을 누른 후 그리기를 통해 이 모드를 일시적으로 전환할 수 있습니다.

버킷 채우기

버킷 채우기 모드를 선택한 후 도구 모음 오른쪽에 나타나는 연속 확인란을 전환하여 페인팅을 연속 영역으로 제한할지 여부를 선택할 수 있습니다.

**연속**(기본값)을 활성화하면 현재 선택 항목에 닿는 일치하는 타일만 교체됩니다. 이 연속 검사는 수평 및 수직으로 수행되지만 대각선으로는 수행되지 않습니다.

**연속**을 비활성화하면 전체 TileMap에서 동일한 ID를 가진 모든 타일이 현재 선택된 타일로 대체됩니다. **연속**을 선택 취소한 상태에서 빈 타일을 선택하면 TileMap의 유효 영역을 둘러싸는 직사각형의 모든 타일이 대신 교체됩니다.

버킷 채우기 모드에서 마우스 오른쪽 버튼을 클릭하면 일치하는 타일이 빈 타일로 대체됩니다.

TileMap에서 여러 타일을 선택했거나 선택 도구를 사용하여 타일을 채워진 영역 내에서 반복 패턴으로 배치할 수 있습니다.

색깔

선택기 모드를 선택한 후 :kbd:`Ctrl`을 누른 다음 타일을 클릭하면 2D 편집기에서 기존 타일을 선택할 수 있습니다. 그러면 현재 칠해진 타일이 방금 클릭한 타일로 전환됩니다. 마우스 왼쪽 버튼을 누른 채 직사각형 선택을 형성하여 한 번에 여러 타일을 선택할 수도 있습니다. 비어 있지 않은 타일만 선택할 수 있습니다.

그림판 모드에서 :kbd:`Ctrl`을 누른 다음 마우스를 클릭하거나 드래그하여 이 모드를 일시적으로 전환할 수 있습니다.

지우개

이 모드는 다른 페인팅 모드(페인트, 선, 직사각형, 버킷 채우기)와 결합됩니다. 지우개 모드가 활성화되면 왼쪽 클릭 시 새 선을 그리는 대신 타일이 빈 타일로 대체됩니다.

다른 모드에 있는 동안 왼쪽 버튼을 클릭하는 대신 오른쪽 버튼을 클릭하면 이 모드를 일시적으로 전환할 수 있습니다.

프로젝트 생성하기

페인팅하는 동안 선택적으로 *무작위화*를 활성화할 수 있습니다. 활성화하면 페인팅할 때 현재 선택된 모든 타일 중에서 무작위 타일이 선택됩니다. 이는 페인트, 선, 직사각형 및 버킷 채우기 도구에서 지원됩니다. 효과적인 페인트 무작위화를 위해서는 TileMap 편집기에서 여러 타일을 선택하거나 분산을 사용해야 합니다(두 접근 방식을 결합할 수 있음).

**분산**을 0보다 큰 값으로 설정하면 페인팅할 때 타일이 배치되지 않을 가능성이 있습니다. 이는 넓은 영역에 가끔씩 반복되지 않는 세부 정보를 추가하는 데 사용할 수 있습니다(예: 대형 하향식 TileMap에 잔디 또는 부스러기 추가).

페인트 모드를 사용하는 경우의 예:

여러 번 선택하여 무작위로 선택한 다음 마우스 왼쪽 버튼을 누른 채 페인팅합니다.

버킷 채우기 모드를 사용하는 경우의 예:

단일 타일에 버킷 채우기 도구를 사용하지만 무작위화 및 산란이 활성화되어 있음

참고

지우개 모드는 무작위화 및 산란을 고려하지 않습니다. 선택 항목 내의 모든 타일은 항상 제거됩니다.

패턴을 사용하여 미리 만들어진 타일 배치 저장 및 로드

선택 모드에서 타일을 복사하여 붙여넣을 수 있지만 미리 만들어진 타일 패턴*을 저장하여 한 번에 함께 배치할 수 있습니다. TileMap 편집기의 **Patterns* 탭을 선택하여 TileMap별로 이 작업을 수행할 수 있습니다.

새 패턴을 만들려면 선택 모드로 전환하고 선택을 수행한 다음 :kbd:`Ctrl + C`을 누르세요. 패턴 탭 내의 빈 공간을 클릭한 다음(빈 공간 주위에 파란색 초점 직사각형이 나타나야 함) :kbd:`Ctrl + V`를 누릅니다.

기존 패턴을 사용하려면 패턴 탭에서 해당 이미지를 클릭하고 페인팅 모드로 전환한 다음 2D 편집기의 아무 곳이나 마우스 왼쪽 버튼으로 클릭하세요.

다중 타일 선택과 마찬가지로 선, 직사각형 또는 버킷 채우기 페인팅 모드와 함께 사용하면 패턴이 반복됩니다.

참고

TileMap 편집기에서 편집되었음에도 불구하고 패턴은 TileSet 리소스에 저장됩니다. 이를 통해 외부 파일에 저장된 TileSet 리소스를 로드한 후 다른 TileMapLayer 노드에서 패턴을 재사용할 수 있습니다.

지형을 사용하여 자동으로 타일 연결 처리

지형을 사용하려면 TileMapLayer 노드에 하나 이상의 지형 세트와 이 지형 세트 내의 지형이 있어야 합니다. TileSet에 대한 지형 세트를 아직 생성하지 않은 경우 :ref:`doc_using_tilesets_creating_terrain_sets`를 참조하세요.

이렇게 하고 싶어하는 몇 가지 이유가 있습니다:

연결, 여기서 타일은 동일한 TileMapLayer의 주변 타일에 연결됩니다.
경로, 타일이 동일한 스트로크로 칠해진 타일에 연결됩니다(마우스 버튼을 놓을 때까지).
충돌을 해결하거나 지형 시스템에서 다루지 않는 상황을 처리하기 위한 타일별 재정의입니다.

연결 모드는 사용하기 더 쉽지만 Path는 페인팅 중에 더 많은 아티스트 제어를 허용하므로 더 유연합니다. 예를 들어 Path를 사용하면 도로가 서로 연결되지 않고 서로 직접 인접할 수 있는 반면, 연결는 두 도로를 강제로 연결합니다.

마지막으로 특정 상황에서 충돌을 해결하기 위해 지형에서 특정 타일을 선택할 수 있습니다.

비트 중 하나 이상이 해당 지형 ID로 설정된 값으로 설정된 타일은 선택할 타일 목록에 표시됩니다.

시그널 다루기

TileMap에서 참조되는 TileSet에서 타일을 제거하면 TileMap은 잘못된 타일 ID가 배치되었음을 나타내는 자리 표시자를 표시합니다.

TileSet 참조가 손상되어 TileMap 편집기에서 타일이 누락되었습니다.

이러한 자리 표시자는 실행 중인 프로젝트에 표시되지 않지만 타일 데이터는 여전히 디스크에 유지됩니다. 이를 통해 해당 장면을 안전하게 닫았다가 다시 열 수 있습니다. 일치하는 ID로 타일을 다시 추가하면 타일이 새 타일의 모양으로 나타납니다.

참고

TileMapLayer 노드를 선택하고 TileMap 편집기를 열 때까지 누락된 타일 자리 표시자가 표시되지 않을 수 있습니다.