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

  상위 문서: Skript/스크립트 작성 도움말

1. 개요[편집]

---

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

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

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

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

2. 이벤트값[편집]

---

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

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

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

3. 이벤트[편집]

---

3.1. At %time%[편집]

---

• 이벤트값: event-world

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

예제:
12:00:
broadcast "%event-world%의 시간이 12시가 되었습니다."

at 7am in "world":
message "해가 떴습니다."

3.2. On Bed Enter[편집]

---

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

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

예제:
bed enter:
message "좋은 밤 되세요."

3.3. On Bed Leave[편집]

---

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

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

예제:
bed leave:
message "좋은 아침!"

3.4. On Block Damage[편집]

---

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

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

예제:

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

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

예제:
growth of wheat:
message "%event-location%에서 밀이 자랐습니다." to console

3.6. On Book Edit[편집]

---

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

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

예제:
book edit:
message "책을 썼습니다."

3.7. On Book Sign[편집]

---

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

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

예제:
book sign:
broadcast "%event-player%님이 책 <%name of event-item%>을 출판하셨습니다."

3.8. On Break / Mine[편집]

---

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

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

예제:
block break:
if player is not op:
message "당신은 블럭을 파괴할 권한이 없습니다."
cancel event

on mine of any ore:
message "광산에서 %event-block%를 채굴하였습니다."

3.9. On Bucket Empty[편집]

---

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

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

예제:
bucket empty:
if event-player is not op:
message "%event-player%님이 %location of event-block%에 양동이를 비웠습니다." to console

3.10. On Bucket Fill[편집]

---

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

예제:
bucket fill:
send "이 서버에서 양동이를 채울 수 없습니다."
cancel event

3.11. On Burn[편집]

---

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

예제:
burn:
send "이 서버에서는 불로 블록을 타게해 사라지게 할 수 없습니다."
cancel event

3.12. On Can Build Check[편집]

---

3.13. On Chat[편집]

---

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

예제:
chat:
if {mute.%player%} is set:
send "&c뮤트 상태입니다. 남은 시간 : %{mute.%player%}%초
cancel event

3.14. On Chunk Generate[편집]

---

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

3.15. On Chunk Load[편집]

---

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

예제:
chunk load:
message "%event-chunk%가 로딩되었습니다." to all ops

3.16. On Chunk Unload[편집]

---

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

예제:
chunk unload:
message "%event-chunk%가 언로딩되었습니다." to all ops

3.17. On Click[편집]

---

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

예제:
right click holding ender pearl:
message "엔더 진주를 던졌습니다."

3.18. On Combust[편집]

---

3.19. On Command[편집]

---

커맨드를 실행시켰을 때 호출된다. || [on] command [%text%] ||
command "/stop":
if command sender is not console:
send "&c콘솔에서만 실행시킬 수 있습니다."
cancel event

3.20. On Connect[편집]

---

접속 중일 때 호출된다. On Join 이랑 비슷하지만, On Join은 서버에 들어왔을 때, On Connect 는 서버와 연결 중일 때 호출된다. || [on] [player] connect[ing] ||
connect:
if {ban.%player%} is set:
kick player due to "&4밴 상태 입니다. 서버에 접속이 불가능합니다."

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:
broadcast "&b&l%player%님이 다이아몬드 갑옷을 완성하였습니다."

3.23. On Creeper Power[편집]

---

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[편집]

---

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[편집]

---

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[편집]

---

Called when a dispenser dispenses an item.

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

3.27. On Drop[편집]

---

Called when a player drops an item from his inventory.

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

3.28. On Enderman/Sheep[편집]

---

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

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

3.29. On Experience Spawn[편집]

---

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[편집]

---

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

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

3.31. On Explosion Prime[편집]

---

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[편집]

---

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

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

examples:
on fade of snow or ice

3.33. On First Join[편집]

---

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

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

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

3.34. On Fishing[편집]

---

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

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

3.35. On Flow[편집]

---

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[편집]

---

examples:
on form of snow
on form of a mushroom

3.37. On Fuel Burn[편집]

---

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

3.38. On Gamemode Change[편집]

---

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

3.39. On Grow[편집]

---

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 place:
 broadcast "%player%님이 블록을 설치 했습니다"

3.41. On Kick[편집]

---

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

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

[각주]