-
Notifications
You must be signed in to change notification settings - Fork 1
AQLPlaces
This page is currently in french, it will soon be translated
Le plugin AQLPlaces permet de créer des zones et d'un associer des événements.
Pour ce faire le plugin repose sur deux concepts principaux : les places et les triggers.
Les "places" sont des zones (dans un monde spécifique).
Il existe plusieurs type de places détaillés ci-après.
Chaque place est identifiée par un nom unique (sans espaces).
La liste des places est consultable via la commande /place list
Vous pouvez consulter les informations sur une place via la commande /place info <nom_place>
Pour supprimer une place et tout ses triggers : /place remove <nom_place>
Attention cette action est irreversible !
Type: radius
Les places sphériques sont définies par un point central et un rayon d'action.
Création: /place add <nom> radius <rayon>
Type: cube / Indisponible pour l'instant
Les places cubiques sont définies par deux points opposés du cube.
Création: /place add <nom> cube <x1> <y1> <z1> <x2> <y2> <z2>
Sans trigger une place est inutile. C'est pourquoi on lui ajoute des action, ou triggers. Il existe plusieurs type de triggers qui s'activent a différents moments et agissent de différentes manières.
Les places peuvent contenir plusieurs triggers, chaque trigger est associé a une seule place et est identifié par un nom unique pour cette place (le nom peut être réutilisé sur un autre place).
Vous pouvez consulter la liste des triggers sur une place avec la commande /placetrg list <nom_place>
Vous pouvez également activer et désactiver un trigger a tout moment avec la commande /placetrg enable <nom_place> <nom_trigger>
Remplacez enable par disable pour désactiver.
Vous pouvez voir les infos sur un trigger via la commande /placetrg info <nom_place> <nom_trigger>
Pour supprimer définitivement un trigger d'une place : /placetrg remove <nom_place> <nom_trigger>
Vous pouvez aussi activer manuellement un trigger : /placetrg trigger <nom_place> <nom_trigger>
Le trigger command permet de lancer une commande à chaque joueur entrant dans la place.
Création: /placetrg add <nom_place> <nom_trigger> command <commande>
Au contraire exit_command est exécuté dès qu'un joueur sort de la zone.
Création: /placetrg add <nom_place> <nom_trigger> exit_command <commande>
Le type command_cyclic est une commande executée en boucle tant que des joueurs sont dans la zone.
Le délai entre deux exécution de la commande est réglable et peut être rendu aléatoire.
Création: /placetrg add <nom_place> <nom_trigger> command_cyclic <interval> <variation_max> <discrimine> <commande>
L'interval est la durée entre deux execution.
La variation max est le nombre de secondes maximum à ajouter ou enlever de l'interval. Exemple: intervale de 5 avec une variation max de 2, je peux obtenir des valeurs entre 3 et 7 secondes.
Discrimine doit être un 1 ou un 0, si c'est un 1 alors la commande est executée sur tout les joueurs à chaque fois, sinon seulement sur un joueur tiré au hasard.
Dans tous ces triggers vous pouvez utiliser n'importe quelle commande, ces commandes peuvent contenir les patterns suivants pour les rendre dynamiques.
-
{Player}le nom du joueur -
{PlayerWorld}le monde dans lequel le joueur se trouve -
{PlayerPosX}la position du joueur en X -
{PlayerPosY}la position du joueur en Y -
{PlayerPosZ}la position du joueur en Z
Ces patterns (bouts de textes) seront remplacés automatiquement par la valeur adéquate.
Ce trigger permet d'envoyer des informations sur une zone d'évent lorsqu'un staff entre dans la zone.
Les informations envoyées sont le nom de l'évent, une URL vers une page de description de l'animation et un texte libre pour décrire l'animation.
Création: /placetrg add <nom_place> <nom_trigger> event_info <nom_event> <url> <description ...>
Ce trigger est destiné à informer les joueurs qu'ils entrent dans une zone.
Il va afficher un titre avec le nom de l'endroit pendant une durée choisie.
Pour l'instant le nom ne peut pas contenir d'espaces.
Création: /placetrg add <nom_place> <nom_trigger> localisation <titre> <type> <durée> <description>
La durée est exprimée en secondes, le type n'a pas d'impact pour l'instant et la description n'est pas affichée.