**Language / Langue :** **FR** | [[en:yaml:options|EN]]

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

===== En-tête du scénario =====

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

''id:'' identifie durablement le scénario. Il devient obligatoire avec les [[fr:yaml:succes|succès]] ou les [[fr:yaml:variables|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 ''<nowiki>|</nowiki>'' 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 =====

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

Ces valeurs servent de défaut aux textes Web et Desktop. Une salle peut les remplacer.

===== options: - boutons permanents =====

<code yaml>
options:
  rafraichir: "Rafraîchir"
  inventaire: "Inventaire"
  precedent: "Précédent"
  v_score_v: "Score"
  accueil: "Accueil"
  url1: "https://cyril-fiesta.fr/jdr-bot-wiki/|Wiki"
</code>

^ 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 ''<nowiki>|</nowiki>'' |

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

<code yaml>
ordre_evenements_globaux: avant
</code>

Les valeurs acceptées sont ''avant'' et ''apres''.

===== URL directe de lancement =====

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

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 [[fr:ui:presentation|Modes d'interface]].

<code yaml>
ui: cartes
masquer_saisie: false
</code>

Le mode téléphone ajoute ''phone_accueil:'' et ''phone_forme:''. Voir [[fr:ui:phone|Mode téléphone]].

===== montrer-type: =====

Pour le [[fr:yaml:glisser-deposer|glisser-déposer]], ''montrer-type: true'' distingue les éléments source, cible et mixte. L'option peut être globale ou propre à une salle.

===== Catalogue et liens de scénario =====

Les liens publics reprennent le titre et la description du scénario. Si sa description n'est pas renseignée, celle de ''liste_scenarios.txt'' sert de repli.

Les tags du catalogue, déclarés dans ''liste_scenarios.txt'', peuvent être libres : ils sont affichés sur les cartes et pris en compte par la recherche. Les tags connus conservent leurs traductions et leurs onglets. Ils sont distincts des [[fr:yaml:tags|tags de salles]], qui ajoutent des comportements au scénario.

===== Écho des commandes (4.17) =====

<code yaml>
echo_commandes: false
</code>

L'écho est désactivé par défaut. ''true'' affiche les commandes et clics de boutons dans le fil du jeu. Une salle peut remplacer le réglage global.

Les listes ''raccourcis:'' existent aussi à la racine et par salle : voir [[fr:yaml:raccourcis|Clavier, souris et manette]]. Le mode téléphone ajoute ''phone_orientation_auto:'' : voir [[fr:ui:phone|Orientation du téléphone]].