initial commit

2026-07-18 18:34:28 +02:00
commit e9c69864f1
18 changed files with 2472 additions and 0 deletions
@@ -0,0 +1,47 @@
+# labyrinth
+
+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
+`w a s d`) runs the corridors toward the green diamond exit while
+dodging the roaming colored enemies. **Player 2** (joystick 1, or
+`i j k l`) rides the corners of the walls with a blinking cursor -
+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.
+
+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).
+
+## Build & run
+
+```
+make deps       # macOS: brew install acme vice
+make build      # -> labyrinth.prg
+make run        # build + launch in x64sc
+```
+
+Test builds can boot straight into one state:
+
+```
+acme -DAUTOPLAY=1 -f cbm -o labyrinth.prg main.asm
+# also: AUTORULES, AUTOCONTROLS, AUTOCREDITS, AUTOWIN, AUTOLOSE
+```
+
+## Files
+
+- `main.asm` - entry point, BASIC stub, per-frame state machine
+- `defs.asm` - registers, constants, zero page, macros
+- `intro.asm` - TTG boot logo with the gold color wash
+- `menu.asm` - main menu card
+- `rules.asm` - how to play
+- `controls.asm` - joystick + keyboard mappings
+- `credits.asm` - the crew
+- `play.asm` - maze generation (recursive backtracker) + the game
+- `win.asm` / `over.asm` - end screens
+- `common.asm` - shared routines: printing, big block font, input, RNG
+- `sound.asm` - single-voice SID SFX driver