Skript/스크립트 작성 도움말/Event


{{{#!wiki style="margin: -0px -10px -5px; min-height:calc(1.5em + 5px)" {{{#!folding [ 펼치기 · 접기 ] {{{#!wiki style="margin: -5px -1px -11px; word-break:keep-all"	<colbgcolor=darkgreen><colcolor=#fff> 기본 플레이
시스템	세계 (시드) · 게임 모드 · 난이도 · 게임 규칙 · 엔딩 · 죽음 메시지 · 스플래시 · 명령어 · NBT · 런처
인게임	아이템 · 몹 (플레이어) · 개체 · 날씨 · 차원 · 생물군계 · 구조물 · 마법 부여 · 상태 효과 · 조작법 · 피해 · 업적
도움말	튜토리얼 · 팁 (탐험 · 파밍 · 회로) · 재생 가능한 자원 · 브릿징 · PVP · 파쿠르 · 스피드런 · 건축 (맵아트)
시리즈 및 매체
출시 에디션	자바 에디션 (업데이트 · 거리 효과) · 베드락 에디션 (업데이트) · 포켓 에디션^* · 콘솔 에디션^* · 파이 에디션^*
파생 게임	마인크래프트 던전스^* · 마인크래프트 레전드^* · 마인크래프트 에듀케이션 · 마인크래프트: 스토리 모드^* · 마인크래프트 어스^*
미디어	OST · 관련 서적 · 레고 · 영화 · 애니메이션 · Minecraft Live · Minecraft Now · Minecraft Monthly
유저 콘텐츠
창작 요소	2차 창작 · 망토 · 맵 · 모드 (개발 · 팁 · 모드팩) · 애드온 · 팩 (리소스 팩 · 데이터 팩) · 외부 프로그램 · 핵
멀티 콘텐츠	멀티플레이 · 서버 · 플러그인 · Realms · EULA
개발	개발 기초 · 모드 개발 · 플러그인 개발
기타
이야깃거리	여담 · 커뮤니티 · 사건 사고 · 문제점 · 용어 · 지원 언어 · 머나먼 땅 · 이미테이션 게임 · 히로빈
관련 문서	나무위키 마인크래프트 프로젝트 · 마인크래프트로 분류된 문서 · 마인크래프트의 하위 문서
* 표시는 서비스가 종료되었거나 개발이 중단되었다는 표시이다.		}}}}}}}}}

1. 개요2. 이벤트값3. 이벤트

3.1. At %time%3.2. On Bed Enter3.3. On Bed Leave3.4. On Block Damage3.5. On Block Growth3.6. On Book Edit3.7. On Book Sign3.8. On Break / Mine3.9. On Bucket Empty3.10. On Bucket Fill3.11. On Burn3.12. On Can Build Check3.13. On Chat3.14. On Chunk Generate3.15. On Chunk Load3.16. On Chunk Unload3.17. On Click3.18. On Combust3.19. On Command3.20. On Connect3.21. On Consume3.22. On Craft3.23. On Creeper Power3.24. On Damage3.25. On Death3.26. On Dispense3.27. On Drop3.28. On Enderman/Sheep3.29. On Experience Spawn3.30. On Explode3.31. On Explosion Prime3.32. On Fade3.33. On First Join3.34. On Fishing3.35. On Flow3.36. On Form3.37. On Fuel Burn3.38. On Gamemode Change3.39. On Grow3.40. On Place3.41. On Kick

1. 개요

마인크래프트 Skript 작성 문법의 Event를 설명하는 문서이다.

Event(이하 이벤트)는 어떠한 사건이 발생하였는지 감지하고 특정 코드를 실행시키는 역할을 한다.

이벤트 정보 및 예제는 Skript Hub에서 참고하였다.

@은 [Tab]키를 의미한다.

2. 이벤트값

이벤트에는 event-value(이하 이벤트값)이 있는데, 예를 들어 블럭을 부쉈을 때 "OO가 OO을 부쉈다"라는 메시지를 보내려면 이벤트가 발생할 때마다 달라지기 때문에 이벤트값이 필요하다.

각 이벤트에는 가지고 있는 이벤트값이 모두 다르다. 예를들어 서버 접속(On join) 이벤트의 경우에는 이벤트에 관여한 월드와 플레이어는 있지만 블럭, 아이템 등과는 관련이 없기 때문에 해당 이벤트값도 없다.

이벤트값의 대표적인 목록:

event-player	해당 이벤트를 일으킨 플레이어
event-world	해당 이벤트가 일어난 월드
event-block	해당 이벤트를 일으킨 블럭
event-item	해당 이벤트를 일으킨 아이템
event-location	해당 이벤트가 일어난 좌표
event-entity	해당 이벤트를 일으킨 엔티티(몬스터 등)
event-inventory	해당 이벤트를 일으킨 인벤토리

3. 이벤트

3.1. At %time%

이벤트값: event-world

at %time% [in %worlds%]

특정 마인크래프트 월드의 시간이 되었을 때 호출된다.

예제:
12:00:

3.2. On Bed Enter

이벤트값: event-world, evnet-player, event-block

[on] bed enter[ing]

[on] [player] enter[ing] [a] bed

플레이어가 침대에 누웠을 때 호출된다.

예제:
bed enter:

3.3. On Bed Leave

이벤트값: event-world, evnet-player, event-block

[on] bed leav[e|ing]

[on] [player] leav[e|ing] [a] bed

플레이어가 침대에서 일어났을 때 호출된다.

예제:
bed leave:

3.4. On Block Damage

이벤트값: event-world, event-player, event-block, event-location

[on] bed leav[e|ing]

[on] [player] leav[e|ing] [a] bed

플레이어가 블럭을 부수기 시작했을 때 호출된다.

예제:

on block damage:
	if event-block is a bedrock:
		broadcast "%event-player%님이 기반암을 부수려하고 있습니다."

3.5. On Block Growth

이벤트값: event-world, event-block, event-location, past event-block

[on] (plant|crop|block) grow[(th|ing)] [[of] %itemtypes%]

곡물이 자랐을 때 호출된다.

예제:
growth of wheat:

3.6. On Book Edit

이벤트값: event-world, event-item, event-player

[on] book (edit|change|write)

플레이어가 책을 수정했을 때 호출된다.

예제:
book edit:

3.7. On Book Sign

이벤트값: event-world, event-item, event-player

[on] book sign[ing]

플레이어가 책에 이름을 적고 완성하였을 때 호출된다.

예제:
book sign:

3.8. On Break / Mine

이벤트값: past event-block, event-world, event-location, event-entity, event-block, event-player, event-entity, future event-block

[on] [block] (break[ing]|min(e|ing)) [[of] %itemtypes%]

플레이어가 블럭을 파괴했을 때 호출된다. on mine을 사용할 경우 아이템을 드랍하는(광석 등) 블럭을 파괴했을 때만 호출된다. 맨손으로 돌을 부순 경우처럼 드랍된 아이템이 없으면 on break에서는 반응하지만 on mine에서는 그렇지 않다.

예제:
block break:

3.9. On Bucket Empty

이벤트값: event-world, event-block, event-player, past event-block

[on] bucket empty[ing]

[on] [player] empty[ing] [a] bucket

플레이어가 양동이를 비웠을 때 호출된다.

예제:
bucket empty:

3.10. On Bucket Fill

[on] bucket fill[ing]

[on] [player] fill[ing] [a] bucket

플레이어가 양동이를 채울 때 호출된다.

예제:
bucket fill:

3.11. On Burn

[on] [block] burn[ing] [[of] %아이템 종류%]

블럭이 불에 타 사라질 때 호출된다.

예제:
burn:

3.12. On Can Build Check

[on] [block] can build check

3.13. On Chat

[on] chat

플레이어가 채팅을 입력할 때 호출된다.

예제:
chat:

3.14. On Chunk Generate

[on] chunk generat(e 또는 ing)

[on] chunk populat(e 또는 ing)

청크가 생성될 때 호출된다.

3.15. On Chunk Load

[on] chunk load[ing]

청크가 로딩될 때 호출된다.

예제:
chunk load:

3.16. On Chunk Unload

[on] chunk unload[ing]

청크가 언로딩될 때 호출된다.

예제:
chunk unload:

3.17. On Click

플레이어가 마우스를 클릭할 때 호출된다.

예제:
right click holding ender pearl:

3.18. On Combust

[on] combust[ing]

3.19. On Command

커맨드를 실행시켰을 때 호출된다. || [on] command [%text%] || command "/stop": ||

3.20. On Connect

접속 중일 때 호출된다. On Join 이랑 비슷하지만, On Join은 서버에 들어왔을 때, On Connect 는 서버와 연결 중일 때 호출된다. || [on] [player] connect[ing] || connect: ||

3.21. On Consume

음식이나 포션을 먹거나 마셨을 때 호출된다. || [on] [player] ((eat|drink)[ing] | consum(e 또는 ing) [[of] %아이템 종류%] || ||

3.22. On Craft

조합대에서 조합을 했을 경우 호출된다. || [on] [player] craft[ing] [[of] %아이템 종류%] || craft of diamond chestplate: ||

3.23. On Creeper Power

견본		[on] creeper power
지원 버전		1.0 이후

Called when a creeper is struck by lighting and gets powered. Cancel the event to prevent the creeper from being powered.
See also: on lightning strike

크리퍼가 번개에 맞았을 때 실행합니다. 강화크리퍼가 만들어지는 이벤트를 취소합니다.
참고 사항 : 낙뢰가 떨어질 때

3.24. On Damage

견본		[on] damag(e\|ing) [of %entity type%]
지원 버전		1.0 이후
placeholder	attacker, victim, projectile

Called when an entity receives damage, e.g. by an attack from another entity, lava, fire, drowning, fall, suffocation, etc.

엔티티가 데미지를 입었을 때 호출합니다. (예: 용암, 화재, 익사, 낙하, 질식 등)

예제:
on damage
on damage of a player
on damage: ///데미지를 입었을 때
	set action bar of victim to "&c-%(damage * 2)% 피해" /// %victim%의 엑션바에 피해량을 표시합니다

3.25. On Death

견본		[on] death [of %entity types%]
지원 버전		1.0 이후

Called when a living entity (including players) dies.

살아있는 개체(플레이어 포함)가 사망했을 때 호출합니다.

examples:
on death
on death of player ///살아있는 플레이어가 사망했을 때
on death of a wither or ender dragon: ///위더 or 엔더드레곤이 사망했을 때
	broadcast "A %entity% has been slain in %world%!" ///%엔티티%가 %world% 에서 사망했습니다! 를 방송합니다.

3.26. On Dispense

견본		[on] dispens(e\|ing) [[of] %item types%]
지원 버전		unknown

Called when a dispenser dispenses an item.

디스펜서가 작동될 때 호출합니다.

3.27. On Drop

견본		[on] [player] drop[ing] [[of] %item types%]
지원 버전		unknown

Called when a player drops an item from his inventory.

플레이어가 아이템을 떨어뜨릴 때 호출합니다.

3.28. On Enderman/Sheep

견본		[on] enderman place , [on] enderman pickup , [on] sheep eat
지원 버전		unknown

Called when an enderman places or picks up a block, or a sheep eats grass respectively.

엔더맨이 블럭을 집거나 내려놓을 때 또는 양이 풀을 먹을 때 호출합니다.

3.29. On Experience Spawn

견본		[on] [e]xp[erience] [orb] spawn , [on] spawn of [a[n]] [e]xp[erience] [orb]
지원 버전		2.0

Called whenever experience is about to spawn. This is a helper event for easily being able to stop xp from spawning, as all you can currently do is cancel the event.
Please note that it's impossible to detect xp orbs spawned by plugins (including Skript) with Bukkit, thus make sure that you have no such plugins if you don't want any xp orbs to spawn. (Many plugins that only change the experience dropped by blocks or entities will be detected without problems though)

examples:
on xp spawn:
	world is "minigame_world"
	cancel event

3.30. On Explode

견본		[on] explo(d(e\|ing)\|sion)
지원 버전		1.0

Called when an entity (a primed TNT or a creeper) explodes.

엔티티가 (TNT 또는 크리퍼) 폭발할 때 호출합니다.

3.31. On Explosion Prime

견본		[on] explosion prime
지원 버전		1.0

Called when an explosive is primed, i.e. an entity will explode shortly. Creepers can abort the explosion if the player gets too far away, while TNT will explode for sure after a short time.

폭발물이 터지려 할 때(즉 폭발물이 곧 터질 때) 호출합니다. 플레이어가 멀어지면 크리퍼는 폭발을 멈출 수 있고 TNT는 얼마 안 가 터질 겁니다.

3.32. On Fade

견본		[on] [block] fad(e\|ing) [[of] %item types%]
지원 버전		1.0

Called when a block 'fades away', e.g. ice or snow melts.

아이템이 '사라질 때' (예를 들면 얼음이나 눈이 녹을 때)

examples:
on fade of snow or ice

3.33. On First Join

견본		[on] first (join\|login)
지원 버전		1.3.7

Called when a player joins the server for the first time.

플레이어가 서버에 처음 입장/로그인할 때 호출합니다.
예시:

on First Join:
@set join message to player "%player%님이 서버에 처음 접속 하셨습니다!!"

3.34. On Fishing

견본		[on] [player] fish[ing]
지원 버전		1.0

Called when a player fishes something. This is not of much use yet.

플레이어가 낚시를 할 때 호출합니다. 이 기능은 아직 많이 사용하지 않습니다.

3.35. On Flow

견본		[on] [block] flow[ing] [on] block mov(e\|ing)
지원 버전		1.0

Called when a blocks flows or teleports to another block. This not only applies to water and lava, but teleporting dragon eggs as well.

블럭이 이동하거나 텔레포트 될 때 호출합니다. 이것은 물과 용암에도 적용될 뿐만 아니라 드레곤 알이 순간이동 될 때도 적용됩니다.

3.36. On Form

견본		[on] [block] form[ing] [[of] %item types%]
지원 버전		1.0

Called when a block is created, but not by a player, e.g. snow forms due to snowfall, water freezes in cold biomes, or a block spreads (see spread event).

블럭이 생성될 때 호출합니다. 하지만 플레이어가 아닌 경우, 예를 들면 강설로 인한 눈, 차가운 바이옴에서 어는 물, 블럭 스프레드 ( 스프레드 이벤트 참조 ) 는 아닙니다.

examples:
on form of snow
on form of a mushroom

3.37. On Fuel Burn

견본		[on] fuel burn[ing]
지원 버전		1.0

Called when a furnace burns an item from its fuel slot.

연료슬롯에서 연료를 소모하고 있을 때 호출합니다.

3.38. On Gamemode Change

견본		[on] game[ ]mode change [to %gamemode%]
지원 버전		1.0

Called when a player's gamemode changes.

플레이어의 게임모드가 바뀔 때 호출합니다.

examples:
on gamemode change ///게임모드가 바뀔 때
on gamemode change to adventure ///게임모드가 어드벤처로 바뀔 때

3.39. On Grow

견본		[on] grow [of %tree type%]
지원 버전		1.0

Called when a tree or giant mushroom grows to full size.

나무 또는 거대버섯이 다 자랐을 때 호출합니다.

examples:
on grow
on grow of a tree
on grow of a huge jungle tree

3.40. On Place

견본		[on] [block] (plac(e\|ing)\|build[ing]) [[of] %itemtypes%]
지원 버전		1.0

블록이 설치 되었을때 호출합니다.
예시:

on place:
	broadcast "%player%님이 블록을 설치 했습니다"

3.41. On Kick

견본		[on] [player] (kick\|being kicked)
지원 버전		1.0

플레이어가 추방 당했을때 호출합니다.
예시:

On Kick:
	broadcast "%player%님이 추방당했습니다."