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

Résolution automatique : .yaml en priorité, puis .txt - aucune extension à spécifier
Uniquement les scénarios du dossier officiel scenarios/
Retour à l'accueil normal après la partie
&lang=en lance directement la version anglaise (interface et catalogue compris) - v4.13
Idéal pour des liens de partage directs dans des annonces ou pages de présentation

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}}"