Triggers

Les Triggers permettent d'ajouter d'écouter des évènements spécifiques sur un rôle.

Exemple:

Il existe de nombreux Trigger. Chacun est une interface qu'un rôle doit implémenter. Ainsi, pour qu'un rôle écoute l’évènement: début de la nuit. Il faut que le rôle implémente l'interface: Trigger_onNightTime.

public class TestRole extends Role implements Trigger_onNightTime{
    public TestRole(UUID owner) {
        super(owner);
    }

    @Override
    public void onNightTime(Player player) {
                
    }
}

Ici la méthode onNightTime sera appelée à chaque début de nuit.

Table des Triggers

Trigger	Arguments	Usage et appel
Trigger_OnAnyKill	Player player Player killer	Cette méthode est appelée à chaque kill. player est le joueur tué, et killer le tueur.
Trigger_OnConsume	Player player PlayerItemConsumeEvent e	Cette méthode est appelée lorsque le joueur possédant le rôle consomme un objet: nourriture, potion etc.. player est le joueur qui possède le rôle. e est l'événement correspondant à la consommation.
Trigger_OnDayTime	Player player	Cette méthode est appelée lors du début du jour. player est le joueur possédant le rôle.
Trigger_onEpisodeTime	Player player	Cette méthode est appelée lors de la fin d'un épisode. player est le joueur possédant le rôle.
Trigger_onFightBegin	Fight fight	Cette méthode est appelée au début d'un combat avec un autre joueur. fight est l'objet représentant le combat qui vient d'être engager. Voir ici pour plus d'information.
Trigger_OnFightEnd	Fight fight	Cette méthode est appelée au début d'un combat avec un autre joueur. fight est l'objet représentant le combat qui vient d'être engager. Voir ici pour plus d'information.
Trigger_OnHitPlayer	Player player Player damaged double amount DamageCause cause	Cette méthode est appelée quand le joueur possédant le rôle met un coup à un autre joueur. player est le joueur possédant le rôle. damaged est le joueur frappé. amount est la quantité de dégât infligé. cause est la cause du dégât. Cette méthode possède une valeur de retour ! C'est un booléen: Si vrai: annule le coup. Sinon le coup est infligé.
Trigger_OnInteractWithUUIDItem	final Player player int uuidtag PlayerInteractEvent e	Cette méthode est appelée lorsque le joueur interagit avec un objet ayant un NBT spécifique. Cet NBT est un entier disponible via la classe NbtTagHandler avec les méthodes: createItemStackWithUUIDTag, getUUIDTAG et hasUUIDTAG. player est le joueur possédant le rôle. uuidtag est la valeur du NBT. e est l’événement d’interaction.
Trigger_OnKill	Player player Player killed	Cette méthode est appelée lorsque le joueur fait un kill. player est le joueur possédant le rôle. killed est le joueur tué.
Trigger_onNightTime	Player player	Cette méthode est appelée au début de la nuit. player est le joueur possédant le rôle.
Trigger_OnOwnerDeath	Player player Player damager	Cette méthode est appelée lorsque le joueur possédant le rôle meurt. Ici damager peut être null. player est le joueur possédant le rôle. damager est le tueur. Cette méthode possède une valeur de retour ! C'est un booléen: Si vrai: effectue un revive du joueur: vie au maximum et téléportation aléatoire sur la carte. Sinon le joueur meurt comme prévu.
Trigger_OnRoletime	Player player	Cette méthode est appelée juste après l'attribution et l'annonce des rôles. player est le joueur possédant le rôle.
Trigger_OnScoreBoardUpdate	final Player player SimpleScoreboard scoreboard Scoreboard sc	Cette méthode est appelée lorsque que le Scoreboard du joueur est mis à jour. C'est à dire tout les 5ticks player est le joueur possédant le rôle. scoreboard est une représentation du Scoreboard sous la forme utilisée par l'API. (Peu d'utilités, peut être ignorée) sc est le scoreboard du joueur.
Trigger_OnTakingHit	Player player EntityDamageEvent e	Cette méthode est appelée lorsque le joueur prend un coup. player est le joueur possédant le rôle. e est l’événement de prise de dégât.
Trigger_WhileAnyTime	Player player	Cette méthode est appelée toute les secondes. player est le joueur possédant le rôle.
Trigger_WhileDay	Player player	Cette méthode est appelée toute les secondes seulement pendant le jour. player est le joueur possédant le rôle.
Trigger_WhileNight	Player player	Cette méthode est appelée toute les secondes seulement pendant la nuit. player est le joueur possédant le rôle.