manuel scenarioStudio

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

les effets

ointLes effets sont les composants des interactions. Ils permettent de modifier l'environnement ou les variables ; de donner des information au joueur, de le déplacer ou d'interagir avec lui ; de déclencher un contenu multimédia ou un script... en bref, de faire avancer la partie. Selon les cas, les effets impactent l'aspect visuel des scènes ou des objets, le déroulement du scénario ou les données de jeu. scenarioStudio en propose une petite trentaine, détaillés ci-après.

Saisie des effets : éditeur simplifié et/ou éditeur JAWAscript

Saisissez les effets dans la fenêtre de l'interaction concernée, section "effets".

En mode éditeur, des menus déroulants listent les types d'effets ainsi que toutes les ressources de votre jeu permettant de créer vos effets sans `coder`. L'assistant de saisie donne accès à la plupart des effets, ceux utilisés couramment pour la création d'un jeu. Les effets très rarement utilisés ou requerrant des compétences expert à l'attention des développeurs web ne seront pas proposés.

En mode expert, vous devez saisir les effets dans un champ texte suivant la syntaxe JAWAscript, en les séparant par un retour à la ligne. Ce mode "textuel" donne accès à tous les effets.

Appuyez sur la touche TAB ou cliquez sur le bouton central/la molette de la souris pour afficher l'assistant de saisie qui vous économisera d'avoir à connaître les noms des effets ni les id de vos ressources.

Voici la syntaxe générale de saisie d'un effet en JAWAscript :

nom_effet:param1:param2:...


N.B.

  • JAWA ne tient pas compte de la casse (majuscule/minuscule).
  • La plupart des effets ont plusieurs noms (version française, version  anglaise), utilisables indifféremment, la syntaxe des paramètres restant la même. La V30 a simplifié les noms (par exemple, changerparam est devenu modifier). Ce manuel présente uniquement les derniers noms, mais les anciens restent supportés.
Quand plusieurs interactions portent les mêmes effets, vous pouvez utiliser l'effet copiereffets pour accélérer votre travail (voir ci-après).

Le langage JAWAscript est très simple et rapide à apprendre, et vous fera gagner beaucoup de temps à terme dans la création de vos effets. Il donne en outre accès à davantage d'effets pour des usages plus avancés.

obtenir les ID des ressources

JAWA attribue un uméro unique a chaque scène et objet créé. Une grand partie des effets permettent de manipuler les ressources (lieux, objets, scripts...) et ceux ci doivent donc être référencés en JAWAscript par leurs ID (identifiant numériques uniques). Il est possible d'utiliser a tout moment l'assistant pour obtenir l'id d'une ressource en la recherchant par son nom. Mais vous pouvez aussi facilement retrouver les IDs directement à plusieurs endroits de scenarioStudio :
 ▸ dans la palette et les éditeur de scène
 ▸ dans les barre titre des fenêtres
 ▸ dans l'infobulle au survol d'un objet de la palette ou d'un éditeur de scène
 ▸ ...


Identifiants génériques des objets et des scènes

Certains IDs (valeurs 0 et à 4) sont particuliers et permettent de désigner un objet ou un lieu a chaque fois qu'un id est attendu dans un effet ou dans une variable d'objet, et ce manière générqiue et contextuelle :

Dit autrement donc dans 2 contextes différents un id générique peut renvoyer des valeurs différentes. Il y a a 3 niveaux de contexte d'exécution : la chaîne d'interaction > qui contient des interactions > qui contiennent des effets

(Une chaîne d'interactions c'est  plus issue interactions s'exécutent derrière une seule action du joueur, cad quand un objet en actionne un autre (typiquement le cas des scripts) qui potentiellement en appelle encore un autre et ainsi de suite.. voir les interactions > chaînes d'interaction).

Ces IDs permettent de gagner du temps sans avoir à chercher saisir explicitement l'id de l'objet que l'on vient d'utiliser( typiquement si on clique sur un perso et qu'il nous répond, ses dialogues peuvent être basés sur l'id 1). Et ils sont particulièrement pratiques et même indispensables parfois dans le cadre de la factorisation du code : chaines d'interactions et interattraction de groupes, qui interactions qui ne sont plus attachées à un objet spécifique.


id génériqueinterprétation
0pour un objet correspond au joueur/à son avatar, pour une scène correspond à l'id de la scène en cours (on peut aussi utiliser l'id 1 pour désigner la scène en cours
1correspond à l'objet portant la première interaction de la chaîne, c'est à dire celui sur lequel le joueur a clqiué pour déclencher la chaîne. il aura la même valeur pour toutes les interactions de la chaîne
2correspond à l'objet combiné dans la 1ère interaction de la chaîne, le cas échéant (déclencheur "utiliser sur")
3correspond à l'objet portant l'interaction en cours d'exécution dans la chaîne. Il aura donc un valeur différente dans chaque interaction d e la chaîne. Dans la 1ere interaction de la chaîne, il a la même valeur que l'ID 1 puisque c'est la 1ere interaction déclenchée par le joueur, mais pas dans les suivantes.
4correspond à l'objet manipulé par l'effet en cours, il aura donc une valeur potentiellement différente dans chaque effets, ou pour chaque membre du groupe si on fait un effet de groupe


Un cas test pour mieux comprendre :

Vous créez 2 personnages, Marcel et René :

- interaction sur Marcel

dialogue:3:l'objet cliqué est {{_nom_1}} et moi je suis {{_nom_3}}
actionner:<id rené>

Marcel actionne René une fois qu'il a fini de parler.

- interaction sur rené

dialogue:3:l'objet cliqué est {{_nom_1}} et moi je suis {{_nom_3}}

-> Notez qu'on utilise exactement le même effet de dialogue sur les 2 personnages. 


Si on clique sur Marcel on va donc lancer la chaîne d'interactions "actionner marcel" > "actionner rené", et ce qu'on va voir à l'écran sera :

- marcel dit " l'objet cliqué est marcel et moi je suis Marcel" (dans la 1ere interaction de la chaîne 1 = marcel =  3)

- René dit " l'objet cliqué est marcel et moi je suis rené" (dans la seconde inter de la châine, 1= marcel / 3= rené)


Si on clique directement sur René, on a une chaîne mono interaction, dans la 1ere et seule inter id 1= id 3 = rené, le dialogue sera donc

- René dit " l'objet cliqué est rené et moi je suis rené"


Du coup Un piège  à éviter avec l'id 1, si on avait utilisé l'id générique 1 au lieu du 3 comme pour désigner le personnage qui parle,cela aurait été toujours l'objet porteur de la 1ere inetarction qui aurait parlé

dialogue:1:l'objet cliqué est {{_nom_1}} et moi je suis {{_nom_3}}
...

résultat :

- Marcel dit " l'objet cliqué est marcel et moi je suis Marcel" (dans la 1ere interaction de la chaîne 1 = marcel =  3)

- [b]Marcel[/b] dit " l'objet cliqué est marcel et moi je suis rené


Points d'attention :
- L'effet copier effets ne crée pas de chaîne d'interaction, contrairement à l'effet actionner. Donc n'altère pas le contexte, c'est comme vous aviez vraiment copié à la main les effets de l'interaction source a l'endroit du copierEffets.

- Enfin , plutôt que les chiffres 1,2, 3 , et 4, vous pouvez utiliser des mots clés un peu plus évocateurs :
    _nom_1 = _nom_TRIGGERED
    _nom_2 = _nom_COMBINED
    _nom_3 = _nom_CURRENT
    _nom_4 = _nom_SELF




Erreurs de syntaxe ou de logique

Quel que soit le mode de saisie, JAWA vous signale les éventuelles anomalies dès que vous revenez en mode visualisation, ainsi que par la coloration syntaxique dans les éditeurs JAWAscript. Vous pouvez aussi toutes les détecter en une passe grâce à la fonction vérifier le gamescript, accessible en haut de la palette, qui contrôle d'avantage de points dans vos ressources et interactions.

Commentaires

Pour faciliter vos tests ou vous repérer dans vos interactions, vous pouvez intercaler des commentaires entre les effets (ce n'est en revanche pas possible dans les conditions) En mode éditeur simplifié / assistant, choisissez l'option Commentaire dans le menu déroulant et saisissez le texte voulu dans le champ. En mode expert, déclarez une ligne comme commentaire en la faisant débuter par //.

Liste et description des effets

Dans la liste ci-après, le titre EN MAJUSCULES correspond au nom de l'effet en mode éditeur simplifié. Il est suivi de la syntaxe adéquate en langage JAWAscript si vous écrivez vos effets en mode expert (ce qui donne accès pour certains d'eux à des paramètres avanncés supplémentaires). Les paramètres d'appel de chaque effets sont en italique.

