A short skippable tutorial covering movement, harvesting, building, combat and surviving the tide, using the current key bindings.
Acceptance
A scripted client can finish it from start to end.
Offered on first launch and always available from the menu.
**Depends on:** A9, A10
A short skippable tutorial covering movement, harvesting, building, combat and surviving the tide, using the current key bindings.
**Acceptance**
- A scripted client can finish it from start to end.
- Offered on first launch and always available from the menu.
claude
added this to the v0.6 Art, Audio and UI milestone 2026-11-09 05:28:49 +00:00
Deferred for the Monday 2026-11-16 build. The schedule is more than a day behind, so unprioritised issues wait until multiplayer, the HUD and menus, and release work are done. The R3 player guide will cover controls in the meantime. This stays open. — tidewall-build
Deferred for the Monday 2026-11-16 build. The schedule is more than a day behind, so unprioritised issues wait until multiplayer, the HUD and menus, and release work are done. The R3 player guide will cover controls in the meantime. This stays open. — tidewall-build
What it is. A short tutorial on an island of your own. It has seven steps: leave the barge, glide down, walk 12 m and jump, gather 15 materials with the boathook, place a wall, hit something with the dock carbine, then open the chart and get above the line the tide will reach after its next rise. A card under the minimap gives each instruction with the player's own key bindings (rebinding jump to J shows [J]), and shows progress for walking, gathering and the tide.
How it works.
Server rules:MatchRules.tutorial() means one player and no bots. last_team_wins is off, so being alone isn't a win. starting_kit gives Tuning.TUTORIAL_KIT: a carbine with a full magazine and 60 cartridges. These rules are the only change to the game. Both go into command logs, and older logs still read, taking the defaults.
Client side:Tutorial judges each step from what the client already has: its predicted player, its copy of the world, and the FX the server sends.
Offered on first launch: a "Welcome aboard" screen with "Start the tutorial" and "Not now". The answer is saved in settings. "Tutorial" is always on the main menu, and Leave in the pause menu skips it. Finishing it is saved too. The command line takes --tutorial.
Tests.
make check: 745 tests pass, and smoke is ok. test/app/test_tutorial.gd adds 13 tests, one of which plays seed 3 through to the end.
make tutorial-check:TutorialPilot plays through ClientInput, the same path as the keys. All 12 seeds finish, in 23–32 s of game time each.
Real time:tidewall --tutorial --autoplay --seed=7 --client-seconds=75 reached "tutorial":"done" with 0 corrections.
make match: ok. The replay hash matches, so the command-log change doesn't affect replays.
Captures, all looked at:tutorial_move, tutorial_build (allowed ghost, 15 stone, card under the minimap), tutorial_tide and menu_welcome. They were rendered in software, so they show layout, not how it feels to play.
Notes and follow-ups.
On most seeds the player lands well above the tide line, so the last step is mostly about opening the chart and reading the numbers. I kept it that way rather than forcing a long climb.
The card says "barge" and "sail", matching the code. If #72 settles the launch fiction differently, the wording in src/app/tutorial.gd changes with it.
Nobody has played the tutorial with a keyboard yet. That's part of R6.
— tidewall-build
Done in b604ced.
**What it is.** A short tutorial on an island of your own. It has seven steps: leave the barge, glide down, walk 12 m and jump, gather 15 materials with the boathook, place a wall, hit something with the dock carbine, then open the chart and get above the line the tide will reach after its next rise. A card under the minimap gives each instruction with the player's own key bindings (rebinding jump to J shows `[J]`), and shows progress for walking, gathering and the tide.
**How it works.**
- **Server rules:** `MatchRules.tutorial()` means one player and no bots. `last_team_wins` is off, so being alone isn't a win. `starting_kit` gives `Tuning.TUTORIAL_KIT`: a carbine with a full magazine and 60 cartridges. These rules are the only change to the game. Both go into command logs, and older logs still read, taking the defaults.
- **Client side:** `Tutorial` judges each step from what the client already has: its predicted player, its copy of the world, and the FX the server sends.
- **Offered on first launch:** a "Welcome aboard" screen with "Start the tutorial" and "Not now". The answer is saved in settings. "Tutorial" is always on the main menu, and Leave in the pause menu skips it. Finishing it is saved too. The command line takes `--tutorial`.
**Tests.**
- **`make check`:** 745 tests pass, and smoke is ok. `test/app/test_tutorial.gd` adds 13 tests, one of which plays seed 3 through to the end.
- **`make tutorial-check`:** `TutorialPilot` plays through `ClientInput`, the same path as the keys. All 12 seeds finish, in 23–32 s of game time each.
- **Real time:** `tidewall --tutorial --autoplay --seed=7 --client-seconds=75` reached `"tutorial":"done"` with 0 corrections.
- **`make match`:** ok. The replay hash matches, so the command-log change doesn't affect replays.
- **Captures, all looked at:** `tutorial_move`, `tutorial_build` (allowed ghost, 15 stone, card under the minimap), `tutorial_tide` and `menu_welcome`. They were rendered in software, so they show layout, not how it feels to play.
**Notes and follow-ups.**
- On most seeds the player lands well above the tide line, so the last step is mostly about opening the chart and reading the numbers. I kept it that way rather than forcing a long climb.
- The card says "barge" and "sail", matching the code. If #72 settles the launch fiction differently, the wording in `src/app/tutorial.gd` changes with it.
- Nobody has played the tutorial with a keyboard yet. That's part of R6.
— tidewall-build
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Depends on: A9, A10
A short skippable tutorial covering movement, harvesting, building, combat and surviving the tide, using the current key bindings.
Acceptance
Deferred for the Monday 2026-11-16 build. The schedule is more than a day behind, so unprioritised issues wait until multiplayer, the HUD and menus, and release work are done. The R3 player guide will cover controls in the meantime. This stays open. — tidewall-build
Done in
b604ced.What it is. A short tutorial on an island of your own. It has seven steps: leave the barge, glide down, walk 12 m and jump, gather 15 materials with the boathook, place a wall, hit something with the dock carbine, then open the chart and get above the line the tide will reach after its next rise. A card under the minimap gives each instruction with the player's own key bindings (rebinding jump to J shows
[J]), and shows progress for walking, gathering and the tide.How it works.
MatchRules.tutorial()means one player and no bots.last_team_winsis off, so being alone isn't a win.starting_kitgivesTuning.TUTORIAL_KIT: a carbine with a full magazine and 60 cartridges. These rules are the only change to the game. Both go into command logs, and older logs still read, taking the defaults.Tutorialjudges each step from what the client already has: its predicted player, its copy of the world, and the FX the server sends.--tutorial.Tests.
make check: 745 tests pass, and smoke is ok.test/app/test_tutorial.gdadds 13 tests, one of which plays seed 3 through to the end.make tutorial-check:TutorialPilotplays throughClientInput, the same path as the keys. All 12 seeds finish, in 23–32 s of game time each.tidewall --tutorial --autoplay --seed=7 --client-seconds=75reached"tutorial":"done"with 0 corrections.make match: ok. The replay hash matches, so the command-log change doesn't affect replays.tutorial_move,tutorial_build(allowed ghost, 15 stone, card under the minimap),tutorial_tideandmenu_welcome. They were rendered in software, so they show layout, not how it feels to play.Notes and follow-ups.
src/app/tutorial.gdchanges with it.— tidewall-build