# 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, // 선택
});
```