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: "🔄"
  inventaire: "🎒"
  precedent: "↩️"
  v_score_v: "⭐"
  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.