Skip to content

Prose links, GO BACK, and descriptions that withhold what must be examined - #82

Merged
corepunch merged 1 commit into
mainfrom
prose-links-go-back
Sep 29, 2026
Merged

corepunch merged 1 commit into
mainfrom
prose-links-go-back

Conversation

@corepunch

Copy link
Copy Markdown
Owner

What changes

Prose links. Stories mark the words a reader can act on, Twine-style: [[crayon drawing]], or [[iron gates->gate]] when the parser's word differs from the prose. A host that renders links sets PROSE_LINKS before the bootstrap runs and receives the markup; every other host, and every transcript test, reads the plain label, so existing ASSERT-TEXT checks are unaffected.

GO BACK. go back, walk back and back retrace the player's last step, for every story, from the bootstrap: the command is rewritten to the direction whose exit leads to the room the player came from. The two rooms are numeric globals, so they are saved, restored and restarted with the rest of the story. With no way back, go back answers "You can't retrace your steps from here." without spending a turn; a bare back is then left to the story's own verb.

Blackwood Horror prose. A description says what a glance takes in (Zork I prints the leaflet only when read, and lists the mailbox's contents only once it is open):

  • the child's drawing is no longer quoted in the ward's description; examine drawing shows it;
  • the metal cabinet starts shut (door ajar) and lists nothing until it is examined or opened; close cabinet hides its contents again;
  • the serum's label and the ledger's final entry are read by examining them.

The opening rooms (gate, entrance hall, reception, theater, ward) carry links for testing.

Tests

  • New books/blackwood-horror/test/test-prose-reveal.zil (24 assertions), added to test-horror-playtest-regressions.
  • make test-horror-all, test-zork2, test-game-startup, test-wondertown-descriptions pass.
  • Already failing on main and unchanged here: test-zork1 (step 4), test-walk-around-house, test-limehouse-walkthrough (11 failures), and 2 unit tests in make test-unit.

Docs: docs/WRITING_ADVENTURES.md gains "Prose Links", "Withholding What Must Be Examined" and "Going Back".

🤖 Generated with Claude Code

…mined

Stories mark tappable words Twine-style ([[label]] or [[label->target]]);
hosts that set PROSE_LINKS receive the markup, all others the plain label.
GO BACK retraces the last step for every story, from the bootstrap.
Blackwood Horror no longer quotes the drawing, the vial or the ledger in a
room description, and its cabinet lists its contents only once opened.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@corepunch
corepunch merged commit bf7d98a into main Sep 29, 2026
1 check failed
@corepunch
corepunch deleted the prose-links-go-back branch September 29, 2026 13:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant