ZORK TRILOGY -- how to install and play
========================================

You need a Mac with Apple silicon (M1 or later) and macOS 11 or later.

Installing
1. Double-click the zip file. A folder appears next to it.
2. Open Terminal: press Cmd-Space, type Terminal, press Return.
3. In Terminal, type  bash  and a space. Then drag install.sh from the
   folder into the Terminal window, and press Return.
4. The game opens and asks four questions:
   - Claude: "Claude account" for Claude Pro or Max (you sign in in your
     browser; Claude Code is installed if it's missing), "API key" for an
     Anthropic API key (paste it with Cmd-V), or "None" for no Claude.
   - Generative AI features: On (Claude answers; needs Claude) or Off.
   - Text speed: Paced (the text types itself out) or Fast (all at once).
   - Send usage: Anonymous (release, mode and an install ID) or Off.
5. From then on, open The Zork Trilogy from Applications or Launchpad.
   Type  settings  any time to change these choices, or to turn on the
   Usage display (tokens used on a Claude plan, dollars on an API key).

Generative AI features
With Claude set up, Claude answers the things the original games can't:
try anything, and you get a reply in the game's own voice. Turn this on
or off in  settings  (Generative AI features: On or Off). Off plays the
original games exactly, with no Claude at all.
- With a Claude account, those turns count against your plan's usage.
- With an API key, each such turn is billed to your API account.

Playing
- Type commands and press Return: look, take lamp, go north, open door.
- You can type ahead: what you type while a reply is still coming waits.
- help  opens this game's manual.  hint  gives a hint for where you are
  (ask again for a plainer one), and  exits  lists the ways out (both with
  Generative AI features on).  credits  says who made the game.
- save  keeps your place: give the save a name and press Return.
  restore  brings it back (type the same name).
- To copy part of the game, click a command or its reply to select it.
  Click another one (scroll back with the wheel or Page Up if you need to)
  to select everything from the first to the second. Cmd-C copies the
  selection; paste it anywhere with Cmd-V. Esc clears the selection.
- F1 changes the screen colour (amber, green, white); F2 shows the monitor.
- F3 saves a screenshot of the window on your Desktop.
- Cmd-Return (or Cmd-Ctrl-F) switches full screen on and off.
- Cmd-Q quits. Save first if you want to keep your place.

Sending us your playtest
Type  export  and press Return. It saves a file named
"The Zork Trilogy playtest" on your Desktop, with everything you have played
so far (your commands, the game's replies, and your settings; never your
API key). Nothing is uploaded: email that file to busycursor@virtu.is.

Where things are kept
Saves, settings and play logs are in your home folder, under
  Library/Application Support/Zork Trilogy
Updating: type  upgrade  in the game. It fetches the newest release from
cycle.virtu.is, saves your place, installs it and opens it where you were. A
new release's install.sh also works (quit the game first); your saves and
settings are kept either way. If the game is open, install.sh says:
  The Zork Trilogy is still open. Quit it (Cmd-Q), then run install.sh again.

Credits
Zork I, II and III by Infocom. Screen font: Px437 IBM VGA 8x16 from
The Ultimate Oldschool PC Font Pack by VileR (int10h.org), CC BY-SA 4.0.
Icon lettering: Cinzel by Natanael Gama, SIL Open Font License 1.1.
