quest'n'click 4.5.0 · r1

Construite pour quest'n'click 4.5.0, révision r1. Si elle est publiée, et laquelle est la courante, est dit par publication.json.

Héros : plusieurs personnages et choix du héros

English · Type : tutoriel + référence + explication · Public : auteur · Contexte : dépôt du moteur, projet créé · Statut : prête · S'applique depuis : 4.4.0

Un jeu peut avoir plus d’un héros, de deux façons différentes. Choisir le héros (4.3.0) : à la Nouvelle partie, le joueur choisit qui est le héros (un chevalier, une sorcière ou un robot ; un garçon ou une fille), et tout le jeu suit ce choix. Plusieurs personnages jouables (à la Day of the Tentacle) : le joueur passe d’un personnage à l’autre, chacun dans son propre lieu. Cette page déroule le premier avec le jeu d’exemple, puis donne la référence des deux et dit quand choisir l’un ou l’autre.

Ce que vous allez construire

Un jeu dont l’écran de Nouvelle partie demande « Qui suis-je ce matin ? » et montre une carte à portrait par héros. Une fois le héros choisi, le personnage à l’écran a son allure et son nom, les répliques des autres emploient ce nom ({hero}) et les mots qui lui conviennent ({form?…}), dans chaque langue, avec des voix enregistrées par héros. Une sauvegarde garde le héros.

L’exemple terminé est dans le dépôt du moteur : games/heroes, « Qui suis-je aujourd’hui ? » (4.4.0). Un jardin, une énigme (la clé du portail sous l’arrosoir), trois héros sur des cartes à portrait (Pixel, Biscuit, Gaby la mouette), {hero} et des aiguillages dans les répliques de Grand-mère, une table française qui ajoute ses propres accords (Prêt{form?gull=e|*=}), les répliques de Grand-mère doublées par héros dans les deux langues, une règle que seule la mouette reçoit, et une sauvegarde qui garde le héros.

Ce qu’il vous faut

Étapes

  1. Jouer l’exemple. Dans le dépôt du moteur, sur votre machine :

    # dans le dépôt du moteur
GAME=heroes npm run dev

    Ouvrez l’URL affichée, appuyez sur Nouvelle partie : trois cartes, « Pixel », « Biscuit » et « Gaby ». Choisissez-en une ; Grand-mère salue ce héros par son nom.

  1. Un personnage, une variante par héros. Choisissez un nom de drapeau pour le héros (form ici ; n’importe quel nom convient). Écrivez un personnage dont l’allure écrite est celle d’un des héros, et une variante par autre héros, chacune lue sur le drapeau et chacune avec son name, ses sprites et son portrait (le premier bloc de la référence). Le hero du jeu est ce personnage.
  1. L’intro pose le drapeau. Dans start.intro, un choice avec une option par héros, chacune avec img (son portrait) et { set: ['form', '<valeur>'] }. L’intro se joue avant l’arrivée dans le premier lieu : le héros est choisi avant que quiconque parle. Rechargez : l’écran de Nouvelle partie montre les cartes.
  1. Les mots des autres suivent le héros. Dans les répliques, {hero} est le nom du héros, et {form?knight=him|witch=her|*=it} choisit les mots selon la valeur du drapeau (le second bloc de la référence). Parlez au personnage : la réplique se lit pour ce héros.

  1. Vérifier chaque héros. npm run solve s’arrête au premier chemin gagnant, et un seul héros peut y suffire. Prouvez-les tous :

    # dans le dépôt du moteur
GAME=heroes npm run solve -- --prove

    # dans un projet créé
npx quest-n-click solve --prove

    La preuve vérifie chaque état atteignable, donc chaque héros, et signale comme softlock un héros qui ne peut plus finir.

  1. Traduire et doubler. Une traduction écrit ses propres mots entre les accolades, avec le même drapeau et les mêmes valeurs ; les voix s’enregistrent une fois par valeur. Voir Traductions et Voix plus bas.

Limite · heroes-tutorial-scope Ce parcours ne couvre pas les images des héros (leurs planches et portraits) : voir Images. Les clips de voix de l’exemple sont provisoires (un babillage par héros, déclaré dans games/heroes/provenance.json).

Référence : laisser le joueur choisir le héros

fonction apparue en 4.3.0

Le joueur choisit le héros à la Nouvelle partie : un chevalier, une sorcière ou un robot, un garçon ou une fille, autant de héros que le jeu en déclare. Le héros garde les mêmes énigmes et les mêmes lieux ; ce qui change, c’est son allure, son nom, et les mots que les autres emploient pour lui. Il faut un drapeau (form ici, n’importe quel nom convient), un personnage avec une variante par héros, un choix d’intro qui pose le drapeau, et des aiguillages dans les textes qui en dépendent.

Où lancer les commandes : cette page les écrit pour le dépôt du moteur (npm run validate, npm run solve, précédées de GAME=<id> pour un autre jeu que celui par défaut). Dans un projet créé, les mêmes outils sont npx quest-n-click validate, npx quest-n-click solve (--prove, --chapters), npx quest-n-click lint, npx quest-n-click i18n status et npx quest-n-click voices, et les sources sont dans game/ au lieu de games/<id>/.

