skript-mirror offers robust event support for scripts that need to:

• listen to events that aren't supported by Skript
• listen to multiple (even unrelated) events under the same event handler
• listen to events with a specific priority level

Listening to custom events
You can listen to any Bukkit event (even events added by other plugins) using the event's fully qualified name. For example, if you want to listen to org.bukkit.event.entity.EnderDragonChangePhaseEvent

Code (Skript):

1. on "org.bukkit.event.entity.EnderDragonChangePhaseEvent":
2.   # your code

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

Code (Skript):

1. on script load:
2.   import "org.bukkit.entity.EnderDragon$Phase"
3.  
4. on "org.bukkit.event.entity.EnderDragonChangePhaseEvent":
5.   if event.getNewPhase() is {Phase}.CIRCLING!:
6.     event.setNewPhase({Phase}.CHARGE_PLAYER!);

Listening to multiple events with the same handler
You can 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 available in one event but not the other. For example, if you want to listen to both org.bukkit.event.entity.ProjectileLaunchEvent and org.bukkit.event.entity.ProjectileHitEvent

Code (Skript):

1. on "org.bukkit.event.entity.ProjectileLaunchEvent" and "org.bukkit.event.entity.ProjectileHitEvent":
2.   # your code

Setting a priority level
You can specify a specific event priority to manually set which order your event handlers run. This allows you to coordinate when your event handlers run with respect to other plugins and other scripts.

Code (Skript):

1. on "org.bukkit.event.entity.EnderDragonChangePhaseEvent" with priority lowest:
2.   # your code
3.  
4. on "org.bukkit.event.entity.EnderDragonChangePhaseEvent" with priority low:
5.   # your code
6.  
7. on "org.bukkit.event.entity.EnderDragonChangePhaseEvent" with priority normal:
8.   # your code
9.  
10. on "org.bukkit.event.entity.EnderDragonChangePhaseEvent" with priority high:
11.   # your code
12.  
13. on "org.bukkit.event.entity.EnderDragonChangePhaseEvent" with priority highest:
14.   # your code
15.  
16. on "org.bukkit.event.entity.EnderDragonChangePhaseEvent" with priority monitor:
17.   # your code

 

Adding more examples wouldn't really have any benefits. The existing examples already cover the entirety of the feature. Even if I added more examples, they wouldn't showcase anything that would the documentation clearer.