Skip to content

0.5.0

Choose a tag to compare

@github-actions github-actions released this 18 Nov 21:10
· 2 commits to main since this release

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, and table: 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: explored in book.md, give entries an area:, and readers get a map that fills in as they walk. Rooms with a size: go on a square grid, places outdoors are hexes with a terrain:, and icon: marks a place with one of 20 icons. The layout is kept in map-layout.json as you write; Lay out again moves everything.
  • Export for print. Export this book for print writes an .idml file 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 .epub with the same numbers, where each "turn to" is a link. A cover.jpg, .png, .webp or .svg beside book.md is 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.md can'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.