manuel scenarioStudio

cycle de vie des jeux
notes de version
updated : 06/02/25

les déclencheurs

Les interactions sont déclenchées par les actions du joueur associées à des objets cibles, éventuellement complété par un objet secondaire (dans le cas d'une combinaison d'objets) et d'un lieu donné. Il existe huit déclencheurs.

Déclencheurs basés sur les lieux/scènes

▸ Entrer dans un lieu. L'interaction est déclenchée chaque fois que le joueur entre dans le lieu.

▸ Sortir d'un lieu. L'interaction est déclenchée chaque fois que le joueur sort du lieu. Celle-ci se limite aux effets qu'elle contient et prend le pas sur le mécanisme standard des passages : de fait elle ne va pas déplacer le joueur vers sa destination, à moins de contenir un effet ChangerLieu. Si un objet a été stipulé comme passage, l'interaction ne se déclenche que si je joueur emprunte ce passage pour sortir.

▸ Examiner un lieu. L'interaction est déclenchée chaque fois que le joueur clique sur le décor de fond. À défaut d'interaction de ce type, le nom et la description du lieu s'affichent dans le bandeau du haut.

▸ Zoomer / dézoomer dans un lieu L'interaction est déclenchée chaque fois que le niveau de zoom de la scène change. (voir § les lieux / scènes > scènes zoomées)

Déclencheurs basés sur des objets

▸ Observer un objet. L'interaction est déclenchée quand le joueur fait un clic gauche sur l'objet stipulé (de tout type sauf passage). À défaut d'interaction de ce type, le nom et la description de l'objet s'affichent dans le bandeau du haut.

▸ Ramasser un objet. L'interaction est déclenchée quand le joueur double-clique ou fait un clic droit sur l'objet stipulé (de type ramassable uniquement). À défaut d'interaction de ce type, l'objet entre dans l'inventaire. Si une interaction existe, l'objet n'est pas ajouté à l'inventaire ; il faut pour ce faire ajouter un effet Donner un objet.

▸ Actionner un objet ou parler. L'interaction est déclenchée quand le joueur double-clique sur l'objet stipulé, qu'il se trouve dans la scène (pour un objet du décor ou un personnage) ou dans l'inventaire (pour un objet d'inventaire).

▸ Utiliser un objet sur un autre. (= combiner 2 objets). Ce déclencheur n'est possible qu'entre objets de type objet d'inventaire, éléments de décor, et personnages (typiquement, donner un objet de l'inventaire à un personnage).  L'interaction est déclenchée quand le joueur fait un glisser-déposer (drag-n-drop) de l'objet1 sur l'objet2 ou vice versa. Il est aussi possible d'utiliser l'un sur l'autre deux objets de l'inventaire, par exemple pour en fabriquer un 3ème.

Nb : par défaut si une combinaison d'objets ne mène à aucun résultats (ce qui est le cas la plupart du temps), JAWA affichera une croix rouge indiquant au joueur que son action n'aboutit à rien. Vous pouvez remplacer ce comportement par défaut par une interaction avec les effets de votre choix (par exemple afficher un dialogue `je ne peux pas faire ça`) en créant une interaction COMBINER avec comme objet 1 l'objet cible qui doit présenter ce comportement par défaut, et comme objet 2 `n'importe quel objet`. Quelque soit la priorité de cette interaction avec `n'importe quel objet` elle sera forcément évaluée après les interactions combinant l'objet cible avec un autre objet spécifique.

▸ N'importe quelle action du joueur. L'interaction est déclenchée quelle que soit l'action du joueur : clic gauche, clic droit, double clic. Ce déclencheur n'est jamais prioritaire sur un déclencheur Observer ou Actionner associé au même objet. Ce déclencheur accélère le développement du scénario en réduisant le nombre d'interactions, et rend le jeu plus ergonomique en limitant le nombre de clics. Par exemple, quand le joueur trouve un interrupteur sur un mur, il n'a pas besoin de l'observer pour comprendre qu'il doit appuyer dessus. De même, dans une scène de type puzzle, il serait fastidieux de devoir doubler-cliquer sur chaque pièce que l'on veut déplacer. A noter : le déclencheur `toute action du joueur` ne sera pas appliqué aux objets ramassables quand ils sont encore dans le décor (car il doit toujours rester possible de ramasser un objet ramassable). Il s'appliquera en revanche sur ce même objet une fois entré dans l'inventaire.