hero: 'kid',
characters: {
  kid: {
    name: 'Robo', sprites: cat('robot'), portrait: 'robot/portrait',          // l'allure écrite est aussi un héros
    variants: [
      { if: { flag: 'form', eq: 'knight' }, name: 'Sire Lancelot', sprites: cat('knight'), portrait: 'knight/portrait' },
      { if: { flag: 'form', eq: 'witch' }, name: 'Morwen', sprites: cat('witch'), portrait: 'witch/portrait' },
    ],
  },
},
start: { room: 'hall', intro: [
  'Qui suis-je ce matin ?',
  { choice: [
    { text: 'Sire Lancelot', img: 'knight/portrait', do: [{ set: ['form', 'knight'] }] },
    { text: 'Morwen', img: 'witch/portrait', do: [{ set: ['form', 'witch'] }] },
    { text: 'Robo', img: 'robot/portrait', do: [{ set: ['form', 'robot'] }] },
  ] },
] },
checkpoints: {
  porte_sorciere: { room: 'hall', inventory: ['key'], flags: { form: 'witch', key_found: true } },
},

Et dans un lieu :

talk: { grandma: [{ topic: 'Bonjour, Grand-mère !', do: [
  { say: ['grandma', 'Bonjour, {hero} ! Prêt{form?witch=e|*=}, {form?knight=mon brave chevalier|witch=ma sorcière futée|*=mon robot qui brille} ?'] },
] }] },
look: { grandma: 'Grand-mère. La poussière {form?knight=le|witch=la|robot=le} fait éternuer.' },

Garantie · hero-choice-save-keeps-hero · référencée · exécutée sur aff6caab7514 · portée vérifiée par son auteur (IA), pas relue Une sauvegarde garde le héros : le drapeau qui l’a choisi est dans l’état sauvegardé, si bien qu’une partie chargée dans un nouveau moteur montre le même héros, avec son nom. Limite : le test charge une sauvegarde de la fixture des héros (tests/fixtures/heroes.ts) dans la même version du moteur ; ce que devient une sauvegarde après une mise à jour du moteur est dans État et sauvegardes.

Traductions

Les traductions écrivent leurs propres mots entre les accolades, avec le même drapeau et les mêmes valeurs (l’aiguillage est rempli après la traduction) : room:hall/look.grandma → Grand-mère. La poussière {form?knight=le|witch=la|robot=le} fait éternuer.. Une langue peut ajouter un aiguillage dont sa source n’a pas besoin, pour sa grammaire : l’anglais Ready? devient Prêt{form?witch=e|*=} ?. Les noms des variantes se traduisent aussi (char:kid/variants[0].name). npm run i18n -- status liste les traductions qui perdent un choix de la source (un drapeau qu’elles n’aiguillent plus, une valeur ni listée ni couverte par *=) ; un aiguillage ou une valeur ajoutés pour la grammaire sont voulus. Plus : Traductions.

Voix

Une réplique dont les mots suivent un drapeau ({form?m=le|f=la}) s’enregistre une fois par valeur : ses clips vont dans audio.voices sous <id>~<drapeau>=<valeur> (grandma_saw~form=f). Avec plusieurs drapeaux dans une réplique, triez-les par nom et joignez-les par ~ (greet~form=f~mood=calm) ; les valeurs s’écrivent en texte (true, 2). Le moteur joue le clip des drapeaux tels qu’ils sont et se rabat sur l’id seul quand ce clip manque ou qu’un drapeau n’est pas encore posé : un jeu peut sortir avant que tout soit enregistré. voicesByLang prend les mêmes clés. npm run voices (et l’onglet Voices du Studio) liste une ligne par valeur, chacune avec son texte, et npm run validate avertit quand une réplique doublée n’a pas le clip d’une valeur. Les clés ne sont que des clés : les noms de fichiers restent les vôtres. {hero} seul n’est pas un aiguillage : une telle réplique garde un seul clip. Plus : Voix.

Dans le Studio

Ce que disent les outils

Les vérifications de l’exemple : GAME=heroes npm run solve -- --prove le prouve pour chaque héros ; son test navigateur (games/heroes/e2e.mjs) choisit chaque héros en anglais et en français, sauvegarde, recharge, reprend et termine.

Référence : plusieurs personnages jouables

hero: 'bernard',
players: { ids: ['bernard', 'hoagie', 'laverne'], start: { hoagie: { room: 'labo_passe' }, laverne: { room: 'labo_futur' } },
  give: 'Tiens, {nom} : {objet}.' },

Deux classiques écrits ainsi : l’arbre planté dans le passé et le Chron-O-John.

Lequel choisir, et pourquoi

Choisir le héros, c’est un personnage avec des variantes, pas players. Chaque personnage jouable a son bouton dans la rangée d’outils et se tient dans son propre lieu : le joueur pourrait changer de héros en cours de partie. C’est juste pour une équipe (les trois ados de Day of the Tentacle dans trois époques), faux pour « qui suis-je ». Le choix du héros change l’allure, le nom et les mots, jamais les lieux ni les énigmes ; ce qui doit changer selon le héros s’écrit en logique (un if sur le drapeau), que le solveur et la preuve voient.

Pourquoi un drapeau et des aiguillages, plutôt qu’une copie de chaque réplique par héros. Un aiguillage garde une seule réplique avec un seul id : la traduction, la clé de voix et la matrice du Studio y restent attachées ; une valeur couverte par *= ne demande aucune copie. Le prix : un aiguillage n’est rempli que là où un texte s’affiche au joueur (pas dans les noms, les verbes ni ui), et un drapeau compté avec inc ne se liste pas valeur par valeur.

Limite · hero-choice-not-mid-game Rien dans l’interface du joueur ne change le héros en cours de partie : le choix se fait dans l’intro. Une commande peut reposer le drapeau plus tard, et la variante suit alors, mais aucun écran ne le propose.

La trace de conception : ADR 0022, décision D49 dans docs/dev/DECISIONS.md.

Ce que vous avez appris

Pour aller plus loin

Modifier la source de cette page · Signaler une erreur