Comment on page
🌀

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