Pour rappel, en jawascript vous devrez désigner les ressources par leur ID ou utiliser l'assistant pour les obtenir (voir encart ci-avant)



AFFICHER UN MESSAGE

message:texte_message

Cet effet affiche message dans un bandeau en surimpression et attend un clic du joueur pour passer à l'effet suivant.

Le message s'effacera au clic, sauf si l'effet suivant est un effet de type choix, auquel cas le message restera affiché au dessus de la boîte de choix, permettant de donner un intitulé à celle-ci. Pour éviter ce comportement, vous pouvez intercaler entre les 2 effets une pause très courte (effet pause:0.1).

Mémo. Il est possible d'afficher la valeur d'une variable dans un message, par exemple pour reprendre le nom du joueur. La syntaxe en majuscules est : {{NOM_VARIABLE}} Il est également possible d'afficher une message aléatoire choisie parmi plusieurs en séparant ceux-ci par des | dans le même effet (voir § dialogues interactifs)
Il est également possible d'afficher une page ou un contenu web (y compris hébergé dans les compléments de votre jeu) dans une boîte de message afin d'enrichir le jeu, en faisant démarrer le texte du message par le mot clé "url", pui sen séparant les paramètres d'affichage par des virgules. Un bouton passer reste disponible pour enchaîner l'effet suivant. En mode expert, saisissez la syntaxe suivante, en séparant les paramètres par des virgules :
message:url,adresse de la page ou de l'image,largeur,hauteur,opacité
url Adresse de la page à afficher. Cette page doit être optimisée pour tenir dans la zone de jeu et être éventuellement adaptée à la charte. Le site-source doit autoriser le cross-site framing et proposer des temps de chargement raisonnables. nb: l'adresse doit commencer par http:// ou https://
largeur Largeur de la boîte de message, en pixels. Elle doit être inférieure à la largeur de la zone de jeu (par défaut, elle en occupe 80%).
hauteur Hauteur de la boîte de message, en pixels. Elle doit être inférieure à la hauteur de la zone de jeu (par défaut, elle en occupe 80%).
opacité Opacité de la boîte de message, en % (par défaut, 80%).

Enfin, dans certains cas le positionnement par défaut de la boîte de message dan la partie supérieure de l'écran peut gêner la lisibilité, par exemple, si le message fait référence à un élément qui est derrière la boîte. Dans ce cas, vous pouvez insérer un paramètre numérique avant le texte du message pour stipuler la hauteur d'affichage de la boîte (en pixels), par exemple, ceci va afficher la boîte de message à une distance de 400 pixels du bord supérieur. 

message:400:Ceci est un message
NB : Il est également possible de redéfinir la position par défaut de la boîte de message via la css personalisée du jeu (voir paramètres du jeu)



AFFICHER UN DIALOGUE

dialogue:ID_objet:texte

Cet effet affiche texte dans une bulle en surimpression au-dessus de l'objet stipulé. En mode expert, l'ID 0 correspond au joueur (ou à son avatar en vue à la 3e personne).

Mémo. Il est possible d'afficher la valeur d'une variable dans un dialogue, par exemple pour reprendre le nom du joueur. La syntaxe est : {{NOM_VARIABLE}}. Il est également possible d'afficher une réplique aléatoire choisie parmi plusieurs en séparant celles ci par des | dans le même effet (voir § dialogues interactifs)
POSER UNE QUESTION OUVERTE
question:variable_reponse:question

Cet effet affiche question dans une boîte en surimpression où le joueur doit saisir une information (par exemple, son nom). Cette information est stockée dans la varaible variable_reponse. Vous pouvez ensuite utiliser la variable dans des tests de condition, ou pour personnaliser des messages et dialogues, via la syntaxe {{VARIABLE_REPONSE}}



DEMANDER UN MOT DE PASSE

motdepasse:mot_de_passe_attendu:demande:message_erreur
 ou
password:mot_de_passe_attendu:demande:message_erreur

Cet effet affiche le texte demande dans une boîte en surimpression où le joueur doit saisir le mot de passe. S'il correspond à mot_de_passe_attendu, la résolution des effets se poursuit. Sinon, message_erreur s'affiche dans un bandeau en surimpression et l'interaction s'interrompt..

Note. La réponse du joueur est insensible à la casse (majuscule/minuscule). 



PROPOSER UN CHOIX

choix:nom_variable:valeur1/choix1:valeur2/choix2:valeur3/choix3:valeur3… 
ou choice:nom_variable:valeur1/choix1:valeur2/choix2:valeur3/choix3:valeur3…

Cet effet affiche les choix dans une boîte en surimpression où le joueur doit sélectionner son choix. La variable nom_variable prend la valeur définie avant le choix sélectionné. Vous pouvez ensuite utiliser la réponse comme condition pour déclencher des conséquences différentes suivant la réponse du joueur (dans une interaction déclenchée avec un effet "actionner")  ou pour personnaliser des messages et dialogues.

La liste des réponses possibles s'écrit sous forme de couples `valeur_réponse:texte_réponse` séparés par des slashs ( / )

A noter :

  • la boîte de choix ne propose que les réponses possibles mais pas l'intitulé de la question.
  • Si cet effet est précédé d'un effet `message`, celui-ci restera affiché en guise d'intitulé.
  • Si vous souhaitez proposer des choix de réponse dans un dialogue, utilisez plutôt l'éditeur de dialgues interactif (voir chapitre interactions /dialogues interactifs) 



AJOUTER UN OBJET A L'INVENTAIRE

obtenir:ID_objet (:quantité (:invisible 0/1) )
ou
giveObject:ID_objet (:quantité (:invisible 0/1) )

Cet effet place l'objet stipulé dans l'inventaire du joueur. L'objet doit être de type "objet d'inventaire". Il peut être présent dans le lieu en cours (même inactif), dans un autre ou stocké dans le réservoir/corbeille, dans tous les cas il disparaîtra visuellement de son lieu d'origine.

Le second paramètre (facultatif) permet de préciser la quantité d'objet pour les objets cumulables (voir § les objets), par exemple pour ajouter 5000 pièces d'or : le joueur aura un seul objet pièces dans son inventaire mais avec une quantité élevée. Même si la syntaxe n'est pas tout à fait logique, le même effet `obtenir` utilisé avec une quantité négative va servir à faire baisser la quantité cumulée de l'objet.

Et la quantité atteint 0 ou moins, l'objet sera retiré de l'inventaire. En revanche l'effet `perdre un objet` (voir ci -après) ne permet pas de manipuler les quantités et va retirer l'objet de l'inventaire quelque soit la quantité.

Mode masqué : depuis JAWA 32, il est possible d'ajouter un troisième paramètre (en jawascript) avec la valeur 0 pour rendre l'obtention de l'objet invisible et instantanée (pas de boîte `nouvel objet` ni d'animation d'ouverture de l'inventaire).



RETIRER UN OBJET DE L'INVENTAIRE

perdre:ID_objet (:id_lieu_de_retour (:invisible 0/1) ) 
 ou
removeObject:ID_objet (:id_lieu_de_retour (:invisible 0/1) )

Cet effet retire l'objet stipulé de l'inventaire du joueur. 

Si un second paramètre `id_lieu_de_retour` est précisé, l'objet d'inventaire redeviendra disponible dans le lieu #id_lieu_de_retour), avec ses paramètres d'affichage actuels (taille, position, image...) et pourra à nouveau être ramassé, observé.... Si vous utilisez l'id de lieu de retour 0, l'objet perdu sera réintégré au lieu en cours, l'id -1 renverra l'objet dans le réservoir.

Mode masqué : depuis JAWA 32, il est possible d'ajouter un troisième paramètre avec la valeur 0 pour rendre la perte de l'objet invisible et instantanée (pas d'animation d'ouverture de l'inventaire et retrait de l'objet).

NB :

  • Retirer un objet cumulable va le supprimer quelque soit la quantité dont en dispose.
  • Cela sera sans effet si l'objet n'est déjà plus dans l'inventaire ou si l'objet indiqué n'est pas de type objet d'inventaire.


MODIFIER UNE VARIABLE

variable:nom_variable:nouvelle_valeur
 ou
var:nom_variable:nouvelle_valeur

Cet effet change la valeur de la variable nom_variable en valeur.

La valeur peut être un mot/texte ou un nombre.


Opérations : Il est possible en utilisant des valeurs de variables spécifiques d'affecter à une variable la valeur d'une autre variable, un nombre aléatoire, de faire des opérations numériques d'incrémentation / décrémentation ou des opérations mathématiques complexes sur les variables numériques, d'effectuer des concaténations ou troncatures de chaînes... Toutes ces opérations peuvent impliquer d'autres variables. Les détails  des opérations possibles sur les variables sont expliquées dans le chapitres ressources / les variables

