Skip to content

Releases

0.5.1

Choose a tag to compare

@github-actions github-actions released this 19 Nov 15:35

Installing

Download gamebook-press-0.5.1.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.

What's new

  • No changes to the plugin itself. The install zip now includes the licence file.

Dungeon Crawl Classics is a trademark of Goodman Games.

Built from source commit ba8a42bf35fd551ab99c7287707c5b4b1519f576.

0.5.0

Choose a tag to compare

@github-actions github-actions released this 18 Nov 21:10

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.

0.4.3

Choose a tag to compare

@github-actions github-actions released this 17 Nov 23:41

Installing

Download gamebook-press-0.4.3.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.

What's new

  • The release files can be verified. They are now built by this repository's Release workflow and carry GitHub artifact attestations: gh attestation verify main.js --repo Live-to-Role/gamebook-plugin --source-ref refs/tags/0.4.3 proves a download was built here from this tag.
  • The packages the plugin bundles are pinned to the exact versions it is tested with.

Nothing about writing or playing books has changed.

Dungeon Crawl Classics is a trademark of Goodman Games.

0.4.2

Choose a tag to compare

@madmichael madmichael released this 17 Nov 22:03

Installing

Download gamebook-press-0.4.2.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.

What's new

  • The plugin cannot create script elements. Obsidian's review of 0.4.1 found the call in React, which the plugin bundles. Nothing used it; the build now takes it out and checks that it stays out.
  • Insert menu names keep their capitals. A right-click insert named for a game system no longer has the system's name lowercased.

Nothing else about writing or playing books has changed.

Dungeon Crawl Classics is a trademark of Goodman Games.

0.4.1

Choose a tag to compare

@madmichael madmichael released this 17 Nov 14:22

Installing

Download gamebook-press-0.4.1.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.

What's new

  • A Patreon link. The plugin's entry in Settings → Community plugins now links to the Patreon that funds the plugin and gamebook.press.
  • Second Person Press is a Magical Mishap LLC creation. The author line says so, and the licence names Magical Mishap LLC.

Nothing about writing or playing books has changed.

Dungeon Crawl Classics is a trademark of Goodman Games.

0.4.0

Choose a tag to compare

@madmichael madmichael released this 16 Nov 17:37

Installing

Download gamebook-press-0.4.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.

What's new

  • Fight reports. Report on the fights in this book fights each fight 200 times and shows how often the reader wins, the health and Luck they have left, and how many rounds it took. Report on a path of fights in this book fights the fights you pick one after another, each with the wounds the last left.
  • Rolled characters. A Dungeon Crawl Classics book can roll the reader's character on a setting instead of offering pre-gens, with characters: rolled, setting:, rerolls: and renaming: in book.md.
  • Bands. band: 4 gives the reader a band who step up one after another as each falls. Chapters can say who a hazard strikes (strikes: the lowest luck), when the fallen's gear is lost with them, ask who steps forward, and ask how many of the band still stand. The play pane shows the band, the ground and who fell.
  • Damage that cannot be rolled is caught on its line. damage: 3 now does exactly 3, and something like damage: 3 + 1 is an error rather than a trap that does nothing.

How to write rolled characters and bands: https://gamebook.press/docs/systems/dcc.

Dungeon Crawl Classics is a trademark of Goodman Games.

0.3.1

Choose a tag to compare

@madmichael madmichael released this 14 Nov 19:28

Installing

Download gamebook-press-0.3.1.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.

What's new

  • Plainer descriptions. The game systems' descriptions, and the Dungeon Crawl Classics crit and fumble tables, say what each thing is and leave out the notes on how it was built.
  • Dungeon Crawl Classics is a trademark of Goodman Games.

0.2.3

Choose a tag to compare

@madmichael madmichael released this 13 Nov 20:30

Installing

Download gamebook-press-0.2.3.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.

What's new

  • One list of game systems. "Start a new book" and the compiler's hints now offer the same systems: Standard Gamebook, Dungeon Crawl Classics, d20 Classic and Percentile.
  • Books written on a system no longer listed still open and play.

0.2.2

Choose a tag to compare

@madmichael madmichael released this 13 Nov 03:25

Installing

Download gamebook-press-0.2.2.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.

What's new

  • The plugin's styles stay in the play pane. Its stylesheet no longer defines general class names such as .hidden or .flex for the whole app, so it cannot change how your theme or other plugins look.
  • Loads on older iPhones and iPads. Two patterns in the book compiler that iOS before 16.4 could not read have been rewritten.

0.2.1

Choose a tag to compare

@madmichael madmichael released this 12 Nov 19:23

Installing

Download gamebook-press-0.2.1.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.

What's new

  • Messages say where and how. A complaint about your book now names the file and line it is about, and says how to fix it: how to mark a winning ending, what to do when something can run out, and so on.
  • Renamed or misspelt items and flags. If a choice uses a name that is not in items.md or flags.md, the message sits on that line and suggests the row you probably meant.
  • Misspelt endings. ending: victroy is an error on its own line, listing the words you can use.
  • The guide has new sections on endings and on things that run out, and a table of common messages.