Devlog: A12

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-15 05:48:07 -05:00
co-authored by Claude Opus 5.5
parent b604ced923
commit dbe1ef923a
+54
View File
@@ -1680,3 +1680,57 @@ landed far apart.
1. If the release has its binaries, verify them and close R5.
2. Otherwise A12, the tutorial (#52).
3. Then A13, gamepad and accessibility (#53).
## 2026-11-15 (morning): A12, the tutorial
The v1.0.0 release is still a draft with no binaries, so R5 still waits on Eric. This
run took A12 (#52). Commit b604ced is on `main` after the v1.0.0 tag, like M7.
**The design.** The tutorial is an ordinary offline match. Only the server's rules
change; the lesson itself lives on the client.
- **Rules:** `MatchRules.tutorial()` is one player and no bots. `last_team_wins` is
off, so a player alone isn't the winner at once; only the tide, or nobody left
standing, ends it. `starting_kit` gives `Tuning.TUTORIAL_KIT`: a dock carbine with a
full magazine and 60 cartridges.
- **Command logs:** both new rules are recorded. Logs without them read with the
defaults (`OPTIONAL_RULE_KEYS`), so older logs still load.
- **Steps:** `Tutorial` (src/app) watches the predicted player, the world copy and the
FX. The steps are leap, glide, walk 12 m and jump, gather 15 with enough for a wall,
place a piece (a PLACE FX), hit something with a weapon (an IMPACT FX), and open the
chart then stand 1 m above the tide line after next for 2 s.
- **Card:** `TutorialCard` sits under the minimap. Every instruction names the
player's own bindings.
- **Pilot:** `TutorialPilot` plays the tutorial through `ClientInput`, setting the held
keys and actions and where it looks. It pauses half a second in build mode before
placing, as a person would; without that pause, the build capture caught the moment
after placing.
- **Menus:** a new `welcome` screen on first launch (until answered, saved as
`tutorial.offered`), a Tutorial button on the main menu, and `tutorial.done` saved
on finishing. `--tutorial` works on the command line.
**Tests:**
- `make check`: 745 tests, smoke ok. `test_menus` now opens with the tutorial already
offered, and its focus-order test includes the new button.
- `make tutorial-check` (new): 12 of 12 seeds finish, in 23–32 s of game time each.
- `tidewall --tutorial --autoplay --seed=7 --client-seconds=75`, in real time: done,
0 corrections.
- `make match`: ok, and the replay hash matches.
**Captures (software rendering), looked at:**
- `tutorial_move`, `tutorial_build` and `tutorial_tide`: the card under the minimap,
readable, with the step counter and progress line.
- `menu_welcome`: the offer, with both buttons and the focus ring on Start.
**Notes:**
- Most seeds land the player well above the line, so the tide step is mostly about
opening the chart and reading the numbers.
- The wording follows the code's "barge" and "sail". #72 (the launch fiction) may
change it.
**Next run:**
1. If the release has its binaries, verify them and close R5.
2. Otherwise A13, gamepad and accessibility (#53). It's the last workable issue in a
build milestone apart from the priority/low ones and #80, which is open until it
reproduces.
3. Then the Finishing steps: README status, comments on R6 and R7, and disable the
task.