T2 tutorial: all five chapters with Old Tam, scripted dusk and demo wolf, rabbits for the hunt, title-screen Tutorial entry, pause-menu skip/leave, goodbye card; full bot playthrough test

This commit is contained in:
Paul Bailey
2026-11-05 14:43:00 +00:00
parent 5b5dd3d609
commit f93ebe1bea
11 changed files with 976 additions and 36 deletions

View File

@@ -1,7 +1,33 @@
# Tutorial world design
Status: **T1 built** (the Guide, Actions' events, chapter 1 in
data/tutorial.json, the guide panel and marker); T2-T4 are proposals.
Status: **T1 and T2 built**: the whole tutorial, on the Valley island
(seed 1337), with Old Tam the hermit. T3 (its own island) and T4 (hints in
real worlds) are proposals.
*As built in T2:*
- All five chapters, 22 steps (data/tutorial.json), in Old Tam's voice:
first tools; fire and food (campfire, berries, a roasted mushroom, the
diet bars); hunting (workbench, a weapon, a rabbit, butcher and cook,
a tip about the other animals); fishing (rod, a catch, grilled); shelter
and night (a hut you can stand inside, a bed and spawn, nightfall and a
torch, the demo wolf, sleeping).
- More goals: `any` (club or spear, perch or trout), `shelter`,
`bed_spawn`, `demo_wolf`, `continue` (Enter on the reading steps).
- Step set-ups: the clock jumps to dusk (18:36) and to bedtime (21:00);
three rabbits appear 14 m off for the hunt; the demo wolf
(scripts/creatures/tutorial_wolf.gd) circles at 11 m for 18 s and slinks
off, never biting.
- Markers for berry bushes, rabbits, the carcass, the lake shore.
- The tutorial island is calm: no wolf pack, no bear, no thieves.
- Title screen: **Tutorial** above New World (it says "carry on" once
started; with no worlds yet: "New here? Try the tutorial"). Pause menu:
Skip this step, Leave the tutorial (saved, carry on later).
- The end: Old Tam's goodbye card, **Start your own world** (to the New
World page) or **Keep exploring**.
- tests/test_tutorial_full.gd: a bot plays all 22 steps through Actions,
in order, to the card. (Bulk materials, like a hut's wood, go straight
into its bag; every goal is done as a player does it.)
- Not yet: a ghost outline for the hut (§2 step 17), sounds for the tick.
*As built in T1:*
- Actions has signals for what players do: `crafted`, `harvested` (with