Table des matières

Language / Langue : FR | EN

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

En-tête du scénario

L'en-tête YAML contient les paramètres globaux du scénario. Voici les clés disponibles :

titre: "Mon Scénario · v1.0 · (v_nbparties_o_v parties)"
description: |
  Une description libre affichée au survol de la carte scénario
  et dans le header de l'export standalone.
markdown: none

⚠ Ne pas utiliser | dans le titre - utiliser · ou .

markdown:

Contrôle le rendu global du texte de toutes les salles :

Valeur Rendu
fix Bloc monospace - défaut si absent
none Texte brut
bold / italic / quote Style global
story Active les blocs sémantiques narratifs
py / yaml / js / … Bloc code coloré

Style global (taille, police, fond)

Ces valeurs servent de défaut à tous les textes web/desktop. Chaque salle peut les remplacer localement :

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

options: - boutons permanents

Le bloc options: définit des boutons affichés en permanence dans la toolbar (en haut du jeu, pas dans les choix de navigation) :

options:
  rafraichir: "🔄"      # réaffiche la salle courante
  inventaire: "🎒"      # affiche l'inventaire
  precedent: "↩️"       # retour salle précédente
  v_score_v: "⭐"       # affiche la valeur de la variable "score"
  accueil: "🏠"         # accès direct à la salle "accueil"
Clé Valeur Effet
rafraichir emoji Réaffiche la salle courante
inventaire emoji Affiche l'inventaire
precedent emoji Retour salle précédente (si disponible)
v_nom_v emoji Affiche la valeur et description de la variable nom
id_salle emoji Accès direct à la salle (n'apparaît pas si on y est déjà)

Liens externes dans options: (v4.9)

Une option dont la valeur commence par http: ou https: ouvre un lien externe :

options:
  url1: "https://cyril-fiesta.fr/jdr-bot-wiki/|📚 Wiki"
  url2: "https://discord.gg/jdrbot|💬 Discord"

La clé (url1, url2…) est libre. Le | sépare l'URL du label affiché sur le bouton.

Sur web/desktop : ouvre dans un nouvel onglet. Sur Discord/terminal : affiche l'URL en texte.

Fallback examiner (v4.9)

Si une option id_salle pointe vers un nom qui correspond à un objet/meuble de la salle courante (plutôt qu'une salle), le moteur déclenche automatiquement examiner dessus.

vars:, vars_texte:, vars_online:

Variables déclarées au niveau racine, initialisées au lancement. Voir Variables.

ordre_evenements_globaux:

Par défaut, les événements globaux s'exécutent après les événements locaux. Pour les exécuter avant :

ordre_evenements_globaux: avant

Les valeurs acceptées sont avant et apres. La valeur par défaut est apres.

URL directe de lancement (v4.9)

Il est possible de lancer directement un scénario depuis une URL, sans passer par l'accueil :

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

ui: - mode d'interface (v4.13)

Change l'interface de jeu côté joueur : cartes, plein-ecran, deck, phone. La clé existe au niveau du scénario et au niveau d'une salle, tout comme masquer_saisie: qui contrôle la barre de commande. Détails sur Modes d'interface.

ui: cartes
masquer_saisie: false

Le mode téléphone ajoute deux clés d'en-tête : phone_accueil: (salle du bouton Accueil) et phone_forme: (portrait, paysage, tablette) - voir Mode téléphone.

montrer-type:

Pour le glisser-déposer, montrer-type: true affiche visuellement les rôles source, cible et mixte. L'option peut être définie au niveau du scénario ou seulement dans une salle.

montrer-type: true

salles:
  - id: atelier
    montrer-type: true
    texte: "{{cle:>cle}} {{porte:$porte}}"