« Home

Gordian Book

Formats a traditonal choose-your-own-adventure style gamebook from Twison / Twee

About

Gordian Book imports a Twine game (in Twison or Twee format), and converts it to a gamebook output by numbering and shuffling the paragraphs, and converting links to the appropriate "turn to page x" form. Once converted, you can view the game in the browser, download as a standalone HTML file (e.g. for further editing), or export it as a simple PDF. (See Workflow notes).

Example Story

Learn better from an example? Download the following and open it in Twine: Skeleton Passage

Or, if you just want a blank starting point: Blank Story

Instructions

Create your Adventure
Create your adventure in Twine (twinery.org) using Harlowe 3 or Sugarcube 2, or write it in Twee format. This export is intended for a paper output, so avoid using variables, javascript and the like.
Links will be formatted as "Link name (turn to X)". If you just want "turn to X" us the special link name turnto.
Special Passages
The following special passages will be extracted:
  • gb-settings: Used to store your Gordian settings in JSON (see Export Settings)
  • gb-front-cover: Used to create the PDF front cover
  • gb-introduction: Placed before the first numbered entry
  • gb-rear: Placed at the end of the PDF, after a page break
  • gb-rear-cover: Used to create the PDF rear cover
Special Tags
You can tag your passages with the following special tags:
  • end: The game will show 'THE END'. You can customise the text in settings
  • death: The game will show 'YOU DIED'. You can customise the text in settings
  • long: The game will not try to avoid page breaks in this passage
  • skip: The game will skip this passage
  • breakbefore: The game will insert a pagebreak before this passage
  • breakafter: The game will insert a pagebreak after this passage
You can tag a passage with a number to reserve that paragraph number in the final game — make sure to pick a valid number.
Special HTML
The following html-tags will get special styling:
  • <check> For inline rules text and checks
  • <rules> For boxed out rules text
  • <stats> For monster or NPC stat blocks
  • <special> Use inside <stats> for special abilities
  • <after> Content placed following the passage (e.g. an image) (see Workflow notes)
  • <before> Content placed preceeding the passage number
Macros
Macros are not supported with the exception of (display: "passage name") and <<include "passage name">>, which cannot be nested.
Text Formatting
The majority of Harlow Markdown and Sugarcube Wiki-Formatting is supported, see Supported Text Formatting.
Export from Twine
Export your adventure using Twison, or as Twee using Entweedle. Then, copy or save the resulting JSON/Twee. Note: You can use Twee created outside Twine if you wish, as long as you use Harlowe 3 or plain HTML for your formatting
Import into Gordian
Click the Import Game link, and paste your game into the import window, or upload your exported file, and click Import, your game is now loaded into the Gordian. All further steps work on this imported copy, so if you change your Twine original you'll have to export it and import it again.
Convert
Before viewing or exporting your game, you must convert it, by clicking the Convert to Gamebook link. This will do the following:
  • Extract the Introduction, if any.
  • Number each paragraph, except the start, randomly
  • Order the newly numbered paragraphs
  • Trace any links and add numbers to them
  • Process your Markdown, Harlowe styling, tags, and markup
If you don't like the random order produced, you can convert again until you do.
Export
Use the Play Gamebook link to view the gamebook in the browser. Use Export Settings to save a copy of the game settings only. User Print to get your PDF for printing or downloading.
Other formats:
  • Gordian JSON — a complete dump of the converted game, use to re-import later
  • Twine Archive — use to re-import into Twine
  • HTML — a simple HTML version of the game (not interactive)
  • Twee — a Twee3 version of the game, use to import elsewhere

Note

Gordian doesn't store your game long-term. If you close the window, or even leave it idle too long, Gordian will forget your game — make sure you export it if you want to keep it. If you plan to keep tweaking it in Gordian later, export it as Gordian JSON.