exemples :

variable:MA_VARIABLE:+1 // incrémente d'une unité la variable MA_VARIABLE
variable:MA_VARIABLE:{{MON_AUTRE_VARIABLE}} // affecte à MA_VARIABLE la valeur de MON_AUTRE_VARIABLE
variable:TOTAL_VENTES:[(5*{{NB_VENTES}})+500-{{FRAIS}}]  // affecte à total_ventes les résultat du calcul entre crochets
variable:DE_A6_FACES:[_RAND:1:6] // tire une valeur entre 1 et 6



MODIFIER UN OBJET

modifier:ID_objet:paramètre:valeur:vitesse_transition
 ou
update:ID_objet:paramètre:valeur:vitesse_transition

Cet effet est le plus important pour faire évoluer l'environnement de jeu par rapport à sa situation initiale.

Il modifie un paramètre visuel de l'objet stipulé en lui donnant une nouvelle valeur, comme son nom, sa position, sa visibilité, son image, sa taille... la plupart des paramètre que vous définissez à la création de l'objet dans l'éditeur d'objet est modifiable,  la liste en est fournie ci-après. 
La vitesse de transition est exprimée en secondes. Par défaut, elle est d'une seconde. Vous pouvez spécifier la valeur de votre choix, y compris inférieure à 1. Pour les décimales, employez un point et non une virgule (par exemple, 0.5). Le fait d'appliquer un délai de transition permet d'animer ou fluidifier les effets graphiques mais ne met pas en pause l'exécution des effets. Il est donc possible d'empiler plusieurs effets modifier les un après les autres


Notes 

  • Cet effet peut être appliqué à un groupe d'objets pour effectuer en une opération une même transformation sur X éléments
  • L'id de l'objet peut être indiqué via une variable (syntaxe : {{NOM_VARIABLE}})
  • Le nom du paramètre n'est pas sensible à la casse
  • La vitesse de transition ne s'applique qu'aux paramètres suivants : X, Y, largeur, hauteur, opacité, luminosité, floutage, rotation. - Les anciens navigateurs (qui ne supportent pas html5) ne prennent pas compte la vitesse de transition.
  • Dans une vue à la 3e personne, il est possible de modifier certains paramètres visuels de l'avatar du joueur (ID 0, voir concevoir votre jeu/vue à la 3e personne).pour les paramètres numériques il est possible d'affecter un delta à la valeur en cours en indiquant une valeur +x ou -x. De fait si vous voulez affecter une valeur négative absolue au paramètre et non pas un delta, il vous faudra utiliser la syntaxe mXXX (ou x désigne la valeur), par exemple ` modifier::x:m300 ` va placer l'objet en coordonnée x -300.

paramètre (et libellé en JAWAscript)  effet

position X et Y

x et y

Change la coordonnée X (horizontale) ou Y (verticale) de l'objet pour le déplacer sur la scène. La valeur en pixels peut être absolue ou exprimée en delta (+x, -x). Les coordonnées sont calculées à partir du coin supérieur gauche de la scène.

Positionnement relatif au point de vue (lieux panoramiques) : exprimé en %, cet effet va positionner l'objet à x% du bord gauche ou y% du bord supérieur  de la fenêtre visible.

largeur et hauteur

w et h
Change la largeur (w pour width) ou la hauteur (h pour height) de l'objet pour qu'il grossisse ou rapetisse dans la scène. La valeur en pixels peut être absolue ou exprimée en delta (+x, -x). N.B. Quand l'objet doit être agrandi ou réduit de façon homothétique (sans déformation), il est plus rapide de modifier le paramètre zoom (voir ci-dessous).

zoom

zoom
Change la taille globale de l'objet. La valeur en % peut être absolue ou exprimée en delta (+x, -x).
opacité
opacite ou opacity ou alpha
Change le niveau de transparence (alpha) de l'objet par rapport aux éléments placés derrière. Utilisez cet effet, par exemple, pour un fantôme ou une vitre. La valeur va de 0 (invisible) à 100 (totalement opaque). Elle ne peut pas être exprimée en delta (+x, -x).

luminosité

luminosite ou brightness
Change le niveau d'éclairage de l'objet. La valeur est en % : 0 = totalement assombri ; 100 = luminosité d'origine ; 200 ou + = surexposition. Elle peut être exprimée en delta (+x, -x).

floutage

flou ou blur
Change le degré de floutage l'objet. Le floutage est particulièrement intéressant pour intégrer au décor un objet de premier plan non interactif. La valeur est en pixels : 0 = pas de floutage ; 10 =très flou. Elle peut être exprimée en delta (+x, -x).

rotation

rotation
Change l'angle de l'objet en le faisant pivoter autour de son centre. Cet effet est particulièrement pratique pour créer des casse-tête. La valeur est par définition comprise entre 0 et 360, mais vous pouvez la cumuler sur plusieurs tours ! Elle peut aussi être négative, ou exprimée en delta (+x, -x).

plan

z ou plan ou layer
Change la position de l'objet dans la structure en couches (layering) de la scène pour gérer sa position devant/derrière les autres éléments. Plus la valeur est élevée, plus l'objet est au premier plan. Elle peut être exprimée en delta (+x, -x). Pour en savoir plus, voir les ressources/les objets et les personnages.

visible

actif ou visible
Active ou désactive l'objet pour l'afficher ou le masquer. En mode expert, 1 = actif ; 0 = inactif.

interactif/inerte

inerte ou interactive
Rend l'objet inerte(1), transparent(2) ou interactif(0). Un objet inerte devient un élément de décor avec lequel le joueur ne peut pas interagir, il masque au clic/survol (et visuellement) les éléments derrière lui. U objet transparent 

deplaçable

deplacable ou movable
Change la possibilité qu'a le joueur de déplacer ou non un objet du décor par glisser-déposer (drag-n-drop). En mode expert : 0 = non déplaçable 1 = déplaçable librement, reste où on l'a déposé 2 = déplaçable en élastique, revient à sa position d'origine s'il n'interagit pas là où on l'a déposé. N.B. Le mode éditeur ne propose pas les options «librement» et «en élastique».

nom

nom ou name ou texte ou text

Change le nom de l'objet. Cet effet permet aussi de rendre un objet inerte en faisant précéder son nom d'un _ (ou de supprimer son état inerte en retirant le _).

Pour les objets de type texte, cela permet de changer le libellé affiché dans la scène.

description

description
Change la description de l'objet.

couleur

couleur ou color
Uniquement pour les objets texte et lignes : ce paramètre permet de changer la couleur d'un objet texte ou ligne. 

image

image

Change l'image de l'objet dans la scène. La valeur correspond au numéro de l'image secondaire préalablement chargée dans la fenêtre d'édition de l'objet (1 = image principale).

Dans les jeux à la 3ème personne, appliqué à l'objet 0, il permet d'afficher une posture spécifique de l'avatar (préalablement chargée dans les paramètres, voir jeux à la 3ème personne)

icône d'inventaire

