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.

997_globaux: (ordre d'exécution des événements globaux)

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

997_globaux: avant   # "avant" ou "apres" (défaut : 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

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
Idéal pour des liens de partage directs dans des annonces ou pages de présentation

Retrouvez nous sur le discord Make&Play