▸ Glisser / Pivoter un objet (bêta). Depuis JAWA 32, ce déclencheur peut être utilisé avec les objets déplaçables et rotatifs, il lancera l'interaction durant le mouvement que fait le joueur en continu, c'est à dire à chaque pixel ou degré de variation de l'objet déplacé/pivoté. Ceci permet de créer des mécanismes de puzzle réagissant en temps réel et offre de de nombreuses possibilités nouvelles d'utilisation des objets déplaçables, puisqu'il va se passer des choses pendant le drag/drop et plus seulement lorsque le joueur relâche l'objet. Par exemple, dans un système de treuil, vous pourrez faire monter/descendre en temps réel un objet `poids à soulever` au fur et à mesure que le joueur tourne une manivelle.

ATTENTION : glisser un objet est une action particulière qui exécute les effets à chaque déplacement d'un pixel de l'objet, donc va fortement charger le navigateur. Les effets doivent donc rester très légers et surtout ne pas être interrompre le geste utilisateur, à cette fin les effets dits interruptifs ne sont pas exécuté dans une interaction de type glisser déposer, qu'il s'agisse de ceux demandant clic ou saisie utilisateur (afficher un message, poser une question...) ou ceux impliquant un délai d'exécution (obtenir un objet, un trophée, un indice...).

Lorsque l'objet glissé est déposé (drop) , cela déclenche prioritairement une interaction "combiner avec" si un combo valide existe et dans le cas contraire, exécutera un "actionner" sur l'objet déposé.

Pour conditionner la réalisation des effets d'une interaction "glisser" ou des interactions jouées lors du "déposer", vous pouvez utiliser la variable d'interface {{_distance}} (longueur du déplacement en pixels) ou {{_dragX}} / {{_dragY}} pour déterminer si le déplacement est significatif ou pas.



Pratique : ID d'objets génériques liés aux déclencheurs

Dans les interactions d'objet, pour simplifier l'écriture des effets et condition, l'objet sélectionné sera désigné sous la dénomination `objet cible de l'interaction` dans l'assistant et l'éditeur simplifié, et par le n° d'ID générique "1", l'objet avec lequel il est combiné dans les interactions de type "utiliser X sur Y" portera l'ID générique "2". Ces raccourcis permettant dans bien des cas de ne pas avoir à s'occuper de retrouver et resaisir des identifiants d'objets car bien souvent l'objet cible de l'interaction va être manipulé dans les effets et conditions.
Cela est d'autant plus utile, voir indispensable dans les interactions ciblant des groupes d'objets, voir ci après.


Déclencheur de comportement autonome

En associant à un objet une ou plusieurs interactions de type "comportement autonome" celui-ci va avoir avoir sa "vie propre" et lancer des interactions automatiquement et indépendamment du joueur, et sans bloquer l'interface (contrairement aux autres types d'interactions résulttant toujours d'une action du joueur). Ceci permet d'enrichir vos environnements et de créer de nouveaux mécanismes gameplay. Pour en savoir plus, voir le  § comportements autonomes.


Déclencheurs basés sur des groupes d'objets

Depuis JAWA 33, il est possible d'associer les déclencheurs non pas sur un objet donné mais sur un groupe d'objets (voir les objets > groupes). Ceci peut vous permettre de restreindre drastiquement le nombre d'interactions à créer pour des mécanismes ou N objets différents ont un comportement/une algorithmique similaire , typiquement un jeu de carte. 

Tous les déclencheurs d'objet (observer, actionner, toute action / tout click, glisser / pivoter, combiner) s'appliquent aux groupes d'objets. Comme vous ne saurez pas au niveau du déclencheur que objet précis parmi le groupe a été effectivement manipulé par le joueur, et que celui-ci risque fort de devoir être testé dans les conditions et modifié dans les effets, dans l'écriture, vous pourrez utiliser les identifiants génériques 1 (objet cliqué) et 2 (objet combiné le cas échéant) pour désigner l'objet avec lequel le joueur a effectivement interagit.

Autres raccourcis utiles :

  • La variable système {{_actionne}} ou {{_triggered}} renverront l'id de l'objet.
  • Dans une combinaison  d'objet, la variable système {{_combine_avec}}  ( ou {{_combined_with}} portera l'id de l'objet2
    => plus d'infos dans § les variables

Exemple : vous créez un jeu de 32 cartes à l'écran, toutes groupées dans un seul groupe  et que vous devez toutes pouvoir retourner individuellement en cliquant dessus. Elles sont toutes initialement face cachée, et disposent toutes d'une image secondaire (n°2) qui leur est propre. Pour pouvoir toutes les retourner, vous n'aurez qu'une interactions à créer au lieu de 32  :

Déclencheur : toute action du joueur

Sur (objet) : [groupe] Cartes

Conditions : _image_1<2  // pour vérifier que la carte n'est pas déjà retournée

Effets :

modifier:1:flip:1:1 // lancer un effet de symétrie autour de l'axe vertical sur la carte cliquée (en 1s)
pause:.5 // et après une demi seconde (quand la carte est à moitié retournée n'est plus qu'une ligne)...
modifier:1:image:2 // passer la carte cliquée à l'image de sa face visible



Il est possible de créer un déclencheur "combiner un groupe d'objet avec un objet du même groupe" (exemple, poser une carte sur une autre) ou un objet d'un groupe G1 avec un groupe G2.


Cibler un déclencheur d'objet dans un lieu donné :

Par exemple vous voulez que l'action sur un objet de l'inventaire ne produise pas le même résultat suivant le lieux ou ou l'utilise.

Le champ `dans` du déclencheur de l'interaction permet de préciser que celle si ne se déclenchera que si le joueur est dans un lieu précis pour qu'une même action aboutisse à des résultats différents suivant l'endroit ou le joueur la fait. Il présente toutefois l'intérêt de pouvoir dissocier si le joueur utilise/observe un objet d'inventaire quand il est dans le décor (choisir le lieu en question) ou depuis son inventaire (choisir `depuis l'inventaire`).

