Aller au contenu

Les évènements

Évènements

Un évènement est un bloc d'actions qui sera exécuté lorsque cet évènement sera appelé (ou "déclenché"). Plusieurs évènement sont pris en charge nativement par Sqript, comme par exemple l'évènement on script load. Pour déclencher des actions lorsqu'un évènement a lieu, il faut créer un nouveau bloc dont l'entête contiendra le nom de l'évènement, suivi de deux points : . Par exemple, cet évènement affiche "Hello world !" lorsque le script est chargé:

on script load:
    print "Hello world !"

Chaque évènement, lorsqu'il est déclenché, permet l'accès à des variables qui lui sont propres. Ces variables peuvent être obtenues par des accesseurs. Par exemple, l'évènement on script load permet d'accéder à l'instance du fichier du script chargé, via l'accesseur [script] file. Un évènement peut n'avoir aucun accesseurs.

Enfin, lorsqu'un évènement est annulable, il est possible de le définir comme tel grâce à l'action cancel event.

Liste des évènements

On world tick
Description: Declenché lorsqu'un tick est réalisé dans le monde
Pattern: world tick
Accesseur(s): BOTH
Exemple(s): 
on world tick:
On player attack
Cancelable
Description: Déclenché lorsqu'un joueur attaque un autre joueur.
Pattern: player (hit|attacked)
Accesseur(s): BOTH
Exemple(s): 
on player attacked:
    cancel event #Enlève le pvp
On block placed
Cancelable
Description: Déclenché lorsqu'un bloc est placé par un joueur.
Pattern: [block] place [of {block}]
Accesseur(s): BOTH
Exemple(s): 
on place of minecraft:stone:
    cancel event #Empêche la pose des blocs de stone
On player used an item
Description: Déclenché lorsqu'un objet est sur le point d'être utilisé.
Pattern: (player use[s] item|item use)
Accesseur(s): BOTH
Exemple(s): 
on item use:
    if item is minecraft:potion:
    cancel event
On render of health bar
Cancelable
Client
Description: Déclenché lorsque la barre de vie est sur le point d'être dessinée à l'écran.
Pattern: render [of] health bar
Accesseur(s): CLIENT
Exemple(s): 
on render of health bar:
    cancel event #Cache la barre de vie du joueur
On block broken
Cancelable
Description: Déclenché lorsqu'un bloc est cassé par un joueur.
Pattern: [block] break [of {block}]
Accesseur(s): BOTH
Exemple(s): 
on break:
    cancel event #Empêche les joueurs de casser les blocs
On player jump
Cancelable
Description: Déclenché lorsqu'un joueur saute
Pattern: player (jump|jumped)
Accesseur(s): BOTH
Exemple(s): 
on player jump:
On render of nameplates
Cancelable
Description: Déclenché lorsque les étiquettes affichant le nom des joueurs sont sur le point d'être dessinées. L'accesseur player désigne le joueur dont le nom est dessiné à l'écran.
Pattern: render [of] player['s] nameplates
Accesseur(s): BOTH
Exemple(s): 
on render of player's namemplates
On render of chat
Cancelable
Client
Description: Déclenché lorsque le tchat est sur le point d'être dessiné. L'accesseur player désigne le joueur client.
Pattern: render [of] chat
Accesseur(s): CLIENT
Exemple(s): 
on render of chat:
On player login
Cancelable
Description: Déclenché lorsqu'un joueur est sur le point de se connecter.
Pattern: player (login|connection)
Accesseur(s): BOTH
Exemple(s): 
on player connection:
On render of crosshair
Client
Description: Déclenché lorsque le réticule est sur le point d'être dessiné à l'écran.
Pattern: render [of] crosshair[s] bar
Accesseur(s): CLIENT
Exemple(s):
On render of overlay
Client
Description: Déclenché lorsque l'overlay principal est sur le point d'être dessiné. Permet d'afficher des éléments à l'écran grâce aux actions de dessin.
Pattern: render [of] overlay
Accesseur(s): CLIENT
Exemple(s): 
on render overlay:
    draw textured rectangle at [-15,-7.5] with size [30,15] using texture sample:logo.png
On item pickup
Cancelable
Description: Déclenché lorsqu'un joueur ramasse un item par terre.
Pattern: (player pickup[s] item|item pickup)
Accesseur(s): BOTH
Exemple(s): 
on item pickup:
    if item is minecraft:bedrock:
        cancel event
On item right clicked
Cancelable
Description: Déclenché lorsqu'un joueur effectue un clic droit sur un item.
Pattern: [item] click [with {item}] [with (left|right) hand]
Accesseur(s): BOTH
Exemple(s): 
on item click with minecraft:emerald:
On window setup
Description: Déclenché lorsque la fenêtre est sur le point d'être inititalisée. Permet de modifier le nom de la fenêtre et son icône.
Pattern: window setup
Accesseur(s): BOTH
Exemple(s): 
on window setup:
    set window title to "Sqript !"
On script load
Description: Déclenché lorsque le script est chargé ou rechargé.
Pattern: [script] load[ed]
Accesseur(s): BOTH
Exemple(s): 
on script load:
On render of food bar
Cancelable
Client
Description: Déclenché lorsque la barre de faim est sur le point d'être dessinée à l'écran.
Pattern: render [of] food [bar]
Accesseur(s): CLIENT
Exemple(s): 
on render of hunger
On block right clicked
Cancelable
Description: Déclenché lorsqu'un joueur effectue un clic sur un bloc.
Pattern: on (left|right) click on (block [of {block}]|{block}) [with (left|right) hand]
Accesseur(s): BOTH
Exemple(s): 
on right click on minecraft:diamond_block:
On render of experience bar
Client
Description: Déclenché lorsque la barre d'expérience est sur le point d'être affichée à l'écran.
Pattern: render [of] (xp|experience) bar
Accesseur(s): CLIENT
Exemple(s): 
on render of xp bar:
On player movement
Cancelable
Description: Déclenché lorsqu'un joueur se déplace.
Pattern: player move[ment]
Accesseur(s): BOTH
Exemple(s): 
on player movement:
    cancel event #Immobilise le joueur
On message sent
Cancelable
Description: Déclenché à l'envoi d'un message sur le tchat par un joueur. L'accesseur message peut être défini pour modifier le contenu du message envoyé.
Pattern: ([player] sen(d[ing]|t) [a] message|message sent)
Accesseur(s): BOTH
Exemple(s): 
on message sent:
    set message to "My message" #Modifie le contenu du message