# Weekend arcade ## What this builds A short arcade game. Pieces fall. The person moves a paddle or a small catcher along the bottom. Catching the right kind scores; catching the wrong kind, or missing a required one, costs a life. Motion is juicy but deterministic under a seed. The shapes, the feel and the scoring are original. A run is finishable in a minute and readable in a still. Read `spekkr.inputs.json` first. `title` is the attract heading. `lives` is the starting count. `pace` sets the spawn rate. `juice` and `shake` add feel; tests settle them before comparing frames. ## Out of scope - A long campaign or meta-progression. - Network or a public scoreboard in the checks. - A second stick or a virtual-reality mode. ## Requirements Each requirement has an id. Checks name the id they cover. ### R1. Collision and score - The catcher is a 80 by 16 px rounded bar. A piece is a 24 px square. A catch is an overlap of their axis-aligned boxes. - A `good` piece scored on catch adds 10, and 1 to a combo that multiplies the next good catch, cap 8. - A `bad` piece on catch, or a `good` piece that passes the bottom, costs one life and resets the combo. Accept when: the collision fixtures in `design.md` report catch or miss as listed, and the score trail of the seeded run matches the file. ### R2. A seeded run - Seed 11, `standard` pace, 3 lives, produces the spawn tape in `fixtures/arcade-seed-11.json`. - A scripted catcher path in that file plays through 20 seconds and ends with the score and lives in the file. - The same seed and path replay bit-identically. Accept when: two runs hash the same score trail, and the ending score and lives match the file. ### R3. Frames and files - Four frames from the seed-11 run, animations settled: attract, a catch, a near-miss, and a busy field at t = 16 s. - One command runs collision, seed, and replay tests, and writes the frames. No network. Accept when: the command passes at every pace, and the frames match the goldens. ### R4. Inputs - The build reads `spekkr.inputs.json`. Settings label the UI, options turn features on or off, and a swap must be one of its choices. - A value outside a stated range, or a swap that is not one of its choices, is refused before the app starts its checks, with a message that names the key. Accept when: the default inputs render, an illegal swap is refused by name, and changing a visible setting (for example the title) shows up in a later check. ## Verification Collision and score tests cover a catch, a miss, a corner touch, and combo reset. A seeded 20-second run with a scripted catcher path is replayable and matches a score trail. A golden gameplay frame is taken with motion juice settled. No network. ## Definition of done - Every acceptance check above runs from one command, and all pass at the person's inputs. - A README says how to play, how to pin a seed, and how to run the checks.