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

====== Global Options and Scenario Header (YAML) ======

===== Scenario Header =====

<code yaml>
title: "My Scenario · v1.0 · (v_nbparties_o_v plays)"
description: |
  Free description shown in the scenario catalogue
  and in standalone export headers.
markdown: none
</code>

Avoid using ''|'' in the title; prefer ''·'' or ''—''.

===== markdown: =====

^ Value ^ Rendering ^
| ''fix'' | Monospace block. |
| ''none'' | Plain text. |
| ''bold'' / ''italic'' / ''quote'' | Global style. |
| ''story'' | Enables semantic story blocks. |
| ''py'' / ''yaml'' / ''js'' / ... | Highlighted code block. |

===== Global Text Style =====

<code yaml>
size: 18
font: Georgia
background: "#111827"
text-color: "#f5f0d8"
</code>

===== options: Permanent Toolbar Buttons =====

<code yaml>
options:
  refresh: "Refresh"
  inventory: "Bag"
  previous: "Back"
  v_score_v: "Score"
  home: "Home"
</code>

^ Key ^ Effect ^
| ''refresh'' | Redisplay current room. |
| ''inventory'' | Show inventory. |
| ''previous'' | Go back to previous room. |
| ''v_name_v'' | Display variable value and description. |
| ''room_id'' | Direct access to a room. |

===== External Links =====

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

===== Fallback Examine =====

If an option key points to an object or furniture name in the current room, the engine triggers ''examine'' on it instead of room navigation.

===== global_events_order: =====

<code yaml>
global_events_order: before
</code>

Accepted values: ''before'' or ''after''. Default: ''after''.