**Language / Langue :** [[fr: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:tooltips|Interactive tooltips]] - inline bubbles, media and local events
  * [[en:yaml:clickable-elements|Clickable elements]] - words/pictures that trigger an event
  * [[en:yaml:drag-drop|Drag & drop]] - sources, targets, text-ko:, interaction-ko:
  * [[en:yaml:tiles-tilemaps|Tiles and tilemaps]] - spritesheets, grids, dynamic HUD
  * [[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]]

==== Interface modes (4.13) ====

  * [[en:ui:presentation|Interface modes]] - ui: key, per-room modes, hide_input:
  * [[en:ui:cards|Cards mode]] - choices as illustrated cards
  * [[en:ui:fullscreen|Fullscreen mode]] - immersive point & click scenes
  * [[en:ui:deck|Deck mode]] - swipeable decision cards
  * [[en:ui:phone|Phone mode]] - smartphone screens, conversations, orientation

==== 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:collaboration|Collaborative editing]]
  * [[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]]**