# TileEffectType 상세 설명

<mark style="color:purple;">`Map.putTileEffect`</mark> 함수에서 사용되는 **타일 효과(TileEffectType)**&#xC758; 사용 방법을 안내하는 페이지입니다. 타일 효과에 대한 자세한 설명은 아래 링크를 참고해주세요.

:fire: [<mark style="color:purple;">**타일 효과**</mark>](https://docs-kr.zep.us/creator/editor/undefined-1)

## 📗 기본 타일 효과

### TileEffectType.NONE

NONE 타입의 타일 효과 입니다.

**예시**

```jsx
//해당 좌표에 있는 타일 효과를 지웁니다.
Map.putTileEffect(x, y, TileEffectType.NONE);
```

###

### **TileEffectType.IMPASSABLE**

이동불가(IMPASSABLE) 타일 효과 입니다

**예시**

```jsx
//해당 좌표에 이동불가(IMPASSABLE) 타일 효과를 설치합니다.
Map.putTileEffect(x, y, TileEffectType.IMPASSABLE);
```

###

### **TileEffectType.SPAWN**

플레이어가 맵에 진입 할 때 진입 지점을 설정하는 타일 효과 입니다

**예시**

```jsx
//해당 좌표에 스폰(SPAWN) 타일 효과를 설치합니다.
Map.putTileEffect(x, y, TileEffectType.SPAWN);
```

## 🌀 포털 관련 타일 효과

### TileEffectType.PORTAL

**스페이스 내 다른 맵으로 이동** 또는 **맵 내 지정 영역**으로 이동 하는 타일 효과 입니다.

**파라미터**

<table><thead><tr><th width="167.33333333333331">이름</th><th width="118">타입</th><th>설명</th></tr></thead><tbody><tr><td>type</td><td>Number</td><td>type이 0 인 경우<br>스페이스 내 다른맵으로 이동하는 포털 타일을 설치합니다.<br>type이 1 인 경우<br>맵 내 지정 영역으로 이동하는 포털 타일을 설치합니다.</td></tr><tr><td>targetMapID</td><td>String</td><td>이동할 맵의 MapID 값</td></tr><tr><td>label</td><td>String</td><td>포털 위에 표시할 텍스트 값</td></tr><tr><td>triggerByTouch</td><td>Boolean</td><td>true인 경우: 닿았을 때 실행<br>false인 경우: F를 눌러 실행</td></tr><tr><td>invisible</td><td>Boolean</td><td>true인 경우: 기본 포털 이미지를 숨김<br>false인 경우: 기본 포털 이미지가 보임</td></tr><tr><td>locationName</td><td>String</td><td>이동할 로케이션의 이름 값 ( type이 1인 경우 필수 입력 )</td></tr></tbody></table>

**예시**

```jsx
// type: 0 인 경우
// 스페이스 내 다른맵으로 이동하는 포털 타일을 설치합니다.
Map.putTileEffect(x, y, TileEffectType.PORTAL, {
	type: 0, // 필수
	locationName: "TEST",  // 선택
	targetMapID: "gyV1N2", // 필수
	label: "PORTAL-TYPE0", // 선택
  triggerByTouch: true // 선택, 기본값 false
});

// type: 1 인 경우
// 맵 내 지정 영역으로 이동하는 포털 타일을 설치합니다.
Map.putTileEffect(x, y, TileEffectType.PORTAL, {
	type: 1, // 필수
	label: "PORTAL-TYPE1",  // 선택
	locationName: "TEST", // 필수
	invisible: true, // 선택, 기본 포털이미지 숨기기
	triggerByTouch: true  // 선택, 기본값 false
});
```

###

### TileEffectType.SPACE\_PORTAL

외부 스페이스로 이동하는 타일 효과 입니다.

**파라미터**

<table><thead><tr><th width="173.33333333333331">이름</th><th width="114">타입</th><th>설명</th></tr></thead><tbody><tr><td>label</td><td>String</td><td>포털 위에 표시할 텍스트 값</td></tr><tr><td>targetMapID</td><td>String</td><td>이동할 외부 스페이스 ID값<br>* https://zep.us/play/[스페이스 ID]</td></tr><tr><td> locationName</td><td>String</td><td>이동할 로케이션의 이름 값</td></tr><tr><td>triggerByTouch</td><td>Boolean</td><td>true인 경우: 닿았을 때 실행 <br>false인 경우: F를 눌러 실행</td></tr><tr><td>invisible</td><td>Boolean</td><td>true인 경우: 기본 포털 이미지를 숨김 <br>false인 경우: 기본 포털 이미지가 보임</td></tr></tbody></table>

**예시**

```jsx
// 외부 스페이스로 이동하는 포털 타일을 설치합니다.
Map.putTileEffect(x, y, TileEffectType.SPACE_PORTAL, {
	label: "SPACE_PORTAL",  // 선택
	targetMapID: "zydmYD", //필수
	locationName: "SPACE1",  // 선택
	invisible: true,  // 선택, 기본값 false
	triggerByTouch: true,  // 선택, 기본값 false
});
```

## 🌐 임베드 관련 타일 효과

### TileEffectType.EMBED

팝업으로 웹 링크를 여는 타일 효과입니다.

**파라미터**

<table><thead><tr><th width="165.33333333333331">이름</th><th width="98">타입</th><th>설명</th></tr></thead><tbody><tr><td>link</td><td>String</td><td>웹 URL 값</td></tr><tr><td>align2</td><td>String</td><td>팝업을 표시할 위치<br>’popup’, ‘sidebar’, ‘top’, ‘topleft’, ‘topright’, ‘middle’, ‘middleleft’, ‘middleright’, ‘bottom’, ‘bottomleft’, ‘bottomright’</td></tr><tr><td>label</td><td>String</td><td>포털 위에 표시할 텍스트 값</td></tr><tr><td>triggerByTouch</td><td>Boolean</td><td>true인 경우: 닿았을 때 실행<br>false인 경우: F를 눌러 실행</td></tr><tr><td>invisible</td><td>Boolean</td><td>true인 경우: 기본 포털 이미지를 숨김<br>false인 경우: 기본 포털 이미지가 보임</td></tr></tbody></table>

**예시**

```jsx
// 팝업으로 웹 링크를 여는 타일 효과를 설치합니다.
Map.putTileEffect(x, y, TileEffectType.EMBED, {
	link: "https://zep.us/", // 필수
	align2: "top", // 필수
	label: "ZEP-SCRIPT-EMBED",  // 선택
});
```

###

### TileEffectType.WEB\_PORTAL

새 탭으로 웹 링크를 여는 타일 효과입니다.

**파라미터**

<table><thead><tr><th width="158.33333333333331">이름</th><th width="108">타입</th><th>설명</th></tr></thead><tbody><tr><td>link</td><td>String</td><td>웹 URL 값</td></tr><tr><td>label</td><td>String</td><td>포털 위에 표시할 텍스트 값</td></tr><tr><td>invisible</td><td>Boolean</td><td>true인 경우: 기본 포털 이미지를 숨김<br>false인 경우: 기본 포털 이미지가 보임</td></tr></tbody></table>

**예시**

```jsx
// 새탭으로 웹 링크를 여는 타일 효과를 설치합니다.
Map.putTileEffect(x, y, TileEffectType.WEB_PORTAL, {
	link: "https://zep.us/", // 필수
	label: "ZEP-SCRIPT-WEB-PORTAL", // 선택
	invisible: true, // 선택, 기본값 false
});
```

###

### TileEffectType.TILE\_EMBED

웹 화면을 고정 영역에 표시하는 타일 효과입니다.

**파라미터**

<table><thead><tr><th width="144.33333333333331">이름</th><th width="132">타입</th><th>설명</th></tr></thead><tbody><tr><td>link</td><td>String</td><td>웹 URL 값</td></tr><tr><td>width</td><td>number</td><td>고정 영역의 너비 ( 타일 수 )</td></tr><tr><td>height</td><td>number</td><td>고정 영역의 높이 ( 타일 수 )</td></tr></tbody></table>

**예시**

```jsx
// 웹 화면을 고정 영역에 설치합니다.
Map.putTileEffect(x, y, TileEffectType.TILE_EMBED, {
	link: "https://zep.us/", // 필수
	width: 5, // 필수
	height: 5, // 필수
});
```

## 💠 유틸 타일 효과

### TileEffectType.PRIVATE\_AREA

프라이빗 영역 타일 효과 입니다.

**파라미터**

<table><thead><tr><th width="147.33333333333331">이름</th><th width="109">타입</th><th>설명</th></tr></thead><tbody><tr><td>id</td><td>Number</td><td>프라이빗 영역의 ID 값</td></tr><tr><td>impassable</td><td>Boolean</td><td>true일 경우 프라이빗 영역을 impassable(통과 불과)로 만듭니다</td></tr><tr><td>param1</td><td>String</td><td>param1 이 “true” 일 경우 인원제한 프라이빗 영역이 설정됩니다.</td></tr></tbody></table>

**예시**

```jsx
// 해당 좌표에 프라이빗 영역을 설치합니다.
Map.putTileEffect(18, 15, TileEffectType.PRIVATE_AREA, {
		id: 3, // 필수
		impassable: false,  // 선택, 기본 값 false
		param1: "true",   // 선택, 기본 값 "false"
	});
```

###

### TileEffectType.LOCATION

지정영역 타일 효과 입니다.

**파라미터**

<table><thead><tr><th width="138.33333333333331">이름</th><th width="126">타입</th><th>설명</th></tr></thead><tbody><tr><td>label</td><td>String</td><td>타일 위에 표시할 텍스트 값</td></tr><tr><td>name</td><td>String</td><td>지정 영역의 이름</td></tr><tr><td>width</td><td>number</td><td>고정 영역의 너비 ( 타일 수 )</td></tr><tr><td>height</td><td>number</td><td>고정 영역의 높이 ( 타일 수 )</td></tr></tbody></table>

**예시**

```jsx
// 해당 좌표에 지정 영역을 설치합니다.
Map.putTileEffect(x, y, TileEffectType.LOCATION, {
	label: "LOCATION",  // 선택
	name: "zep-script-location", // 필수
	width: 3, // 필수
	height: 2, // 필수
});
```

###

### TileEffectType.AMBIENT\_SOUND

배경 음악 타일 효과 입니다.

**파라미터**

<table><thead><tr><th width="169.33333333333331">이름</th><th width="122">타입</th><th>설명</th></tr></thead><tbody><tr><td>link</td><td>String</td><td>재생할 음악 파일의 이름 ( 압축 파일에 포함 )</td></tr><tr><td>activeDistance</td><td>Number</td><td>음악의 재생 범위 ( 타일 )</td></tr><tr><td>triggerByTouch</td><td>Boolean</td><td>true인 경우: 닿았을 때 실행<br>false인 경우: F를 눌러 실행</td></tr></tbody></table>

**예시**

```jsx
Map.putTileEffect(x, y, TileEffectType.AMBIENT_SOUND, {
	link: "ring.mp3", // 필수
	activeDistance: 1, // 필수
	triggerByTouch: false, // 선택
});
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-kr.zep.us/creator/reference/tileeffecttype.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.