**Language / Langue :** **FR** | [[en:yaml:options|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 :

<code yaml>
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
</code>

⚠ 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 :

<code yaml>
taille: 18
police: Georgia
fond: "#111827"
couleur-texte: "#f5f0d8"
</code>

===== 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) :

<code yaml>
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"
</code>

^ 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 :

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

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 [[fr:yaml:variables|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 :

<code yaml>
997_globaux: avant   # "avant" ou "apres" (défaut : apres)
</code>



===== URL directe de lancement (v4.9) =====

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

<code>
https://jdr-bot.cyril-fiesta.fr/?play=nomscenario
</code>

  * 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 [[https://discord.gg/Z63DtVV|discord Make&Play]]**