AVS Key-Skript

Skript addon that fires events when a player opens Advancements or receives Statistics. Perfect for auto-opening GUIs, running commands, or any QoL automation tied to those screens.

Features

• on advancement open: — fires when the client sends ADVANCEMENT_TAB.
  
  
• on statistics open: — fires when the server sends STATISTICS.
  
  
• Optional debug: true in config.yml for clear console logs.
  
  
• Designed for Paper 1.21.4; stable PacketEvents-based implementation.

Requirements

• Paper 1.21.4 (Java 17+)
  
  
• Skript 2.9.x
  
  
• PacketEvents 2.9.5+
  

Install

1. Drop YSkriptPackets-2.x.x.jar, Skript, and PacketEvents into plugins/.
   
   
2. Start the server.
   
   
3. (Optional) Set debug: true in plugins/YSkriptPackets/config.yml.
   

Quick Example (Skript)

on statistics open:
broadcast "&aStats opened by %player%"

on advancement open:
wait 1 tick
# Opening an inventory closes the Advancements screen
make player execute command "/config"

Notes

• Events are notifications (non-cancellable), fired on the main thread.
  
  
• Opening any inventory/GUI will “close” the Advancements screen on the client—use the 1-tick delay for smooth UX.
  

Changelog (latest)

• 2.0.2 – Events marked synchronous (fixes Paper IllegalStateException).
  
  
• 2.0.1 – Corrected PacketEvents Maven coords/repos.
  
  
• 2.0.0 – Initial stable release (PacketEvents).