Ce champ s'apparente donc à une condition qui vient s'additionner au bloc de conditions spécifiques de l'interaction. Il peut d'ailleurs être remplacé par une condition `_lieu={id du lieu}` ou `_scene={id du lieu}` dans ce bloc(le lieu 0 figurant l'inventaire)


Déclencher une interaction par un QRcode

[depuis JAWA 39]

Vous pouvez déclencher des interactions en scannant un QRcode, par exemple pour ouvrir une porte ou obtenir un indice. Cette fonctionnalité est très pratiques et étend grandement les possibilités gameplay pour des jeux mobiles en réalité mixte (mêlant présentiel et virtuel) ou même pour un jeu sur ordinateur en présentant devant la webcam du joueur un code imprimé ou affiché sur son smartphone. Idéal pour une chasse au trésor ou un jeu de piste dans vos locaux, votre musée, votre village...

Pour utiliser ce type de déclencheur, vous devez  :

  • intégrer les interactions associées au QR code dans un script (voir § interactions > scripts). Dans l'éditeur de script cliquez  sur associer. 
  • afficher le scanner de QRcodes à un moment du jeu (par exemple sur appui sur un bouton), pour cela utiliser l'effet "scanQR (:message d'invite) ", ex :
scanQR:Scannez le code sur la porte de l'église ! 


Et c'est tout ! le fait de scanner le QR associé à un script déclenchera ce script. Bien entendu, vous pouvez ajouter plusieurs interactions à votre script basées sur des conditions différentes, scanner un même QRcode pourra  donc aboutir à des effets différents suivant l'avancement dans le jeu.

NB :

- lancer le scanner de QRcodes sur l'appareil du joueur requerra qu'il/elle accepte d'accorder au jeu l'autorisation d'accès à la webcam.

- l'effet scanQR mettra fin à l'interaction pour rendre la main au joueur, ce doit donc être le dernier effet de votre interaction.


Créer un combinogramme

L'effet scanQR, qui active la caméra de l'appareil, peut aussi être utilisé non pas pour lire un QR code mais pour afficher un "combinogramme", qui est un autre moyen d'utiliser JAWA en réalité augmentée/présentiel.

Un combinogramme est composé d'un couple d'images, chacune comprenant des parties complémentaires d'une image globale, comme un code, un pictogramme.... l'une de ses 2 images peut être affichée en surimpression e la caméra du joueur (à la place de la mire de ciblage d'un qrcode) et l'autre sera affichée hors du jeu dans un lieu, un mail, etc... En positionnant le téléphone de manière à parfaitement superposer les 2 images incomplètes, l'image complète devient lisible et le code se révèle au joueur, qu'il peut ensuite utiliser ailleurs dans le jeu. Attention , l'image globale doit être facile à lire, comme un code à 4 chiffres par exemple.


Vous pouvez utiliser l'outil suivant pour créer un combinogramme à partir d'une image quelconque (min 500 * 500px et format carré recommandé):

https://jawa.games/tools/combinogramme/combinogramme.php

Vous obtiendrez 2 images, l'une pour votre jeu, et l'autre pour votre décor réel.


Pour afficher un masque sur la caméra :

1) chargez l'image "masque" dans les compléments du jeu (voir § les compléments / plugins)

2) appelez l'effet scanQr avec un 3ème paramètre précisant le nom de l'image (en tenant compte des éventuels sous dossiers).

ex :

scanQR:Trouvez l'image complémentaire sur la place du village:combi1-mask.png


↥