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.

• Bot overview — what JDR-Bot can do
• Installation and getting started — Discord, web, local, HTML5

• Base syntax — scenario structure, rooms, exits
• Options and header — title, description, markdown:, options:, external links
• Text and formatting — inline Markdown, story blocks, per-block styles
• Sounds, images and videos — «sound», image, ¹⁾, URL variables
• Variables — numeric, text, online, random values, pad2
• Conditions — conditional access, operators, AND conditions
• Events — automatic events, buttons, max:, visible-if:, end:
• Global events — global_aliases:, global_actions:, global_events_order:
• Choices and buttons — effect:, visible-if:, disabled-if:, to: previous
• Objects — inventory, furniture, pickup messages, object buttons
• Custom actions — alias:, button:, visible-if:, t_action_cible_t
• Aliases and buttons — commands, global aliases, action aliases
• Timers — local timers, global timers, tick:
• HUD panels — persistent panels and split HUD
• Models — reusable room groups, variables, exits
• Tags — tag-before:, tag-after:, shared behaviors
• HTML5 / PDF export

• Base syntax
• Text and formatting
• Sounds and images
• Objects and states
• Variables
• Conditions
• Events (997)
• Aliases and reactions
• Discord reactions
• Custom actions
• Title options

• Overview
• Interactive graph
• Inspector
• Globals panel
• Timers and HUD
• Linter and export
• Explorer
• Tips

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

Join us on Discord Make&Play