icone
ou image_inventaire ou icon
Ne concerne que les objets ramassables. Change l'image de l'objet dans l'inventaire. La valeur correspond au numéro de l'image secondaire préalablement chargée dans la fenêtre d'édition de l'objet (0 ou 1 = image d'inventaire principale).

Paramètre spécifiques (custom)

customA ou custom1
customB ou custom2
customC ou custom3

Permet de modifier l'un des 3 paramètres custom de l'objet (voir § les objets).

variante

variante
Ne s'applique qu'aux jeux à la 3e personne et à l'objet 0 (= avatar du joueur). Permet de changer le spriteset de l'avatar, c'est-à-dire son habillage graphique, par exemple s'il doit changer de tenue durant le jeu ou si le joueur doit pouvoir choisir entre un homme et une femme. (Voir vue à la 3e personne.)

clip vidéo

video
(N.B. Sans accent !) Ne s'applique qu'aux objets de type vidéo. Permet de définir la vidéo à afficher et de la faire démarrer/s'arrêter. (Voir les textes & les vidéos incrustés.)

mouvement

mouvement ou movement

Permet de modifier les caractéristiques du mouvement appliqué à un objet (motif, vitesse, répétition) et donc aussi d'arrêter un mouvement (soit en mettant la répétition à 0, soit en mettant le motif à `aucun`) (voir § les objets > mouvements d'objets pour plus d'information).

En mode expert, ce paramètre requiert un sous paramètre : `motif`, `vitesse` ou `boucle` (répétition), par exemple :

modifier:id_objet:mouvement:motif:brille
modifier:id_objet:mouvement:vitesse:.5

Va appliquer à l'objet un mouvement de brillance très rapide (2 motifs par seconde)
nb : La progressivité du mouvement ne peut pas être modifiée par cet effet.

styles customisés

css
Permet de modifier dans une interaction les styles CSS customs  appliqués à l'objet (paramètres avancés des objets, à manipuler avec précaution). Attention : ce champ ne sera pas synchronisé côté serveur.

Coordonnées des points

x1 , y1
x2
, y2
Uniquement pour les objets de type ligne (voir § les objets > textes, vidéos & lignes)
Ces paramètres permettent de modifier les coordonnées des points de départ (x1,y1) et d'arrivée (x2,y2) d'un objet ligne et donc la modifier visuellement. 



MODIFIER LE DÉCOR OU LA LUMINOSITE D'UN LIEU

decor:ID_lieu:numéro_image/luminosité en % (:durée de transition)
 ou
background:ID_lieu:numéro_image/luminosité en % (:durée de transition)

Cet effet change l'image du décor de fond du lieu stipulé. La valeur correspond au numéro de l'image secondaire préalablement chargée dans la fenêtre d'édition du lieu (1 = image principale).

Cet effet permet aussi de modifier la luminosité du lieu (et de tout ce qu'il contient). Au lieu d'un numéro d'image, saisissez une valeur en % (avec le caractère %): 0 = totalement assombri ; 100% = luminosité d'origine ; 200 ou + = surexposition. Dans ce cas, vous pouvez également ajouter un paramètre définissant la durée du fondu (en secondes).

NB : Si vous utilisez l'id de lieu 0, l'effet s'appliquera au lieu en cours (lieu dans lequel se trouve le joueur)



ZOOMER DANS UNE SCÈNE (bêta)

zoomScene:ID_lieu:niveau de zoom en % (:durée de transition) 

Dispo depuis v35. Cet effet entraîne un zoom caméra dans la scène d'id id_lieu (1 = scène en cours), centré sur le centre de l'affichage.

le paramètre niveau de zoom est exprimé en % : 100 correspondant à l'échelle 1, 300 va multiplier par 3 la taille d'affichage.

Une scène zoomée devient donc nécessairement panoramique si elle ne l'était pas déjà (voir § les lieux > lieux panoramiques), la position des objets de premier plan est recalculée pour créer un effet de profondeur.

Le niveau de zoom par défaut de chaque scène peut être préétabli dans l'éditeur de scène > panoramique.

Cet effet permet de créer des zones de jeu plus grandes ou de mettre en place une loupe. Il est possible de zoomer spécifiquement sur des parties précises du décor avec l'effet zoomsur (voir plus bas).

NB : il n'est pas possible de dézoomer une scène en dessous de 100%.



MODIFIER L'AMBIANCE SONORE D'UN LIEU

ambiance:ID_lieu:id_du_son/volume%

Cet effet permet de contrôler l'ambiance sonore de chaque lieu :

▸ en utilisant un son de l'audiothèque (id_son = id du son dans l'audiothèque)

▸ en remettant le son par défaut du lieu (id_son = 0)

▸ en coupant le son du lieu (id_son = -1)

▸ en changeant le volume du son (id_son = valeur en %)

NB :
- Si vous utilisez l'id de lieu 0 ou 1, l'effet s'appliquera au lieu en cours (lieu dans lequel se trouve le joueur)

- Si vous utilisez le caractère "*" comme identifiant de lieu, le changement d'ambiance sonore s'appliquera à toutes les scènes de votre jeu.



CHANGER DE LIEU/SCENE OU DÉPLACER LE PANORAMA

changerLieu:ID_lieu (:décalage  X en pixels (:décalage Y en pixels))
 ou
goTo:ID_lieu (:décalage X en pixels (:décalage Y en pixels (:vitesse de scroll)))

Cet effet déplace le joueur dans le lieu stipulé, si vous ne précisez pas d'autres paramètres qu'un id de lieu. Vous pouvez aussi renvoyer le joueur dans le lieu d'où il vient (ID du lieu = -1). Voir aussi les ressources/les lieux et les passages.

Notes.

▸ Comme cet effet termine l'exécution de la séquence d'effets, il doit impérativement être placé en dernier ; les effets situés après ne seront pas exécutés.

▸ Cet effet shunte les éventuelles interactions de sortie du lieu dans lequel se trouve le joueur. En revanche, les éventuelles interactions d'arrivée dans le lieu-cible sont exécutées.

Vous pouvez aussi utiliser cet effet pour déplacer la caméra (viewport) dans un lieu panoramique, c'est à dire faire scroller le décor vers un certain point. Pour cela utilisez l'id de lieu 0 (lieu en cours) et spécifiez les coordonnées X (2nd param) et éventuellement Y (3ème param, pour un panoramique bi-axial) et enfin, si besoin, la vitesse de déplacement du panormama (0 = instantané). Dans cette utilisation, la séquence d'effets ne sera pas interrompue.



TRANSFÉRER UN OBJET/PERSONNAGE DANS UN AUTRE LIEU

transferer:ID_objet:ID_lieu 
ou 
transfer:ID_objet:ID_lieu 

Cet effet déplace l'objet dans le lieu stipulé. Il peut s'agir du lieu où se trouve le joueur (ID 0), ce qui permet par exemple de faire en sorte qu'un objet "suive" le joueur dans ses déplacements.

Notes :

  • Le déplacement de l'objet ne modifie pas ses paramètres visuels (coordonnées, état actif/inactif...) qui devront éventuellement être mis à jour dans la nouvelle scène.
  • Cet effet peut être appliqué à un groupe d'objets pour gagner du temps.



ACTIONNER UN OBJET/SCRIPT

actionner:ID_objet ( :id_objet_combiné (:source) )
ou
activate:ID_objet ( :id_objet_combiné (:source) )

Cet effet agit comme un relais en actionnant depuis une interaction l'objet ou le script stipulé pour déclencher une autre interaction. Toute la mécanique de déclenchement d'une interaction (déclencheur, conditions, priorités...) seront prises en compte.

Il est pratique, par exemple, après un effet Proposer un choix pour générer dans la foulée des effets différents selon le choix du joueur. (Voir aussi les scripts). Depuis JAWA 31, il est aussi possible de préciser un second ID d'objet, ce qui déclenchera l'interaction de combinaison des 2 objets entre eux (laisser vide ou  à -1 pour une activation simple)

Le 3ème paramètre optionnel (source) permet si'il est à 0 de forcer l'exécution des interactions en tant que joueur et non comme comportement d'objet, afin de reprendre la main sur l'interface (voir § comportements d'objets)

NB : cet effet ne doit pas être confondu avec l'effet "CopierEffets" qui ne copie qu'une séquence d'effets d'une autre interaction sans vérifier des conditions, voir ci après.


Imbrication d'interactions :

Avant JAWA 32, cet effet mettait obligatoirement fin à la séquence d'effets (les suivants n'étaient pas exécutés) ce qui fait que les interaction s'exécutaient forcément les unes après les autres. Dorénavant ce n'est plus le cas, ce qui permet d'imbriquer des interactions les unes dans les autres et mettre en place des mécanismes complexes avec un minimum d'interactions. Pour mettre fin à votre interaction, utilisez l'effet " stop " après un actionner.



COPIER LES EFFETS D'UNE INTERACTION

copierEffets:ID_interaction
 ou
copyEffects:ID_interaction

Cet effet exécute tous les effets de l'interaction désignée par son ID (inscrit à droite de son intitulé dans sa fenêtre d'édition). Par ailleurs, pendant la création du jeu, il permet de ne saisir qu'une seule fois une même série d'effets dans plusieurs interactions. Une modification apportée aux effets de l'interaction d'origine est répercutée dans toutes les autres.

NB : depuis  JAWA 34, cet effet est récursif : une interaction peut copier les effets dune autre interaction, qui elle même copie les effets d'une autre... etc à l'infini. Mais attention aux boucles infinies !  



JOUER UN SON

son:ID_son ( :une fois/en boucle ( :volume ) ) 
 ou
sound:ID_son ( :une fois/en boucle ( :volume ) )

Cet effet joue le son stipulé, par défaut une seule fois et au volume 100%, préalablement chargé dans l'audiothèque. Pour en savoir plus, voir les ressources/les sons et les voix.

Jouer un son n'interrompt pas l'exécution des effets de l'interaction. Il faut donc le cas échéant ajouter une pause après afin qu'il ait le temps d'être joué. Depuis JAWA 31, chaque son est indépendant, jouer un son n'interrompra donc pas un autre son différent en cours de lecture, et plusieurs sons peuvent être superposés, en plus du son d'ambiance du lieu.

