JDR-Bot - en:yaml

actions

Anonymous (anonymous@undisclosed.example.com) — 2026-05-03T16:47:43+00:00

Language / Langue : FR | EN Custom Actions (YAML) Custom actions add free-form commands. On web/desktop, the player types the verb directly. On Discord, they use the action command. Declaration Local actions live in a room's actions: block. Global actions live at root level in

alias

Anonymous (anonymous@undisclosed.example.com) — 2026-05-03T16:47:52+00:00

Language / Langue : FR | EN Aliases, Commands and Buttons (YAML) Modern YAML does not use a reaction: field next to choices or actions. Visible buttons are declared with button:, and typed commands with command: or alias:. Choices choices: - command: north button: "Go north" to: north_room

choix

Anonymous (anonymous@undisclosed.example.com) — 2026-05-03T16:47:44+00:00

Language / Langue : FR | EN Choices and Buttons (YAML) Choices define navigation commands and buttons shown to the player. Base Syntax choices: - command: north button: "Go north" to: forest - command: back to: home * command:

conditions

Anonymous (anonymous@undisclosed.example.com) — 2026-05-03T16:47:42+00:00

Language / Langue : FR | EN Conditions (YAML) Conditions are used in if: fields on events, choices, actions, conditional text blocks, ticks, visible-if: and disabled-if:. Base Syntax Condition Meaning ~ Always true fallback. v_hp_v = 0 Variable equals 0.

evenements-globaux

Anonymous (anonymous@undisclosed.example.com) — 2026-05-03T16:47:45+00:00

Language / Langue : FR | EN Global Events, Global Aliases and Global Actions (YAML) global_events: Global events can run in every room. They are OFF by default unless state: ON is set. global_events: - id: visit_bonus state: OFF if: ~ do: "score.+.1" text: "Visit bonus: +1 score!"

evenements

Anonymous (anonymous@undisclosed.example.com) — 2026-05-03T16:47:45+00:00

Language / Langue : FR | EN Events (YAML) Events are action blocks triggered automatically when entering a room, or manually through buttons. Base Syntax events: - if: "condition" do: "action" text: "Displayed message" * if: — trigger condition.

export

Anonymous (anonymous@undisclosed.example.com) — 2026-05-03T16:47:53+00:00

Language / Langue : FR | EN YAML — Standalone and PDF Export HTML5 Standalone Export The standalone export generates a ZIP containing a complete game that can run without installing JDR-Bot. It can be hosted on itch.io or any web server. From the editor:

hud

Anonymous (anonymous@undisclosed.example.com) — 2026-05-03T16:47:50+00:00

Language / Langue : FR | EN HUD — Persistent Panels (YAML) HUD panels (hud:) display persistent information on the player screen: HP, score, mini-map, countdown, and so on. HUD panels are visible on web and desktop. On Discord and terminal they are ignored; essential information should also appear in narrative text.

medias

Anonymous (anonymous@undisclosed.example.com) — 2026-05-03T16:47:47+00:00

Language / Langue : FR | EN Sounds, Images and Videos (YAML) Media can be used in narrative text, object descriptions and HUD panels. Sounds text: | The dragon roars! <> You take 10 damage. Supported formats for linting and exports:

modeles

Anonymous (anonymous@undisclosed.example.com) — 2026-05-03T16:47:51+00:00

Language / Langue : FR | EN Models (YAML) Models are reusable groups of rooms. They are useful for fights, repeated mini-games, puzzles or reusable systems. Declare a Model models: - name: simple_fight variables: enemy_hp: enemy_hp exits: victory: victory defeat: defeat rooms: - id: attack text: "You attack!" events: - if: "v_enemy_hp_v <= 0" to: victory - if: ~ do: "enemy_hp.-.3" t…

objets

Anonymous (anonymous@undisclosed.example.com) — 2026-05-03T16:47:43+00:00

Language / Langue : FR | EN Objects and Inventory (YAML) Objects declared in objects: are added when the player enters the room. They use the native bot commands: take, examine and drop. Important: YAML objects do not support if: or visible-if: directly. To make an object conditional, use another room, an event, a choice, a tag, or an object with

options

Anonymous (anonymous@undisclosed.example.com) — 2026-05-03T16:47:47+00:00

Language / Langue : FR | EN Global Options and Scenario Header (YAML) Scenario Header 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

syntaxe-base

Anonymous (anonymous@undisclosed.example.com) — 2026-05-03T16:47:42+00:00

Language / Langue : FR | EN YAML Syntax — Base The YAML format is the modern JDR-Bot scenario format. It is easier to read, easier to edit, and more powerful than the legacy .txt format. File Structure title: "My scenario" description: "A short adventure made with JDR-Bot." markdown: story font: serif vars: hp: value: 10 description: "Health points" rooms: - id: start text: | You wake up in a dark forest. A light glows in the distance. choices: - comm…

texte

Anonymous (anonymous@undisclosed.example.com) — 2026-05-03T16:47:46+00:00

Language / Langue : FR | EN Text and Formatting (YAML) Line Breaks In a YAML text: | block, line breaks are preserved. Use +n+ for an explicit line break in formats that do not support real new lines. Text Box When content inside [[ and ]] is not an image

timers

Anonymous (anonymous@undisclosed.example.com) — 2026-05-03T16:47:50+00:00

Language / Langue : FR | EN Timers (YAML) JDR-Bot provides several timing mechanics. Visual Pause {{timer:N}} text: | The mechanism starts... {{timer:3}} The door opens! Local Timer A local timer is declared in an event and is cancelled when the player leaves the room.

variables

Anonymous (anonymous@undisclosed.example.com) — 2026-05-03T16:47:45+00:00

Language / Langue : FR | EN Variables (YAML) Numeric Variables vars: score: 0 hp: value: 10 description: "Health points" The description is shown when the player examines the variable or when it is attached to a permanent option. Text Variables

JDR-Bot - en:yaml

actions

alias

choix

conditions

evenements-globaux

evenements

export

hud

medias

modeles

objets

options

syntaxe-base

tags

texte

timers

variables