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:...
Quand plusieurs interactions portent les mêmes effets, vous pouvez utiliser l'effet copiereffets pour accélérer votre travail (voir ci-après).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.
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érique | interprétation |
| 0 | pour 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 |
| 1 | correspond à 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 |
| 2 | correspond à l'objet combiné dans la 1ère interaction de la chaîne, le cas échéant (déclencheur "utiliser sur") |
| 3 | correspond à 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. |
| 4 | correspond à 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)
|
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 | 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.
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:0dé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'effet | description | rô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. |
| distorsion | déforme le décor de manière un peu "écurante", comme si le joueur était malade ou sous l'effet d'une drogue | durée de la séquence en secondes (plus elle est élevée, plus le fx sera lent) |
| flash | fondu 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) |
| neon | clignotement 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. |
| oculus | affiche de sbords arrondis et mouvants autour du décor, comme si on le voyait à travers une boule de cristal | nombre de séquences à répéter, une séquence d'oculus durant 5 secondes |
| _customfx_XXX | utilisation 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:finBien 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_sourceDepuis 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_objetSeul 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
| code | réseau social |
| tt | |
| fb | |
| li | |
| partage 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 JSPour 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 CSSCet 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 | affiche ou non le masque d'interface personnalisé (voir § masque d'interface) |
| autosave | désactive (0) ou réactive (1) la sauvegarde automatique (dans le régime défini dans les paramètres du jeu) |
| info | affiche ou non la barre d'info supérieure |
exemple : l'effet
interface:inventaire:0va 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/1Cet 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)
APPELER UN SCRIPT DISTANT
call:url du script ( ->variable_reponse)
- 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
info:texte d'information
trace:texte de debuguage
INTERROMPRE UNE INTERACTION
stop
capture (:1 = partage)
ou screenshot (:1)
ENCLENCHER LE MODE DEBUG PAS A PAS
interrupt
triggerwalkCet 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 !
restartCet 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)
trackGameSi 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_scriptCet 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.
ou
multiplayer:joueur(s)_cible:id_script
v40