2 paramètres optionnels peuvent être utilisés dans la lecture d'un son :

▸ le 3 ème paramètre permet de jouer le son en boucle (valeur : 1) plutôt qu'une fois (valeur:0)

▸ le 4 ème permet de jouer le son à un volume inférieur (entre 0 et 100%)


Pour arrêter des sons :

▸ pour arrêter tous les sons en cours de lecture, utiliser la commande arrêter un son ou la syntaxe jawascript :

son:0:0

▸ Pour arrêter un son donné sans interrompre les autres, il suffit de le rejouer au volume 0 ou d'utiliser la syntaxe jawascript :

son:ID_son:0:0



JOUER UN CLIP VIDÉO

clip:ID_clip ( :durée minimum ( :0/1=afficher les contrôles ) )

Cet effet joue le clip stipulé, préalablement chargé dans la vidéothèque ou sur youtube, en plein écran. 

Si l'identifiant est numérqiue, JAWA jouera la vidéo correspondante dans la vidéothèque du jeu. Si l'identifiant fourni n'est pas numérique, JAWA va tenter d'afficher la vidéo youtube correspondant à cet identifiant et pas le clip chargé localement.

Jouer un clip interrompt l'exécution des effets de l'interaction. Au bout d'un certaine durée (exprimée en secondes dans le second paramètre, par défaut immédiatement), un bouton passer s'affiche pour permettre de retourner manuellement au jeu, en cours de clip ( la vidéo se fermera automatiquement à la fin).

Un 3ème paramètre (optionnel) permet si il vaut `1` d'afficher les contrôles de lecture permettant d'avancer dans une vidéo ou la mettre en pause (et de la télécharger...).

Pour en savoir plus, voir le chapitre les ressources / les vidéos.

NB :

  • il est aussi possible d'intégrer les vidéos directement dans les décors du jeu via un objet "vidéo incrustée" (voir les objets) ou dans une fenêtre popin via l'effet plugin.
  • certains navigateurs ou paramètres de sécurité peuvent restreindre l'affichage des vidéos



METTRE LE FOCUS SUR UN OBJET

montrer:ID_objet ou coordonnée x en px ou % ( :coordonnée y en px ou % ( :vitesse de transition ( :sans ou avec trace 0/1 ) ) ) 
 ou
focus:ID_objet ou coordonnée x en px ou % ( :coordonnée y en px ou % ( :vitesse de transition ( :sans ou avec trace 0/1 ) ) ) 

Cet effet place une mire de focus sur un objet (qu'il soit actif ou non) ou a des coordonnées bien précises, pour attirer l'oeil du joueur. Il permet donc de montrer l'emplacement d'un objet encore invisible. L'objet concerné doit nécessairement être dans le lieu courant.

La mire reste visible jusqu'à ce que l'effet suivant de l'interaction soit exécuté. Par conséquent, si l'effet suivant ne requiert pas d'action du joueur (par exemple, Modifier une variable), la mire disparaît immédiatement. Pour contourner ce problème, placez cet effet avant un message, un dialogue, un choix ou une question, ou bien marquez un temps d'arrêt après lui (voir ci-dessous).

▸ Si vous ne spécifiez comme paramètre qu'un ID d'objet (ou que le second paramètre vaut 0), la mire est centrée sur cet objet.

▸ Si vous spécifiez des coordonnées X et Y, la mire est placée à cet endroit. Elles peuvent être exprimées en pixels (valeurs seules) ou au prorata de la taille de le fenêtre de jeu (valeur suivie de %).

Dans le second cas, le positionnement ne tient pas compte d'un éventuel décalage de la vue dans un lieu panoramique (ce qui permet par exemple de mettre le focus sur l'icône de la carte ou sac à dos).

paramètres optionnels :

De nouveaux paramètres optionnels ont été ajoutés à cet effet afin de permettre de montre régalement des mouvements de souris ou du doigt en plus de désigner un point ou un élément.

 ▸ le 3ème paramètre vitesse permet définir la vitesse à laquelle le focus va passer d'un élément/de coordonnées à un autre à un autre élément/autres coordonnées dans un focus suivant (par défaut: 0.5s). La temporisation du focus n'interrompront pas l'exécution des effets (il faut ajouter un effet pause de durée équivalent juste après pour ce faire)
 ▸ le 4ème paramètre trace permet, si sa valeur vaut 1, de tracer le déplacement du focus entre 2 éléments / coordonnées successivement montrés (par défaut, 0 = désactivé)

Ces effets peuvent par exemple servir à donner au jouer des instructions plus claires sue le gameplay d'un puzzle.

Exemple, les effets suivants :

focus:200:200
pause:1
focus:XXXX:0:5:1
pause:2
message:glissez l'objet vers cette zone.

vont :

▸ mettre le focus en 200 x 200 (par exemple sur un objet à déplacer) quasi instantanément

▸ faire une pause d'une seconde

▸ faire glisser le focus vers le center de l'objet d'id XXXX en 5 secondes et avec une trace de déplacement

▸ afficher après 2 secondes le message `glissez l'objet vers cette zone`.


DEPLACER/ZOOMER LA CAMERA SUR UN OBJET OU DES COORDONNÉES

camera:ID_objet ou coordonnée x en px ou %:0 ou coordonnée y en px ou %:Niveau de zoom (:vitesse de transition)


précédement (ne plus utiliser cette syntaxe) :

zoomSur:ID_objet ou coordonnée x en px ou %:0 ou coordonnée y en px ou %:Niveau de zoom (:vitesse de transition)
 ou
zoomOn:ID_objet ou coordonnée x en px ou %:0 ou coordonnée y en px ou %:Niveau de zoom (:vitesse de transition)

Depuis V35. Cet effet permet d'effectuer un zoom caméra sur un objet précis (aligné sur son centre) en fournissant son id en paramètre un et 0 en paramètre 2, ou sur des coordonnées précises exprimées (en pixels ou en %), auquel cas il faut renseigner une valeur pour les 2 premiers paramètres. 

Le 3ème paramètre permet de définir le niveau de zoom en % (ne pas préciser l'unité) par exemple : 100 = niveau de zoom initial (échelle à laquelle la scène a été créée dans scenarioStudio), 300 = zoom x 3

Le 4ème paramètre (optionnel) permet de définir la vitesse de transition (en secondes).

Une scène zoomée devient donc nécessairement panoramique si elle ne l'était pas déjà (voir § les lieux > lieux panoramiques), la position des objets de premier plan est recalculée pour créer un effet de profondeur.


Nb : il est aussi possible de zoomer globalement une scène par son centre avec l'effet zoomScene.

NB : il n'est pas possible de dézoomer une scène en dessous de 100%.



MARQUER UN TEMPS D'ARRÊT (PAUSE)

pause:nombre_secondes (:1 = sautable)

Cet effet met l'interface en pause pendant le nombre de secondes stipulé. Il est utile, par exemple, pour laisser à un son le temps d'être joué ou pour décomposer plus nettement les phases d'un mouvement.
Depuis JAWA 36, vous pouvez ajouter une second paramètre avec la valeur 1 pour permettre au joueur de sauter la pause en cliquant n'importe où.

Mémo. Vous pouvez spécifier une pause inférieure à une seconde en utilisant le point comme séparateur décimal, par exemple 0.2. (Pour les décimales, utilisez des virgules et non des points.)



DÉMARRER/ARRÊTER LE COMPTE À REBOURS

chrono:ID_objet/script:nombre_secondes ( : visible 0/1 ( : interruptible 0/1 ) )

Cet effet est utile quand on veut imposer au joueur d'accomplir une tâche dans un temps donné, ou quand on veut déclencher des interactions en arrière-plan sans lien avec une action du joueur. Par défaut, un compteur s'affiche en surimpression dans tous les lieux du jeu, mais vous pouvez le masquer en ajoutant le paramètre optionnel :0

Egalement (depuis jawa36), un 4ème paramètre optionnel peut être ajouté (avec la valeur 1) pour rendre le chrono interruptible : dans ce cas le temps n'est plus décompté durant les interactions (et la mise en pause du jeu).

Exemple.

chrono:1000:10:0

déclenche un chrono invisible actionnant le script ou l'objet #1000 au bout de 10 secondes.

▸ Démarrage. L'objet ou script stipulé est actionné au bout du nombre de secondes indiqué. Par exemple, il déclenche l'affichage d'un message disant au joueur que le temps imparti est écoulé.

▸ Arrêter le chrono. En mode expert, la syntaxe est :

chrono:0:0 

Utilisez cet effet quand le joueur a réussi la tâche dans le temps imparti.

Conseils 

  • N'oubliez pas de programmer l'arrêt du chrono dans le cas où le joueur accomplit la tâche avant la fin du temps imparti.
  • Réfléchissez aux actions faisables par le joueur durant la séquence chronométrée. En effet, si le chrono s'arrête alors que le joueur est au milieu d'une interaction, les effets liés à la fin du chrono ne sont exécutés qu'après ceux de l'interaction en cours.
  • N'oubliez pas que joueur peut se déplacer d'un lieu à l'autre pendant le compte à rebours. Si l'objet actionné à l'expiration du chrono doit être visualisé, il doit se trouver au même endroit que le joueur.
  • L'expiration du chrono peut actionner un objet non visualisable stocké dans le réservoir/corbeille, ou encore un script.
  • Il ne peut y avoir qu'un seul chrono en cours : démarrer un chrono alors qu'un autre est en train de tourner rend caduc le premier.
  • Visionnez le tutoriel vidéo Créer un mini-jeu d'objets cachés pour un exemple concret d'utilisation du chrono



DÉBLOQUER UN INDICE

indice:texte_indice
 ou
clue:texte_indice

Quand cet effet est déclenché, une ampoule s'affiche brièvement en surimpression pour signaler au joueur qu'un indice (ou une note) a été ajouté dans la boîte d'aide (accessible par l'icône ? dans son interface). Des indices peuvent être ainsi distillés via les interactions au cours de l'histoire pour aider le joueur à progresser et lui éviter d'être bloqué trop longtemps.

