Repository navigation
0.5.0
Installing
Download gamebook-press-0.5.0.zip below (not "Source code"). Unzip it and put the gamebook-press folder in your vault's .obsidian/plugins/ folder. Then turn the plugin on under Settings → Community plugins.
Before you update
The insert commands have new ids. If you bound a hotkey to one of the old inserts, it is gone. Bind it again under Settings → Hotkeys.
Boxed read-aloud text is gone as an insert, and GM's note is now Author's note.
What's new
This release is about what your reader gets. They play the book, and the book does the bookkeeping.
- A reader never sees a monster's numbers. They see its description. The numbers are what it fights with.
- Tables. Insert table writes a table in
tables.md, andtable:in an entry draws from it out of sight. The reader sees the result, never the table, so a room holds something different each run. A row can be a monster or an item. A table never decides where the reader goes; every exit is still yours. - Keywords. Insert keyword makes something the book remembers about the reader, written in words:
sets: Talked to the old man. Choices and passages can depend on it. Keywords are hidden unless you choose to show one, and a shown keyword appears with what the run has earned. - A map. Put
map: exploredinbook.md, give entries anarea:, and readers get a map that fills in as they walk. Rooms with asize:go on a square grid, places outdoors are hexes with aterrain:, andicon:marks a place with one of 20 icons. The layout is kept inmap-layout.jsonas you write; Lay out again moves everything. - Export for print. Export this book for print writes an
.idmlfile to finish in InDesign or Affinity Publisher, in A5, US Trade or digest. Entries are numbered at random, with linked ones kept apart, and a choice reads "turn to 147". Print shows what the app hides: the monsters' numbers, the tables' dice, a sheet for the reader's pencil. You also get the map as SVG, a report of anything that doesn't work on paper, and notes for whoever lays it out. Renumber this book for print shuffles the numbers. - Export as an ebook. Export this book as an ebook writes an
.epubwith the same numbers, where each "turn to" is a link. Acover.jpg,.png,.webpor.svgbesidebook.mdis its cover. - A better starter book. Start a new book now includes a table, a keyword-gated passage and a small map.
- Fights say what happened. A Dungeon Crawl Classics hit names the weapon, the roll against Armor Class and the damage; a d20 Classic hit names the weapon and the roll. A monster's name is used exactly as you wrote it.
- Unique items stay unique. An item marked unique in
items.mdcan't be held twice. - The guide and the docs at gamebook.press/docs are rewritten around all of this.
Dungeon Crawl Classics is a trademark of Goodman Games.