Options globales et en-tête du scénario (YAML)

En-tête du scénario

id: mon-scenario
langue: fr
titre: "Mon scénario"
description: |
  Description affichée dans le catalogue et dans le standalone.
categorie: fiction
tags-scenario: [aventure, humour]
markdown: none

id: identifie durablement le scénario. Il devient obligatoire avec les succès ou les variables persistantes ''_p''. Une traduction garde le même ID pour partager sa progression.

langue: vaut fr ou en. Les dossiers officiels scenarios/ et scripts/ déterminent déjà leur langue sans avoir besoin d'ouvrir chaque fichier, mais cette clé est utile pour un scénario importé ou hébergé ailleurs.

categorie: accepte fiction, escape-game, tutoriel, exemple ou divers. tags-scenario: est une liste libre utilisée notamment par les statistiques et les succès globaux.

Ne mettez pas | dans le titre : ce caractère sert de séparateur dans le catalogue.

markdown:

Valeur	Rendu
`fix`	Bloc monospace
`none`	Texte normal avec formatage en ligne
`bold` / `italic` / `quote`	Style global
`story`	Blocs narratifs
`py` / `yaml` / `js` / …	Bloc de code coloré

Style global

taille: 18
police: Georgia
fond: "#111827"
couleur-texte: "#f5f0d8"

Ces valeurs servent de défaut aux textes Web et Desktop. Une salle peut les remplacer.

options: - boutons permanents

options:
  rafraichir: "Rafraîchir"
  inventaire: "Inventaire"
  precedent: "Précédent"
  v_score_v: "Score"
  accueil: "Accueil"
  url1: "https://cyril-fiesta.fr/jdr-bot-wiki/|Wiki"

Clé	Effet
`rafraichir`	Réaffiche la salle courante
`inventaire`	Affiche l'inventaire
`precedent`	Retourne à la salle précédente
`v_nom_v`	Affiche la valeur et la description de la variable
`id_salle`	Donne un accès direct à une salle
`urlN`	Ouvre le lien placé avant le caractère `\|`

Si une clé pointe vers un objet ou un meuble de la salle plutôt que vers une salle, JDR-Bot déclenche automatiquement examiner dessus.

Variables globales

vars: contient les nombres et vars_texte: les textes. Les suffixes _p et _o déterminent leur persistance. vars_online: reste compatible mais n'est plus recommandé. Voir Variables.

ordre_evenements_globaux:

Les événements globaux sont vérifiés après les événements locaux par défaut. Pour les vérifier avant :

ordre_evenements_globaux: avant

Les valeurs acceptées sont avant et apres.

URL directe de lancement

https://jdr-bot.cyril-fiesta.fr/?play=nomscenario
https://jdr-bot.cyril-fiesta.fr/?play=nomscenario&lang=en

Le moteur cherche d'abord un dossier portant ce nom, puis un fichier YAML et enfin un fichier TXT. lang=en choisit le catalogue anglais.

ui: - mode d'interface

ui: choisit cartes, plein-ecran, deck ou phone. La clé fonctionne au niveau du scénario ou d'une salle, comme masquer_saisie:. Voir Modes d'interface.

ui: cartes
masquer_saisie: false

Le mode téléphone ajoute phone_accueil: et phone_forme:. Voir Mode téléphone.

montrer-type:

Pour le glisser-déposer, montrer-type: true distingue les éléments source, cible et mixte. L'option peut être globale ou propre à une salle.

Catalogue et liens de scénario

Les liens publics reprennent le titre et la description du scénario. Si sa description n'est pas renseignée, celle de liste_scenarios.txt sert de repli.

Les tags du catalogue, déclarés dans liste_scenarios.txt, peuvent être libres : ils sont affichés sur les cartes et pris en compte par la recherche. Les tags connus conservent leurs traductions et leurs onglets. Ils sont distincts des tags de salles, qui ajoutent des comportements au scénario.

Écho des commandes (4.17)

echo_commandes: false

L'écho est désactivé par défaut. true affiche les commandes et clics de boutons dans le fil du jeu. Une salle peut remplacer le réglage global.

Les listes raccourcis: existent aussi à la racine et par salle : voir Clavier, souris et manette. Le mode téléphone ajoute phone_orientation_auto: : voir Orientation du téléphone.