Il est également possible d'afficher directement l'indice dans l'interface de jeu, sans que le joueur ait besoin d'aller ouvrir le carnet d'indice. Pour cela il suffit de commencer le texte de l'indice par le caractère ` # `. Dans ce mode, l'indice sera bien enregistré dans le carnet.



ATTRIBUER UNE RÉCOMPENSE

trophee:ID_trophée 
 ou
trophy:ID_trophée 

Cet effet décerne la récompense stipulée au joueur (trophée, badge...). Le trophée doit préalablement avoir été crée. Voir récompenses & progression



OUVRIR UN LIEN/UNE PAGE

lien:adresse_de_la_page_ou_du_site 
ou
link:adresse_de_la_page_ou_du_site 

Cet effet ouvre dans une nouvelle fenêtre la page indiquée. L'adresse doit commencer par http:// ou https:// Le jeu reste affiché dans sa fenêtre mais, le joueur risquant de sortir de son immersion dans l'histoire, utilisez cet effet avec parcimonie. il est également possible d'intégrer des liens cliquables dans les messages, les dialogues et les indices, ou d'ouvrir directement un lien (vers une page, une image, une vidéo...) dans une pop-in via un effet Afficher un message (voir ci-dessus).



AFFICHER UN EFFET SPECIAL

fx:type d'effet:paramètre d'effet

