options

README.md

@@ -1,7 +1,7 @@
-# labyrinth
+# labyrinth (LabyrinTwo)
 
-Two-player maze duel for the Commodore 64 (ACME + VICE), in the same
-spirit as [rabbitc64](../rabbitc64).
+**LabyrinTwo** - a two-player maze duel for the Commodore 64
+(ACME + VICE), in the same spirit as [rabbitc64](../rabbitc64).
 
 A fresh maze is carved every round on a 39x23 lattice where the walls
 are exactly as wide as the corridors. **Player 1** (joystick 2, or
@@ -12,10 +12,19 @@ fire (or `return`) spins the four wall pieces around the cursor by
 90 degrees, reshaping the maze in real time. A spin is denied while
 anyone is standing in one of the four slots.
 
+The options screen adds two optional twists:
+
+- **runner gun** - player 1 shoots a bullet with fire/`space`; a hit
+  enemy respawns on a random cell after a pause.
+- **spin cooldown** - each spin starts a recharge; further spins are
+  denied until the draining bar on the status row runs out and the
+  readout flips back from *wait* to *ready* (the cursor also dims
+  while recharging).
+
 Screens: TTG intro (ported from rabbitc64) -> main menu
-(play / rules / controls / credits) -> game -> win (back to the menu)
-or game over (fire retries with a fresh maze, `m` backs out to the
-menu).
+(play / options / rules / controls / credits) -> game -> win (back
+to the menu) or game over (fire retries with a fresh maze, `m` backs
+out to the menu).
 
 ## Build & run
 
@@ -29,7 +38,9 @@ Test builds can boot straight into one state:
 
 ```
 acme -DAUTOPLAY=1 -f cbm -o labyrinth.prg main.asm
-# also: AUTORULES, AUTOCONTROLS, AUTOCREDITS, AUTOWIN, AUTOLOSE
+# also: AUTOOPTIONS, AUTORULES, AUTOCONTROLS, AUTOCREDITS,
+# AUTOWIN, AUTOLOSE; add -DFORCEOPTS=1 to start with both
+# options turned on
 ```
 
 ## Files
@@ -38,6 +49,7 @@ acme -DAUTOPLAY=1 -f cbm -o labyrinth.prg main.asm
 - `defs.asm` - registers, constants, zero page, macros
 - `intro.asm` - TTG boot logo with the gold color wash
 - `menu.asm` - main menu card
+- `options.asm` - the optional extras and their toggle screen
 - `rules.asm` - how to play
 - `controls.asm` - joystick + keyboard mappings
 - `credits.asm` - the crew