🌀TileEffectType 상세 설명

Map.putTileEffect 함수에서 사용되는 타일 효과(TileEffectType)의 사용 방법을 안내하는 페이지입니다. 타일 효과에 대한 자세한 설명은 아래 링크를 참고해주세요.

🔥 타일 효과

📗 기본 타일 효과

TileEffectType.NONE

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

예시

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

TileEffectType.IMPASSABLE

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

예시

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

TileEffectType.SPAWN

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

예시

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

🌀 포털 관련 타일 효과

TileEffectType.PORTAL

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

파라미터

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

예시

// 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

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

파라미터

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

예시

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

🌐 임베드 관련 타일 효과

TileEffectType.EMBED

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

파라미터

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

예시

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

TileEffectType.WEB_PORTAL

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

파라미터

이름	타입	설명
link	String	웹 URL 값
label	String	포털 위에 표시할 텍스트 값
invisible	Boolean	true인 경우: 기본 포털 이미지를 숨김 false인 경우: 기본 포털 이미지가 보임

예시

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

TileEffectType.TILE_EMBED

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

파라미터

이름	타입	설명
link	String	웹 URL 값
width	number	고정 영역의 너비 ( 타일 수 )
height	number	고정 영역의 높이 ( 타일 수 )

예시

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

💠 유틸 타일 효과

TileEffectType.PRIVATE_AREA

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

파라미터

이름	타입	설명
id	Number	프라이빗 영역의 ID 값
impassable	Boolean	true일 경우 프라이빗 영역을 impassable(통과 불과)로 만듭니다
param1	String	param1 이 “true” 일 경우 인원제한 프라이빗 영역이 설정됩니다.

예시

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

TileEffectType.LOCATION

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

파라미터

이름	타입	설명
label	String	타일 위에 표시할 텍스트 값
name	String	지정 영역의 이름
width	number	고정 영역의 너비 ( 타일 수 )
height	number	고정 영역의 높이 ( 타일 수 )

예시

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

TileEffectType.AMBIENT_SOUND

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

파라미터

이름	타입	설명
link	String	재생할 음악 파일의 이름 ( 압축 파일에 포함 )
activeDistance	Number	음악의 재생 범위 ( 타일 )
triggerByTouch	Boolean	true인 경우: 닿았을 때 실행 false인 경우: F를 눌러 실행

예시

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