Cet effet permet d'afficher un effet spécial sur l'interface pour accompagner visuellement une interaction, par exemple, l'ors d'une explosion de faire trembler l'écran. Il faut préciser le type d'effet et son paramètre numérique (qui peut agir différemment suivant le type d'effet). JAWA propose actuellement 4 types d'effets spéciaux standard:

nom d'effetdescriptionrôle du paramètre
tremble
(ou shake)
fait trembler très rapidement la scène, lors d'une explosion, ou de l'activation d'un gros mécanisme...nombre des équences à répéter, une séquence de tremblement durant une demi seconde.
distorsiondéforme le décor de manière un peu "écœurante", comme si le joueur était malade ou sous l'effet d'une droguedurée de la séquence en secondes (plus elle est élevée, plus le fx sera lent)
flashfondu vers le blanc puis retour à la normale. Peut simuler une perte de connaissance du joueur (durée 4s), ou accompagner la prise d'une photo (durée 0.5s)durée de la séquence en secondes (plus elle est élevée, plus le fx sera lent)
neonclignotement frénétique et irrég de la scène, comme si elle était éclairée par un vieux néon défaillant. nombre de séquences à répéter, une séquence de néon durant une seconde.
oculusaffiche de sbords arrondis et mouvants autour du décor, comme si on le voyait à travers une boule de cristalnombre de séquences à répéter, une séquence d'oculus durant 5 secondes
_customfx_XXXutilisation d'un fx créé par vos soins, voir ci après.durée de la séquence en secondes (plus elle est élevée, plus le fx sera lent)

Cette liste sera complétée au fil du temps. Si vous avez des notions en CSS, vous pouvez créer vos propres fx en ajoutant des descriptions d'animation HTML dans la feuille de style customisée de votre jeu (voir § paramètres du jeu > visuels), en les préfixant avec "_customfx_" (ex : @keyframes _customfx_retournement { 50 % {transform:scaleY(-1) }} )

Les effets spéciaux n'interrompent pas le déroulement des effets, si besoin ajoutez une pause juste après.



TERMINER LA PARTIE

fin 
 ou
gameOver

Cet effet termine l'aventure et donc la partie du joueur. N'oubliez pas qu'un scénario peut prévoir plusieurs fins possibles. Cet effet terminant l'exécution de la séquence d'effets, il doit impérativement être placé en dernier.




Intégrer des blocs et des boucles d'effets conditionnels

Bloc conditionnels intégrés aux effets

Depuis JAWA 33, il est possible grâce à l'effet "condition" d'intégrer des conditions de type "SI condition ALORS tels effets (SINON tels autres effets)" à l'intérieur des effets pour exécuter ou non une partie des effets de l'interaction suivant le contexte ou se trouve le jeu à un moment donné. Ceci peut donc réduire grandement le nombre d'interactions, de scripts et d'objets nécessaires et de factoriser d'avantage les effets puisque qu'une interaction va pouvoir traiter plusieurs cas de figure.

L'effet condition est uniquement disponible en mode expert et s'intègre au milieu des autres effets de l'interaction.

Pour ouvrir un bloc conditionne, utilisez l'effet condition avec une ou plusieurs conditions rédigées suivant la syntaxe JAWAScript et séparées par des " " (espaces), et non des sauts de ligne. Ces conditions peuvent intégrer des variables, des blocs de conditions (entre parenthèses), des calculs...

condition:<condition JAWAscript1> (<condition JAWAscript2> ...)

Les suivants cet efet ne seront donc joués que si la ou les conditions sont satisfaites, jusqu'à rencontre la fermeture du bloc conditionnel, celle-ci étant indiquée par un effet condition avec comme paramètre le mot clé "fin" (ou "end")

condition:fin

Bien entendu, chaque ouverture de condition doit être tôt ou tard suive d'une fermeture, sans quoi JAWA lèvera une erreur.Vous pouvez ci besoin scinder.

Vous pouvez scinder ce bloc d'effets en 2 avec une "contition:sinon" (ou :else) pour différencier un bloc d'effets qui sera exécuté si les conditions sont validées d'un second bloc qui sera au contraire exécuté si les conditions ne sont pas satisfaites. Exemple :

condition:VARIABLE_A<5
message:oui, A est bien inférieur à 5
autres effets ...
condition:sinon
message:Non, A n'est pas inférieur à 5
autres effets ...
condition:fin

Vous pouvez imbriquer des blocs conditionnels les uns dans les autres pour créer des structures logiques aussi complexes que de besoin, toujours en prenant bien soin de fermer vos blocs.

NB : en shuntant le mécanisme classique et intelligible JAWA pour le découpage des mécanismes en cas de figure :   "1 interaction = 1 contexte = 1 bloc de condition" vous perdrez en visibilité dans les différents cas de figure, ce mécanisme devrait être utiliser avec parcimonie, pour des petits traitements internes à un grand cas de figure et non clivants, par exemple, pour adapter un message ou un affichage.

Boucles intégrées aux effets

Suivant la même logique que les conditions (ci-avant), vous pouvez intégrer également des boucles du type "TANT QUE condition ALORS tels effets" avec l'effet "boucle" (ou "loop"). Tout comme un bloc de condition, un bloc de boucle doit être fermé. Gare aux boucles infinies !

boucle:VARIABLE_A<5 _ou_ VARIABLE_A>={{VARIABLE_B}}
message:oui, A est bien inférieur à 5 ou >= B
autres effets dont certains vont devoir à un moment donné modifier variable A ou B pour éviter une boucle infinie...
boucle:fin ou loop:<conditions> effets... loop:end

Nb : JAWA ne gère pas les boucles de type FOR ou UNTIL mais la boucle tant que (WHILE) permet de simuler ces autres types de boucles moyennant l'utilisation d'une variable de boucle (pour un for) ou la modification de l'écriture de la condition (pour un Until)

Là aussi, ce mécanisme est à utiliser avec parcimonie pour des traitements répétables non clivants.



Effets avancés supplémentaires

Les effets suivants n'ont pas d'impact sur le scénario mais peuvent améliorer l'expérience de jeu dans certains cas. Ils ne sont disponibles qu'en syntaxe JAWAscript (pas via les assistants de création d'effets).


CLONER UN OBJET

cloner:id_objet_source
ou
clone:id_objet_source

Depuis JAWA36. Cet effet permet de dupliquer à la volée un objet de votre jeu durant la partie, donc de créer un nouvel objet à partir d'un autre. Peut être utile pour un jeu ou un puzzle où l'on a besoin d'instancier un nombre indéterminé (= au choix du joueur) de nouveaux objets : bâtiments de sim city, cellules du corps humain... L'objet source devient donc le modèle (voir § objets > modèles d'objets), l'objet créé dispose utilisera les mêmes images (principale, secondaires, icônes) que son modèle.
L'objet est cloné dans la même scène que son modèle, aux mêmes coordonnées. Toutes ses caractéristiques sont rigoureusement les mêmes que celles de la source.

Lors d'un appel à cet effet, la variable d'interface {{_LASTID}} est mise à jour avec l'ID de l'objet qui vient d'être créé, vous pouvez alors dans la foulée du clonage modifier votre clone (nom, position, taille, image....) via des effets modifier sur l'objet{{_lastID}} et/ou le transférer dans un autre lieu (effet "transferer").

Suivant le principe des modèles d'objet, un objet créé à partir d'un modèle ne duplique pas les interactions sources, il ne porte d'interactions propres. En revanche si la source appartenait à un groupe, le nouvel objet disposera des mêmes interactions de groupe que son modèle (voir § interactions de groupes).


SUPPRIMER UN CLONE

supprimer:id_objet
ou
delete:id_objet

Seul un objet cloné peut être supprimé. Il disparait alors visuellement de son lieu, les ressources mémoire qu'il utilise sont libérées, et il sort de la sauvegarde. Important pour optimiser les ressources système de votre jeu dans le cas ou vous faites des clonages massifs !


VERROUILLER / DEVERROUILLER UN CHOIX DE DIALOGUE

lock:id_interaction:1 // va verrouiller l'étape de dialogue d'ID <id interaction>
lock:id_interaction:0 // va déverrouiller l'étape de dialogue d'ID <id interaction>

Utilisez cet effet pour masquer ou afficher un choix dans un dialogue interactif, en verrouillant ou déverrouillant l'interaction (par son #id)  correspondant à la cible du choix.  Un choix de dialogue ne sera proposé que si l'interaction cible est déverrouillée. Cela permet de contrôler très finement le déroulement des dialogues interactifs. Vous pouvez aussi définir la disponibilité initiale et la répétabilité d'une étape de dialogue en réglant le paramètre "répétable" sur chacune de vos étapes de dialogue (voir § interactions > dialogues interactifs) 


PARTAGER SUR UN RESEAU SOCIAL

share:code réseau social (:continuer (:message personnalisé) )
ou
partager:code réseau social (:continuer (:message personnalisé) )

Cet effet permet d'afficher le "sharer" (outil de partage)  pour que vos joueurs puissent, depuis voter interface, diffuser votre jeu sur les principaux réseaux sociaux ou par email, et ainsi mieux le faire connaître. L'interface standard de JAWA présente des icônes de partage sous les panneaux d'options/indices./récompenses... mais cet effet permet de créer vos propre s boutons de partages sociaux. Pour des raisons techniques, l'outil de partage s'ouvre nécessairement dans un nouvel onglet.

Le premier paramètre définit le réseau social sur lequel diffuser (d'autres réseau seront progressivement ajoutés): code réseau social 

coderéseau social
tttwitter
fbfacebook
lilinkedIn
mailpartage par email

Le second paramètre "continuer" (facultatif) permet de forcer l'interface à passer à l'effet suivant de l'interaction, si il vaut "1" (par défaut à "0", le jeu est mis en pause car le joueur a été basculé sur un nouvel onglet).

Le dernier par paramètre "message personnalisé" (facultatif) permet de définir le texte d'accroche du post, pour les réseaux le permettant. Par défaut le résumé court du jeu et son titre seront utilisés.


SAUVEGARDER / RESTAURER LA PARTIE (jeux en mode standalone)

sauverPartie
 ou 
saveGame

Cet effet permet de forcer une sauvegarde de la partie dans une interaction sur un jeu joué en version standalone (exporté/déconnecté du serveur JAWA). Il n'a pas d'intérêt si le jeu est paramétré en sauvegarde continue, c'est à dire à chaque interaction (cf §paramètres du jeu > réglages) en revanche il peut être utile dans un jeu ou la sauvegarde est paramétrée lors des changements de lieu uniquement, typiquement si au sein d'un lieu/tableau (puzzle), le joueur a beaucoup d'actions à faire afin qu'il n'ait pas à tout refaire, ou dans les jeux mono-scène.

Vous pouvez aussi lancer une restauration de la partie, basée sur la sauvegarde locale qu'elle soit manuelle ou automatique  (voir § paramétres du jeu > mode de sauvegarde), via un effet. Typiquement : le joueur est mort ou a perdu, il est redirigé vers une scène "game over", et sur cette scène vous intégrez un bouton "RECHARGER MA PARTIE". Vous pouvez également forcer le chargement d'un savepoint prédéfini intégré au jeu en précisant en paramètre son nom, par exemple pour atteindre directement un chapitre du jeu. Attention, ceci effacera la partie et la progression locale du joueur. (voir § cycle de vie / sauvegarde des parties)

restaurerPartie (:savepoint)
 ou 
restoreGame (:savepoint)


EXECUTER DU JAVASCRIPT

execJS:instructions JS

Pour développeurs chevronnés uniquement ! Permet d'appeler pendant une interaction une fonction JS issu de la librairie JS custom du jeu (notamment appel de fonctions). 

EXECUTER DU CSS

css:déclarations CSS

Cet effet permet, au moment ou il est joué, d'impacter la feuille de style CSS du jeu (requiert une compétence dans le langage CSS) de manière à créer un effet visuel très poussé sur un objet, un décor, un élément d'interface (au delà de ce que permettent les effets standard `modifier / changerParam` ou `changerDecor`). Par exemple l'effet:

css:#jeu_lieu_XXXX {animation:_mvt_wobble-vertical .5s ease-in-out 3}
va `secouer` le décor n° XXXX pour accompagner par exemple une explosion.
NB : Si votre classe CSS comprend plusieurs attributs de style, vous devez les séparer non pas par le caractère `;` habituel du css mais par des slashs `/` : exemple :
      css:#mon_objet {color:red/padding:8px}


CONTRÔLER FINEMENT L'AFFICHAGE DES ICÔNES D'INTERFACE

interface:nom_icône:0(désactivé) ou 1(activé)

L'éditeur de lieux permet pour chaque scène de définir si les boutons d'interface sont disponibles ou non (paramètre `contrôles`) : inventaire, carte (si dispo), progression (si dispo) mais dans certains cas vous pourriez avoir besoin de gérer plus finement la disponibilité de ces boutons, et indépendamment pour chaque bouton (par exemple, en cacher un entre 2 actions du joueur), ce que vous permet cet effet.

nom de l'icône description
inventaire
inventory
affiche ou cache l'icône d'inventaire et donc commande l'accès aux objets de l'inventaire.
map
carte
affiche ou non l'icône carte (si dispo dans le jeu)
progression affiche ou non l'icône progression (si dispo dans le jeu)
scroll affiche ou non les boutons de scrolling latéral dans les lieux panoramiques(et donc commande si le joueur peut manuellement décaler la vue)

masque
mask

affiche ou non le masque d'interface personnalisé (voir § masque d'interface) 
autosavedésactive (0) ou réactive (1) la sauvegarde automatique (dans le régime défini dans les paramètres du jeu)
infoaffiche ou non la barre d'info supérieure


exemple : l'effet

interface:inventaire:0

va cacher l'inventaire jusqu'à ce qu'une autre interaction contienne un effet " interface:inventaire:1 "


AFFICHER UN PLUGIN (complément)

plugin:url du lanceur (:fermable 0/1 (:largeur:hauteur))
  ou 
complement:url du lanceur (:fermable 0/1 (:largeur:hauteur))


Uniquement pour les jeux disposant d'une licence.

Depuis JAWA 31, il est possible d'intégrer et stocker à l'intérieur d'un eu des contenus crées avec d'autres outils du web ou développés à façon et exportés sous format web, comme des quizz, une carte, un visualiseur 3D...(voir § les compléments)

Une fois les fichiers du plugin déployés dans les compléments, l'effet plugin permet d'afficher en surimpression le module par dessus la partie en cours, avec les paramètres suivants :

 ▸ url du lanceur : lien vers le fichier (en théorie html) qui lance le module
 ▸ fermable (0=non, 1=oui): (défaut oui) affiche un bouton en surimpression du plugin permettant au joueur de refermer lui même me plugin ce qui entraîne l'exécution de l'effet suivant de l'interaction. Si le plugin n'est pas fermable via l'interface JAWA, c'est le code de celui-ci qui devra le fermer et permettre de reprendre le déroulement de l'interaction)
 ▸ largeur et hauteur : dimensions du module (qui se centrera par rapport à l'écran), par défaut 90% de l'espace disponible.

Note : Une API javascript est également à la disposition des développeurs pour permettre à leur module d'interagir avec la partie (manipulation des variables de jeu, déclenchement d'interactions...) => voir § ressources > les compléments > API d'interconnexion d'un plugin à la partie

INTERROMPRE OU RELANCER UN COMPORTEMENT

comportement:id_objet:0/1
   ou
behavior:id_objet:0/1
Cet effet permet de contrôler l'exécution(2nd paramètre à 1) ou l'arrêt (second paramètre à 0) des comportements autonomes de l'objet <id_objet> via les interactions.(voir § comportements autonomes)
Si l'id d'objet fourni vaut 0, l'effet s'appliquera à tous les objets (dotés de comportement) dans la scène en cours.

CHARGER UN LIEU/UNE SCÈNE

loadscene:id_scene_à_charger (:arrière/avant plan 0/1)
Pour les jeux volumineux utilisant un mode de chargement partiel, vous pouvez forcer le chargement d'un lieu/puzzle à venir dans une interaction (typiquement une interaction avec une cinématique ou des dialogues), et ce en avant plan (le masque de chargement apparaîtra au lancement de l'effet jusqu'à chargement complet de la scène, interrompant le jeu mais garantissant que tout sera chargé quand la main sera rendue au joueur) ou en arrière plan (par défaut : pas d'interruption de l'interaction en cours).

APPELER UN SCRIPT DISTANT

call:url du script ( ->variable_reponse)
Pour des besoins très particuliers, vous pourriez avoir besoin d'appeler un script spécifique crée à façon sur un serveur distant. Cette effet permet de le déclencher (exécution en arrière plan) depuis une interaction. L'url doit être un chemin absolu et peut éventuellement embarquer des paramètres d'URI. Attention à vous assurer que cette requête ne sera pas bloquée par des sécurités navigateurs de type cross-domaine (ou https appelé depuis http).
JAWA transmettra en outre les paramètres suivants au script distant :
  • idp : id de la partie en cours
  • playerID : id du compte joueur (si disponible)
  • ida : id du jeu

Depuis JAWA 38, vous pouvez récupérer la réponse du script distant dans une de vos variables de jeu en ajoutant derrière l'adresse du script le suffixe " ->NOM_VARIABLE ". Dans ce cas, l'interface de jeu JAWA restera figée en attente de la réponse du script (appel synchrone), assurez vous donc que le script distant réponde vite.  Ceci permet donc de modifier le contexte de la partie suivant un mécanisme extérieur au jeu. voir aussi l'api JAWA.

ex :

call:https://mon-site.com/monscript.php?param=bidule->MACHIN


INTERROMPRE LA MARCHE DE L'AVATAR

stopwalk
Pour les jeux à la 3ème personne uniquement : depuis JAWA 32, les interactions de type "marcher sur" n'interrompent plus la marche de l'avatar, ce qui permet de déclencher des effets de manière fluide, par exemple lorsque le joueur marche dur une dalle ouvrant une porte.
Néanmoins, si vous souhaitez que ce déclencheur arrête le joueur, insérez simplement cet effet "stopwalk" dans l'interaction déclenchée par la combinaison de l'avatar avec l'objet ou la zone concernée.

AFFICHER UN MESSAGE D'INFORMATION
info:texte d'information
Affiche pendant 3 secondes, sans interrompre le jeu, un court texte d'information de votre choix dans l'infobarre supérieure de l'interface.Le message sera invisible si vous désactivez tous les contrôles ou cachez l'infobarre via votre feuille de style CSS.

AFFICHER / LOGUER UN TRACE D'EXÉCUTION 
trace:texte de debuguage
A des fins de test et debug, si vous avez un système complexe d'interactions ou de scripts qui ne donne pas le résultat escompté, vous pouvez insérer dans vos interactions un message de trace d'exécution à façon, qui apparaîtra uniquement dans le debugger du mode test. Celle-ci peut contenir des {{variables}}. Ainsi vous pourrez mieux suivre et analyser la chaîne d'interaction et les données reçues lors de leur exécution. Plus d'infos dans le § tester et debugger mon jeu.

INTERROMPRE UNE INTERACTION

stop
Met fin à l'interaction, les effets suivants ne seront pas exécutés. Si l'interaction faisait partie d'une chaîne, on retourne à l'exécution de l'interaction parente. En théorie, cet effet n'a d'intérêt que dans une condition embarquée (voir § conditions)

FAIRE UNE CAPTURE D'ÉCRAN  

capture (:1 = partage)

ou screenshot (:1)
Depuis JAWA36. Fait une capture d'écran (peut être sympa par exemple pour permettre à vos joueurs de partager leurs scores ou autre), en retirant le éléments d'interface (boutons, inventaire...). Attention certains effets graphiques sur les objets (luminosité, flou, mouvement) ne sont actuellement pas pris en compte ce qui peut entraîner un résultat hasardeux ! Le résultat de la capture est automatiquement téléchargé sur l'appareil du joueur.
En ajoutant le paramètre optionnel 1, la capture générée devient partageable sur les réseaux sociaux, un bon moyen de créer de l'engagement autour de vos jeux !

ENCLENCHER LE MODE DEBUG PAS A PAS 

interrupt
A des fins de test et debug, si vous avez un système complexe d'interactions ou de scripts qui ne donne pas le résultat escompté, vous pouvez insérer cet effet  à un point précis de votre interaction pour enclencher le mode pas à pas et ainsi suivre effet par effet la suite de l'interaction. Plus d'infos sur le mode pas à pas dans le § tester / debugger mon jeu.

VERIFIER / DECLENCHER LES INTERACTIONS "MARCHER SUR..."
triggerwalk

Cet effet permet de forcer la vérification des interactions de type "marcher sur.." (combinaison de la position de l'avatar avec une zone ou élément de décor, type marcher sur une dalle). A quoi ça sert ? bonne question !


RELANCER LE JEU
restart

Cet effet permet de relancer entièrement le jeu (après confirmation), c'est à dire recharger la page. Toute progression non enregistrée sera perdue !


AFFICHER LE SCANNER DE QR-CODES

scanQR(:texte d'information)
Cet effet affichera le lecteur de QRcodes permettant au joueur de déclencher une interaction de script via un QR code scanné en présentiel ou sur un support virtuel. Requiert une caméra et l'autorisation d'y accéder. Détails dans § les interactions > les déclencheurs > Déclencher un script par un QRcode


METTRE A JOUR LES ANALYTICS
trackGame

Si votre contenu est connecté à un tracker d'analytics (statistiques d'utilisation avancées du jeu, pour les jeux sous licence), vous pouvez forcer la mise à jour des métriques de al partie en cours dans une interaction avec cet effet. Par défaut les analytics sont mis à jour à chaque changement de scène ou gain de progression. NB : ceci génère à chaque appel une requête vers le serveur de game-Analytics.



(multijoueur) DECLENCHER UN SCRIPT CHEZ UN AUTRE JOUEUR

multijoueur:joueur(s)_cible:id_script
ou
multiplayer:joueur(s)_cible:id_script
Cet effet est spécifique aux jeux multijoueurs. Il permet de déclencher un même script ou actionner un objet chez un ou plusieurs joueurs de la partie.
Indépendamment de la synchronisation automatique des effets persistants entre les joueurs qui n’interrompent pas les autres parties, cela permet de générer suite à action d'un joueur un feedback chez les autres joueurs de la partie, qui peut si besoin interrompre leur partie (afficher un message).
Le paramètre joueur(s) cible peut prendre l'une des valeurs suivantes
- entier > 0 :  n° du joueur/rôle particulier suivant les rôles définis
- 0 : tous les autres joueurs de la partie
- * : tous les joueurs
NB : Le script cible (ou objet) doit être chargé chez tous, il vaut mieux l'intégrer au tronc commun du jeu

Plus d'informations pour tout comprendre  dans la page "jeux multijoueurs".



↥