JDR-Bot - en:yaml

achievements

Anonymous (anonymous@undisclosed.example.com) — 2026-10-18T23:16:27+00:00

Language / Langue : FR | EN Achievements A scenario can provide its own achievements. They are stored on the player's device independently from game saves: reaching an ending, giving up or starting a new game does not remove them. The trophy button opens the collection without closing the game. Unlocked and locked achievements are shown separately. A secret one is displayed as

actions

Anonymous (anonymous@undisclosed.example.com) — 2026-10-20T20:22:51+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-10-18T23:17:03+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-10-19T19:20:00+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-08-31T18:51:29+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-10-19T20:45:29+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.

dialogues

Anonymous (anonymous@undisclosed.example.com) — 2026-10-19T08:46:08+00:00

Language / Langue : FR | EN Dialogues and sequences A room text can become a sequence of replies: the player clicks to move the conversation forward, with a speaker, a portrait, a frame and a background. Everything is optional. A sequence without portrait or background is a series of replies shown one after another.

drag-drop

Anonymous (anonymous@undisclosed.example.com) — 2026-08-31T18:51:53+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.

evenements-globaux

Anonymous (anonymous@undisclosed.example.com) — 2026-10-18T23:22:15+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-11-04T20:35:14+00:00

Language / Langue : FR | EN Events (YAML) Events are action blocks run automatically or called through an interaction, such as a button, shortcut or trigger_event:id. A button waits for a click. Without a button, manual: true or a shortcut makes the event manual. Merely referencing its ID in

export

Anonymous (anonymous@undisclosed.example.com) — 2026-09-26T01:44:00+00:00

Language / Langue : FR | EN YAML - Multiple files, standalone and PDF export Splitting a scenario into several YAML files A large scenario may be split across several files. In the editor's room list, select a global category or a room, then use Split after selection

hud

Anonymous (anonymous@undisclosed.example.com) — 2026-11-04T21:41:44+00:00

Language / Langue : FR | EN HUD - 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-10-18T23:23:27+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.

listes-boucles

Anonymous (anonymous@undisclosed.example.com) — 2026-10-20T20:10:39+00:00

Language / Langue : FR | EN Lists, collections and loops Since 4.17, YAML scenarios can store data in lists and collections, then loop over them. The editor provides forms for the same operations. The TXT syntax is unchanged. Declare and read vars: position: 0 amount: 0 vars_text: drawn_item: '' lists: bag: [key, potion, potion] party: - {name: Arthur, health: 70} - {name: Morgane, health: 95} collections: hero: {name: Arthur, health: 90}

medias

Anonymous (anonymous@undisclosed.example.com) — 2026-10-18T23:24:03+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-10-20T20:23:27+00:00

Language / Langue : FR | EN Models (YAML) A model contains reusable rooms. Each instance binds its variable and exit names to those of the scenario. Example: a healing room This scenario opens the model, lets the player heal, then returns to the calling room's choices.

objets

Anonymous (anonymous@undisclosed.example.com) — 2026-11-04T20:34:00+00:00

Language / Langue : FR | EN Objects and Inventory (YAML) Declarations in objects: define items and their initial locations in the room. They use the native bot commands: take, inspect and drop. Important: YAML objects do not support if: or visible-if:

options

Anonymous (anonymous@undisclosed.example.com) — 2026-10-18T21:46:26+00:00

Language / Langue : FR | EN Global Options and Scenario Header (YAML) Scenario header id: my-scenario language: en title: "My scenario" description: | Description shown in the catalogue and standalone export. category: fiction scenario_tags: [adventure, humour] markdown: none

raccourcis

Anonymous (anonymous@undisclosed.example.com) — 2026-10-18T23:25:15+00:00

Language / Langue : FR | EN Keyboard, mouse and gamepad shortcuts On Web, Desktop and in HTML exports, authors can bind keys, clicks or gamepad controls to scenario interactions. Buttons remain usable. Without author-defined bindings, a gamepad adds no automatic navigation.

syntaxe-base

Anonymous (anonymous@undisclosed.example.com) — 2026-10-18T23:25:51+00:00

Language / Langue : FR | EN YAML Syntax - Base YAML describes the rooms, choices and rules of a scenario. The legacy .txt format is still supported. 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: - command: forward button: "Move tow…

texte

Anonymous (anonymous@undisclosed.example.com) — 2026-11-04T22:30:57+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-10-19T02:16:12+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-10-18T23:29:15+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-08-31T18:56:22+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-10-20T20:12:27+00:00

Language / Langue : FR | EN Variables (YAML) Declaring variables Numeric variables belong in vars:: vars: score: 0 hp: value: 10 description: "Health points" Text variables belong in text_vars:: text_vars: hero_name: value: "Adventurer" description: "Hero name"