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-03T21:59:16+00:00

Language / Langue : FR | EN Aliases and Commands (YAML) Aliases let the player navigate or interact by typing a short keyword, without knowing the exact room id or action name. Command in a choice command: in a choice defines the keyword the player can type to take that exit.

choix

Anonymous (anonymous@undisclosed.example.com) — 2026-05-03T21:59:15+00:00

Language / Langue : FR | EN Choices and Buttons (YAML) Choices define the exits available from a room — navigation, access conditions and buttons shown to the player. Minimal syntax The simplest form: a destination, nothing else. choices: - to: forest - to: village

clickable-elements

Anonymous (anonymous@undisclosed.example.com) — 2026-05-07T01:31:11+00:00

Language / Langue : FR | EN Clickable Elements Clickable elements trigger an event from a word or picture placed inside the room text. Text Syntax text: "The {{lever:@pull_lever}} sticks out of the wall." events: - id: pull_lever do: "lever.=.1" text: "The lever drops with a dry click." once: true

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.

drag-drop

Anonymous (anonymous@undisclosed.example.com) — 2026-05-07T10:31:37+00:00

Language / Langue : FR | EN====== Drag & Drop ======Drag & drop lets the player take an element from the text and drop it onto a target. It is available on web, desktop and interactive HTML exports. Other adapters display the content without drag&drop interaction.===== Sources And Targets =====

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-07T01:31:13+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.

imagemaps

Anonymous (anonymous@undisclosed.example.com) — 2026-05-18T19:59:53+00:00

Language / Langue: FR | EN Image maps / Point & click (YAML) Image maps turn an image into an interactive area. The author provides two files: * a visible image displayed to the player; * a PNG mask where each flat color represents a zone. The feature is interactive on web, desktop and standalone HTML5 export. On Discord and terminal, the image remains visible as a readable media/fallback, without point & click interaction.

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-07T01:16:17+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-07T01:31:12+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

tiles-tilemaps

Anonymous (anonymous@undisclosed.example.com) — 2026-05-07T01:37:18+00:00

Language / Langue : FR | EN Tiles And Tilemaps Tiles extract one cell from a spritesheet. Tilemaps assemble several tiles into a grid, directly in the text or inside a persistent frame. Extracting A Tile text: "Tile: [[/scenarios/images/test/tiles.png:4x4:1:2]]"

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.

tooltips

Anonymous (anonymous@undisclosed.example.com) — 2026-05-07T01:31:11+00:00

Language / Langue : FR | EN Interactive Tooltips Tooltips add a small help bubble directly inside a room text. On web and desktop interfaces, the player can hover or tap the word to reveal the content. Syntax text: "The {{door:?An old door covered in runes.}} blocks the way."

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

clickable-elements

conditions

drag-drop

evenements-globaux

evenements

export

hud

imagemaps

medias

modeles

objets

options

syntaxe-base

tags

texte

tiles-tilemaps

timers

tooltips

variables