Skip to content

Rules before the first key: every round says how it plays - #31

Merged
leodiegues merged 1 commit into
mainfrom
t3/add-game-help-overlays
Oct 26, 2026
Merged

leodiegues merged 1 commit into
mainfrom
t3/add-game-help-overlays

Conversation

@leodiegues

Copy link
Copy Markdown
Owner

New players start a round without knowing its rules. The carousel blurbs give a mode's feel ("feed the fuel"), but not that fuel starts at 10s, that 5 landed words cook you, or that a wrong key stalls you in pursuit. The rules live only in docs/play/modes.md.

Every round already has a "waiting for the first key" state (started.is_none()), so the rules go there instead of in a help overlay. Players don't need to discover a key or close anything, and the rules disappear on the first keystroke.

  • menu::rules(mode): two lines per mode, taken from docs/play/modes.md. Lock-on and free aim in floor is lava each get their own.
  • Typing panel (sprint, blitz, zen, survival, pursuit): before the first key, the rules replace the combo counter and rank, which would only show 0 HITS and BELL PEPPER at that point.
  • Floor is lava: the rules sit above the existing "type a falling word to start".
  • docs/play/modes.md: one sentence about it.
│   HOT PURSUIT                                       SCORE 0  │
│                                                              │
│        a cop chases your caret, faster every 10 words        │
│    a wrong key stops you cold · get caught and you're busted │
│   ╭──────────────────────────────────────────────────────╮   │

Tested: fmt, clippy (desktop and wasm, -D warnings), the typepper tests, and .github/docs-check.sh main. A throwaway TestBackend dump rendered the pursuit panel and lava field at 90 and 40 columns, which caught pursuit's second line overflowing on narrow screens; it's shorter now. I haven't played it yet in a real terminal or browser.

Known limits:

  • The numbers (10s of fuel, +1.5s per word, 5 landings) are written into the strings, the same as in the docs. They won't follow the engine constants if those change.
  • No ? help screen for heat, combo and fever. Add one if players still get lost.

🤖 Generated with Claude Code

The carousel blurbs give a mode's feel, not its rules, so a first round of
survival, floor is lava or hot pursuit started blind. Until the first key,
the typing panel now shows the mode's rules in two lines where the empty
combo and rank sit, and floor is lava shows them above "type a falling word
to start" (lock-on and free aim each get their own). menu::rules holds the
text.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@leodiegues
leodiegues merged commit 1fa7aff into main Oct 26, 2026
8 checks passed
@leodiegues
leodiegues deleted the t3/add-game-help-overlays branch October 26, 2026 14:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant