Listening to events

You may listen to any Bukkit-based event (including events added by other plugins) by referencing the imported class. For example, if you wanted to listen to org.bukkit.event.entity.EnderDragonChangePhaseEvent:

import:
  org.bukkit.event.entity.EnderDragonChangePhaseEvent
​
on EnderDragonChangePhaseEvent:
  # your code

You may also listen to multiple events with the same handler. The events do not have to be related, but you should take appropriate precautions if you try to access methods that are available in one event but not in the other. For example, if you want to listen to both org.bukkit.event.entity.ProjectileLaunchEvent and org.bukkit.event.entity.ProjectileHitEvent​

import:
  org.bukkit.event.entity.ProjectileLaunchEvent
  org.bukkit.event.entity.ProjectileHitEvent  
​
on ProjectileLaunchEvent and ProjectileHitEvent:
  # your code

Using the event expression

skript-mirror exposes an event expression, allowing you to access event values using reflection.

[the] event

Setting a priority level

The priority level of an event may be set to control when a particular event handler is run relative to other event handlers.

import:
  org.bukkit.event.entity.EnderDragonChangePhaseEvent
  
on EnderDragonChangePhaseEvent with priority highest:
  # your code

Any event priorities defined in org.bukkit.event.EventPriority may be used. Lower priority event handlers are run before higher priority event handlers.

lowest
low
normal
high
highest
monitor

Handling cancelled events

By default, event handlers will not be called if an event is cancelled by a lower priority handler. This behavior can be changed by specifying that the handler should handle all events.

import:
  org.bukkit.event.block.BlockBreakEvent
​
on all BlockBreakEvent:
  uncancel event