**Language / Langue :** [[start|FR]] | **EN**

====== JDR-Bot — Wiki ======

Welcome to the official **JDR-Bot** wiki.

JDR-Bot is a multi-platform text-game engine. It can run interactive fiction, escape games, RPG-like adventures, puzzles and gamebooks on Discord, on the web, locally, as standalone HTML5 exports, and as PDF gamebooks.

  * [[en:bot:presentation|Bot overview]] — what JDR-Bot can do
  * [[en:bot:installer|Installation and getting started]] — Discord, web, local, HTML5

===== Documentation =====

==== YAML Syntax (current format) ====

  * [[en:yaml:syntaxe-base|Base syntax]] — scenario structure, rooms, exits
  * [[en:yaml:options|Options and header]] — title, description, markdown:, options:, external links
  * [[en:yaml:texte|Text and formatting]] — inline Markdown, story blocks, per-block styles
  * [[en:yaml:medias|Sounds, images and videos]] — <<sound>>, [[image]], ((video)), URL variables
  * [[en:yaml:variables|Variables]] — numeric, text, online, random values, pad2
  * [[en:yaml:conditions|Conditions]] — conditional access, operators, AND conditions
  * [[en:yaml:evenements|Events]] — automatic events, buttons, max:, visible-if:, end:
  * [[en:yaml:evenements-globaux|Global events]] — global_aliases:, global_actions:, global_events_order:
  * [[en:yaml:choix|Choices and buttons]] — effect:, visible-if:, disabled-if:, to: previous
  * [[en:yaml:objets|Objects]] — inventory, furniture, pickup messages, object buttons
  * [[en:yaml:actions|Custom actions]] — alias:, button:, visible-if:, t_action_cible_t
  * [[en:yaml:alias|Aliases and buttons]] — commands, global aliases, action aliases
  * [[en:yaml:timers|Timers]] — local timers, global timers, tick:
  * [[en:yaml:hud|HUD panels]] — persistent panels and split HUD
  * [[en:yaml:modeles|Models]] — reusable room groups, variables, exits
  * [[en:yaml:tags|Tags]] — tag-before:, tag-after:, shared behaviors
  * [[en:yaml:export|HTML5 / PDF export]]

==== TXT Syntax (legacy format) ====

  * [[en:txt:syntaxe-base|Base syntax]]
  * [[en:txt:texte|Text and formatting]]
  * [[en:txt:sons-images|Sounds and images]]
  * [[en:txt:objets|Objects and states]]
  * [[en:txt:variables|Variables]]
  * [[en:txt:conditions|Conditions]]
  * [[en:txt:evenements|Events (997)]]
  * [[en:txt:alias|Aliases and reactions]]
  * [[en:txt:reactions|Discord reactions]]
  * [[en:txt:actions|Custom actions]]
  * [[en:txt:options|Title options]]

==== Graphical Editor ====

  * [[en:editeur:presentation|Overview]]
  * [[en:editeur:graphe|Interactive graph]]
  * [[en:editeur:inspecteur|Inspector]]
  * [[en:editeur:globaux|Globals panel]]
  * [[en:editeur:timers-hud|Timers and HUD]]
  * [[en:editeur:linter-export|Linter and export]]
  * [[en:editeur:explorateur|Explorer]]
  * [[en:editeur:astuces|Tips]]

===== Recommended starting points =====

  - **showcase.yaml** — the best practical reference for the current YAML syntax.
  - The **graphical editor** — the safest way to build a scenario without memorizing every key.
  - The **linter** — use it before publishing or exporting.

**Join us on [[https://discord.gg/Z63DtVV|Discord Make&Play]]**