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
• Interactive tooltips - inline bubbles, media and local events
• Clickable elements - words/pictures that trigger an event
• Drag & drop - sources, targets, text-ko:, interaction-ko:
• Tiles and tilemaps - spritesheets, grids, dynamic HUD
• 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

• Interface modes - ui: key, per-room modes, hide_input:
• Cards mode - choices as illustrated cards
• Fullscreen mode - immersive point & click scenes
• Deck mode - swipeable decision cards
• Phone mode - smartphone screens, conversations, orientation

• 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
• Collaborative editing
• 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