La création d'un jeu requiert un effort de test d'autant plus conséquent que votre jeu est délinéarisé. Gardez en tête que le degré de liberté offert au joueur va lui permettre d'avancer d'une manière différente de celle que vous aviez prévu. Tester un jeu requerra forcément de faire de nombreux passages, imaginer tous les scénarii de résolution, bref cela prend du temps (on dit souvent autant de temps pour tester que pour créer) mais c'est une étape indispensable pour la qualité de votre création. Heureusement il existe de nombreux outils et technique pour accélérer les tests et les corrections.
Mode test et debugger
JAWA propose un mode de jeu "test" vous permettant d'évaluer et de vérifier votre jeu à n'importe quel moment de son développement. Il est accessible de deux façons.
▸ Dans scenarioStudio, en cliquant sur Tester le jeu en bas de la palette. Vous jouez exactement comme le feront vos futurs joueurs, mais la progression dans le scénario n'est pas sauvegardée. Vous pouvez ouvrir le mode test dans un nouvel onglet plutôt que dans une fenêtre de scenarioStudio, ce qui peut être très appréciable si vous disposez de 2 écrans (1 écran pour créer le jeu, 1 écran pour le tester en parallèle).
▸ Dans le portail JAWA, dans votre espace, en cliquant sur le titre du jeu dans Mes jeux en cours de création.
Dans les deux cas, vous avez accès au panneau du debugger offrant de nombreuses fonctionnalités de test et correction rapides :
Actualisation/redémarrage de la partie
Le debugger permet d'actualiser l'interface en cas de modification ou de relancer le jeu depuis le début (ou le lieu défini comme point de départ), Toute modification de votre jeu ne sera disponible dans votre partie test qu'après une relance, mais :
- La relance de l'interface de jeu entraîne l'actualisation des interactions, donc vous n'avez pas forcément besoin de recommencer la partie depuis le début pour vérifier si votre changement résout le problème.
- Une modification d'asset (image d'un objet ou d'un décor, son, vidéo..) sera également disponible avec un simple actualisation de l'interface.
- En revanche toutes les modifications de données (nom, position initiale, taille, effets...) requerrons un redémarrage de la partie, puisque votre sauvegarde embarque l'intégralité des données de jeu.
Notez qu'en cas de redémarrage du jeu, vous pouvez à tout moment changer la scène de démarrage du jeu pour commencer immédiatement sur le lieu/le puzzle que vous êtes en train de créer.
Vous pouvez également utiliser le raccourci de changement de scène (voir ci-après)
Utiliser les sauvegardes prédéfinies et la persistance serveur
Si vous chargez votre jeu dans un des 2 modes complet (avec ou sans ressources), vous disposerez de 2 boutons sauver et charger vous permettant de définir et relancer un point de sauvegarde prédéfinie (savepoints). Ceci peut permettre de se rendre directement à une partie avancée, avec un contexte sans avoir systématiquement a refaire tout le début de votre jeu tout en disposant d'un contexte de donnée réaliste (ce qui n'est pas le cas si vous redémarrez une partie en mode test en choisissant une scène de début qui n'est pas celle prévue). Mais attention aux données contenus dans ces sauvegardes : elles peuvent éventuellement embarquer elles mêmes des bugs ou disposer de données insuffisantes suivant le moment ou vous les avez faites.
En phase de production, il peut être utile à des fins de démo d'intégrer des savepoints pour lancer le jeu directement à certaines étapes clé, ce qui permet de shunter. Ceux ci peuvent également être chargés directement via l'url du jeu (voir ci-après)
Les sauvegardes et restaurations externes (touches S et L) permettent de créer des sauvegardes téléchargées vers ou depuis votre ordinateur. Egalement un bêta-testeur tiers pourrait vous transmettre sa propre sauvegarde permettant de reproduire plus facilement un bug qu'il/elle a rencontré sur votre jeu.
Les savepoints intégrés au jeu et les sauvegardes externes peuvent être optimisés pour réduire leur taille (et temps de chargement) en définissant certains des objets de votre jeu comme invariants : si un objet ne change jamais d'état durant la partie ou que son changement d'état n'a pas d'impact sur le jeu (i.e, qu'il peut être remis dans son état de départ a chaque fois qu'on reprend sa partie sans conséquences), autant ne pas l'intégrer à la sauvegarde : pour cela, dans les propriétés avancées de l'objet, il faut le déclarer invariant. Depuis le vérificateur de gamescript, JAWA peut faire une première analyse du gamescript pour détecter les objets qui ne varient pas (vérifier le jeu > optim save > nouvelle analyse). Il convient de vérifier la liste des candidats pour confirmer ou infirmer ceux qui peuvent être retirés du shéma de sauvegarde sans risque pour l'intégrité de la partie.
Synchronisation serveur
Par défaut votre partie est synchronisée sur le serveur JAWA. Ceci permet de la reprendre au point ou vous étiez (avec d'éventuelles corrections) en actualisant l'interface du mode test. Cependant il peut être utile parfois d'interrompre cette persistance serveur pour tester une séquence de jeu, faire les corrections/adaptations nécessaires, puis reprendre la séquence au moment ou vous avez interrompu la persistance. Pour cela décochez "mise à jour serveur synchrone" sous la liste de variables.
Plus d'informations sur la gestion des sauvegardes dans le chapitre § sauvegarde des parties.
Contrôle des variables de jeu
Les variables régissent en grande partie le fonctionnement et l'avancement du jeu.
La liste des variables de jeu est affichée avec leur valeur en temps réel (côté navigateur et côté serveur), c'est à dire qu'elles se mettront à jour au fil de leurs modifications par vos interactions, y compris les variables étapes de dialogues interactifs. Vous pouvez forcer une nouvelle valeur pour accélérer une étape du jeu.
Pour un gros jeu comportant de nombreuses variables, vous pouvez les filtrer en tapant quelque lettres de leur noms (vous pouvez filtrer la liste sur plusieurs expressions en les séparant par des ",")
Cliquez sur le bouton Actualiser les variables pour réafficher les valeurs serveur et vérifier une éventuelle désynchronisation avec votre navigateur.
Inspecter et modifier les ressources
Depuis JAWA 37, un onglet "ressources" permet de sélectionner une ressource (objet, personnage...) soir dans une liste soit en cliquant dessus dans l'interface de jeu pour en afficher les principales caractéristiques (nom, position, taille, variables custom...) à un instant T, caractéristiques qui peuvent également être directement modifiées depuis cette interface pour tester une modification à chaud de l'objet et ainsi adapter ses réglages initiaux ou interactions dans scenario studio.
Mode pas à pas / points d'arrêts
Cochez la cas "exécution des effets pas à pas" pour actionner le mode de debuggage pas à pas : celui-ci mettra en "pause" le jeu entre chaque effet, avant qu'il soit joué. Si vous avez une interaction complexe avec de nombreux effets, notamment des animations temporisées, qui ne se déroule pas comme prévu, ce mode vous aidera à décomposer l'interaction et repérer un problème.
Dans le mode pas à pas, le debugger affichera le prochain effet joué et ses paramètres, l'id de l'objet et de l'interaction associés (avec un lien d'édition direct de ladite interaction vous permettant de la modifier presque "à chaud", ce qui fait gagner beaucoup de temps)
Ce mode "radical" insère une pause entre les effets de chaque interaction, ce qui peut être lourd. vous pouvez également cibler les interactions à décortiquer en positionnant des points d'arrêts sur des interactions particulières. pour cela cliquez sur l'icône "panneau stop" et entrez l'id ou les ids des interactions points d'arrêt (séparées par des ",").
NB : vous pouvez insérer l'effet "interrupt" dans n'importe quelle interaction pour enclencher le mode pas à pas à une étape donnée d'une interaction donnée et faire défiler les effets suivants un à un (voir § les interactions > les effets > effets avancés).
Traces d'exécution
Depuis JAWA 33, le debugger du mode test met à disposition une trace d'exécution (bouton "trace"). Par défaut, seules les traces que vous avez manuellement ajoutées à vos interactions (voir ci après) seront loguées mais vous pouvez aussi activer une trace "système" automatique (cocher la case "messages système") qui rendra compte de chaque objet actionné et des interactions déclenchées en conséquence.
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.
trace:texte d'information
Raccourcis de "triche"
Le debugger vous offre enfin la possibilité de «tricher» par rapport à vos futurs joueurs en ayant recours à des raccourcis.
- obtenir / retirer un objet d'inventaire, (ou ajouter une quantité d'objet cumulable)
- se déplacer vers un lieu/scène/puzzle donné
- actionner directement un objet ou un script, par son id, sous réserve qu'il soit disponible dans la portion du jeu actuellement chargée
- lancer directement une interaction par son ID, sous réserve qu'elle soit disponible dans la portion du jeu actuellement chargée
Si votre jeu en mode test reste bloqué sur l'écran de chargement, vérifiez son gamescript : les erreurs remontées expliquent souvent l'interruption du chargement. S'il n'y a pas d'erreur, il s'agit peut-être d'un bug ou d'un problème ponctuel : n'hésitez pas à poster une fice de bug (bien documentée) dans la communauté.
Vérification du gamescript
Vous pouvez à tout moment vérifier la jouabilité de votre scénario en cliquant en haut de la palette sur vérifier le gamescript. Quand vous cliquez sur le bouton Lancer l'analyse, JAWA scrute l'ensemble du jeu et en détecte les éventuelles anomalies : illogismes, erreurs de syntaxe, conditions non remplies, ressources absentes, interactions orphelines...Un mode approfondi (beaucoup plus lent) permettra de révéler d'avantage d'erreurs.
Cela vous permet aussi de détecter des cas de figures auxquels vous n'aviez pas pensé (n'oubliez pas que les joueurs sont imprévisibles !). Par défaut le vérificateur va afficher uniquement les erreurs `fatales` mais vous disposez également d'un mode de f=vérification approfondie (cocher la case) qui va tester d'avantage de choses et remonter des avertissements (notamment les conditions sur variables hors champ de valeurs, et les conflits d'interactions (voir § interactions / conditions)).
Travailler avec un scénario brouillon et les transferts
Vous pouvez créer gratuitement autant de jeux que vous voulez sur JAWA, profitez-en !
Pour tester des mises en scène ou des interactions, il est pratique de créer un deuxième jeu qui vous servira uniquement de brouillon. La fonction Transférer vers un autre scénario permet de transférer un lieu et ses interactions, ainsi que les objets qu'il contient et leurs interactions (également disponible sur les scripts).
Les éléments transférés gardent les mêmes ID donc les interactions restent fonctionnelles telles quelles (sauf si elles référencent des ids d'objets ou de sons non transférés) . Cette fonction est accessible dans la fenêtre d'édition du lieu concerné, en cliquant sur la petite flèche située sous le coin inférieur droit de la scène.
Utilisez cette fonction avec prudence.
- N'effectuez des transferts qu'entre votre brouillon et votre scénario principal, et uniquement quand ce dernier a le statut «en fabrication» ou «en maintenance». En effet, le transfert risque de rendre les parties en cours injouables, tout au moins dans le jeu-source.
- Assurez-vous que les variables et éléments associés aux interactions ont bien été transférés dans le jeu-cible. Prenez le réflexe de vérifier le gamescript (voir ci-dessus).
- les variables nécessaires aux interactions sont à recréer dans le jeu cible, de même que les éventuelles ressources média (sons, vidéos) utilisées.
Faire tester le jeu par des tiers
Dorénavant, vous pouvez faire tester par une tierce personne votre jeu en cours de fabrication ou en maintenance, c'est-à-dire indépendamment de sa publication dans ou hors du portail JAWA. Pour ce faire, indiquez l'ID du compte JAWA du testeur dans paramètres du scénario/réglages/ID du compte testeur. (L'ID du compte est affichée sur le portail à la rubrique Mes infos.) Quand le testeur se connecte à son compte, il voit dans son espace un accès au jeu à tester et peut y jouer. Il dispose du debugger (voir ci-dessus), mais ne peut pas en revanche accéder au scenarioStudio du jeu.Paramètres définis via l'url de lancement
L'adresse de base d'un jeu peut être complétée par des paramètres d'URL html pour modifier certains réglages de base.
Les points suivants s'adressent aux experts et ne servent qu'en de rares occasions, ils peuvent permettre d'effectuer du deboguage plus rapidement.
NB : Les paramètres d'URL suivants peuvent tous être combinés.
Initialiser des variables via l'url de lancement du jeu
Par défaut le jeu se lance en provisionnant les variables avec leurs valeurs par défaut ou, le cas échéant, avec les valeurs issues de la sauvegarde. Il est possible de forcer dynamiquement une autre valeur dans une ou plusieurs variables en ajoutant dans la barre d'adresse le paramètre&var_nom_variable=valeurCeci peut être utile par exemple si votre jeu doit être proposé suivant différents `modes de jeu` ou pour pouvoir commencer l'aventure à différentes étapes, mais sans passer par un écran de menu.
exemple :
/chemin/du/jeu/index.html?var_TRUC=MACHIN
Va lancer la partie en forçant la valeur "machin" pour la variable "truc" au lieu de sa valeur par défaut.
Charger un point de sauvegarde prédéfini
Si vous avez incorporé des points de sauvegardes prédéfinis à votre jeu (voir § sauvegardes du jeu), vous pouvez les charger directement au lancement du jeu, ce qui peut être utile pour lancer le jeu à une étape (dans un contexte) donnée.
/chemin/du/jeu/index.html?savepoint=nom_du_savepoint
Désactiver la validation des conditions côté serveur
Pour assurer la persistance serveur des parties, le moteur JAWA rejoue la chaîne des interactions déclenchées dans le navigateur en vérifiant si les conditions sont bien remplies (pour éviter toute désynchronisation). Ceci peut être embêtant pour certains besoins de test très avancés, aussi il est possible de désactiver cette vérification de 2 manières :
- depuis les paramètres du jeu > interface> désactiver la vérification des conditions côté serveur
- appeler le jeu (fenêtre du mode test) en ajoutant le paramètre d'url "nocheck" dans la barre d'adresse :
/chemin/du/jeu/index.html?nocheck
Forcer la langue du jeu
Si votre jeu est multlingue (voir § jeux multilingues), vous pouvez forcer la langue via son url de lancement avec le paramètre &lang=<code de la langue>
/chemin/du/jeu/index.html?lang=en
Forcer le mode de sauvegarde du jeu
Il est possible pour une session de test de désactiver ou modifier le mode (fréquence) de sauvegarde automatique d'un standalone (en mode connecté, la sauvegarde est continue).
/chemin/du/jeu/index.html?lang=code du mode
- N : désactivée et bloquée
- M : désactivée mais autorisée manuellement
- C : continue (a chaque interaction modifiant le contexte de données)
- L : à chaque changement de lieu
- G : à chaque gain de progression
- P : à chaque gain de progression et changement de lieu
v40
