docs: refresh README for the portrait build (cat, music, flipper notes)

This commit is contained in:
georgios
2026-09-10 15:14:51 +02:00
parent cf2c0e4558
commit a39f67805c
+8 -4
View File
@@ -52,7 +52,7 @@ python3 -m venv .venv
inside 2.5s builds your **combo multiplier** (up to ×9).
- Watch the bottom-centre drain and the two outlanes… or lose the ball.
- Every **50,000 points** earns an extra ball.
- Squirrel says encouraging things. Blush at the cat in the corner.
- The kawaii cat helper reacts to your shots from the corner.
## Project layout
@@ -76,6 +76,9 @@ Dev / test tools (run headless, no window needed):
## Design notes
- **Portrait table**: a `360×480` playfield like a real pinball machine,
with regular-sized flippers (about a quarter of the playfield width each)
at the bottom and a wide centre drain between them.
- **Physics**: fixed 60 Hz logic with up to 6 collision substeps so the ball
never tunnels; kinematic flippers whose angular velocity is transferred to
the ball (real "scoop" feel); inward-tilting floor funnels; centre drain +
@@ -83,8 +86,9 @@ Dev / test tools (run headless, no window needed):
- **Fun tuning was data-driven**: an `autotest.py` bot plays thousands of
frames and reports hit/drain rates per table element, so bumper, slingshot
and flipper geometry was tuned against measured behaviour, not guesswork.
- **Audio**: square/triangle/noise oscillators -> PCM at startup; distinct
pitched bump sounds that climb with your combo, plus two generative music
loops (menu + play).
- **Audio**: soft triangle/sine voices -> PCM at startup; pitched bumper pops
that climb with your combo, plus two real melodies (a slow *Twinkle Twinkle*
lullaby on the title, a bouncier version during play — no square-wave or
noise percussion in the music).
Licence: MIT — go wild.