Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/booth-runbook.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ Booth mode itself runs fullscreen and ignores the menu's **Quit Game**. A game n
| The game freezes | The watchdog restarts it within about a minute. |
| Someone presses Cmd+Q | The game closes, and the watchdog opens it again. |
| The player's controller disconnects | The game pauses and asks for the controller. Plug it back in, or press Start on another controller. |
| You want to clear the Endless Runner scores | Start the Endless Runner tile, pause (Esc or Start) and choose **Leaderboard → Reset scores**, then **Reset** to confirm. |
| You want to clear a game's scores | Start that game's tile, pause (Esc or Start) and choose **Leaderboard → Reset scores**, then **Reset** to confirm. Each game has its own board. |

## Stop the game for maintenance

Expand Down
4 changes: 2 additions & 2 deletions docs/enchanted-repo.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ The 5,300-pixel route has three gaps (160–170 px), six solid raised root platf

Branches support Hoppy until 0.7 seconds after landing, then remove collision, show breaking/falling art, and regrow after a 0.25-second break plus 3.5-second absence. Regrowth waits if Hoppy occupies the future platform shape. Pause freezes all timers. Branches over gaps provide stepping stones; falling into a pit still kills Hoppy through the normal retry flow.

Comment traps and Spaghetti Code Vines use 2.0 seconds dormant, 0.9 seconds amber warning, 0.45 seconds active, and 1.55 seconds recovery. Only active intervals damage. Comment traps mark a 64×130 vertical region. Vines mark a 155×48 low horizontal region on their fixed attack side; jump over it or wait. Rectangular cues show actual damage extents. Vines are environmental hazards in v1, not destructible enemies.
Comment traps and Spaghetti Code Vines use 2.0 seconds dormant, 0.9 seconds amber warning, 0.45 seconds active, and 1.55 seconds recovery. Only active intervals damage. Comment traps damage a 64×130 vertical region. A vine stands on its root and lashes out 120 px to its fixed attack side (a 140×48 low band that the `vine_whip` frame covers, anchored by its root rocks so the tentacle reaches over the band instead of the sprite jumping sideways); jump over it or wait. The warning and whip frames are the only cues; no rectangle is drawn over the art. Vines are environmental hazards in v1, not destructible enemies.

Nitpick Gnomes have 1 HP, a short patrol, a 0.6-second jab tell and 0.65-second recovery. Bloat Trolls have 2 HP, slower patrols, a 0.95-second club tell and 1.0-second recovery. Both attacks stay committed to the warned side, have a 0.22-second active interval, and disable contact damage during recovery. Ordinary kills award 100 points and tokens award 25. Auto-Fix defeats nearby ordinary enemies but excludes the boss. Shared shields, 1.2-second post-hit invulnerability, player movement, jump buffering, coyote time, pause, and results are unchanged.

Expand All @@ -32,7 +32,7 @@ The Monolith has **3 outer-armor hits + 3 inner-armor hits + 6 core hits**. Ordi
| Dependency Sweep | 0.9s committed direction tell, 0.25s low sweep reaching 215px, 1.4s recovery |
| Regression Stomp | 1.0s raised-foot tell, 0.2s local impact within 95px, one 260px/s ground shockwave, 1.6s recovery |

Slow tracking intervals separate attacks. The boss stays between x=4350 and 4810, and stops advancing within 160px of Hoppy. Jumping clears the low attacks. Damage remains one heart; reach, commitment and knockback provide the heavy impact. The wave uses Orbital's terrain/player collision and swept movement ray, expires after four seconds, and respects shields/i-frames. The independently generated armor sheets use adjusted offsets/scales to keep feet and approximate body height consistent.
Slow tracking intervals separate attacks. The boss stays between x=4350 and 4810, and stops advancing within 160px of Hoppy; while it advances it plays its `walk` cycle (four frames per sheet, added by `tools/build_monolith_walk.py` from the idle poses: a lean to each side about the feet with a lift between them) and stands on `idle` once close. Attack telegraphs are the warning poses themselves; no outline is drawn over the art. Jumping clears the low attacks. Damage remains one heart; reach, commitment and knockback provide the heavy impact. The wave uses Orbital's terrain/player collision and swept movement ray, expires after four seconds, and respects shields/i-frames. The independently generated armor sheets use adjusted offsets/scales to keep feet and approximate body height consistent.

Defeat awards 1,000 points once, leaves the final rubble pose, clears projectiles, opens the gates, restores the following camera, resumes traversal music, and unlocks MERGE. HP, armor and timers are per-instance; SpriteFrames resources are never mutated.

Expand Down
6 changes: 3 additions & 3 deletions docs/main-menu.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,12 +66,12 @@ The first time a visitor enters a game, `AppRouter.go()` opens that game's how-t

All six games share one pause menu, `app/pause_menu.gd`, built in code in the hub's style (`menu_style.gd`, the how-to-play card's panel colours, outlined text). Esc, P or Start opens and closes it; a game pauses itself (the tree, or its own state machine) and calls `open()` / `close()`, so each game keeps its pause rules, its focus-loss pause and ControllerService's pad-disconnect pause, which synthesizes the same `pause` action.

- **Buttons.** **Resume**, **Restart**, **How to Play**, **Main Menu**; the Endless Runner adds **Leaderboard** before Main Menu. Up and down wrap (arrows, D-pad, stick), Enter or the pad's bottom button confirms, mouse hover focuses and a click presses. The menu binds neither `pause` nor `ui_cancel` itself: Esc is both actions and the game owns the toggle, so the pad's B does nothing on the menu and Start or Esc resumes. The first press of Restart or Main Menu locks every button until the router's fade has carried the player away.
- **Buttons.** **Resume**, **Restart**, **How to Play**, **Leaderboard**, **Main Menu**, the same in every game. Up and down wrap (arrows, D-pad, stick), Enter or the pad's bottom button confirms, mouse hover focuses and a click presses. The menu binds neither `pause` nor `ui_cancel` itself: Esc is both actions and the game owns the toggle, so the pad's B does nothing on the menu and Start or Esc resumes. The first press of Restart or Main Menu locks every button until the router's fade has carried the player away.
- **Restart** reloads the game's own route (a fresh scene; the how-to-play card doesn't reappear because the visitor has seen it). **Main Menu** runs the game's leave path (stop its music, cancel its sequences) and ends in `AppRouter.go("hub")`. The platformer stays paused under the router's fade and the router unpauses the tree once the hub is in; the brawlers and the runner unpause first, as before.
- **Results stay the games' own.** The platformer's MERGE SUCCESSFUL / BUILD FAILED overlay offers **Retry <level>** and **Main Menu**; the brawlers' REVIEW FAILED and victory screens and the runner's CAUGHT BY THE BACKLOG screen offer their retries and **Main Menu**. The Code City opening story's bar has **Main Menu** too.
- **Runner leaderboard.** **Leaderboard** opens `scenes/runner/ui/leaderboard_panel.gd` over the paused run: the local top ten with medals, **Reset scores** (a confirmation asks first; a failed reset reloads the rows from disk and says so) and **Close**. Esc, B or Start inside the panel closes the confirmation first, then the panel, and never reaches the run's pause toggle; focus returns to the Leaderboard button. The game-over screen keeps showing the top ten.
- **Leaderboards.** Every game keeps a local top ten. `app/leaderboards.gd` maps a route to its board (`user://leaderboards/<route>.cfg`; the runner keeps `user://leaderboard.cfg`) on the runner's leaderboard engine (`scenes/runner/systems/runner_leaderboard.gd`: validated rows, atomic writes with a `.bak`, a schema version). A finished run is recorded where the game ends it: the platformers' results overlay, the brawlers' REVIEW FAILED and victory screens, and the runner's game over as before; a placing shows there as **LEADERBOARD #n**. A booth has no keyboard within reach, so those five games name a run `Hoppy hh:mm` after the time it finished; only the runner has name entry. **Leaderboard** on the pause menu opens `app/leaderboard_panel.gd` over the paused game: the game's top ten with medals, **Reset scores** (a confirmation asks first; a failed reset reloads the rows from disk and says so) and **Close**. Esc, B or Start inside the panel closes the confirmation first, then the panel, and never reaches the game's pause toggle; focus returns to the Leaderboard button. The runner's game-over screen keeps showing its top ten. A headless suite (anything run with `--script`) records to a scratch folder of its own (`user://test_leaderboards_<pid>/`, emptied the first time the run uses it and removed by `Leaderboards.clear_scratch()`) unless it sets `Leaderboards.override_dir`; the runner's default `leaderboard_path` comes from the same mapping, so a suite run by hand never touches a player's boards in any game. `tools/tests/run_tests.py` isolates `user://` entirely anyway.
- **Audio.** The menu plays the hub's UI blips (`AudioService.sfx` processes while the tree is paused) and touches nothing else: pausable music stops with the tree as before.
- **Tests.** `tests/pause_menu.gd` opens the menu in all six games through the `pause` action and checks the buttons, focus wrap, Resume, Restart, Main Menu (hub, unpaused, hub music), the How to Play card and, for the runner, the leaderboard panel. `tests/menu_return_layout.gd` returns from Bay Area Blitz through the pause menu and the results; `tests/runner_visual_smoke.gd` drives the runner's leaderboard and Reset scores flow.
- **Tests.** `tests/pause_menu.gd` opens the menu in all six games through the `pause` action and checks the buttons, focus wrap, Resume, Restart, Main Menu (hub, unpaused, hub music), the How to Play card and, for the runner, the leaderboard panel; `tests/leaderboards.gd` covers the per-game boards and the shared panel. `tests/menu_return_layout.gd` returns from Bay Area Blitz through the pause menu and the results; `tests/runner_visual_smoke.gd` drives the runner's leaderboard and Reset scores flow.

![Runner leaderboard panel over a paused run](previews/pause-menu-runner-leaderboard.png)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -41,3 +41,7 @@ Use case: precise-object-edit. Fix sprite sheet packing ONLY. Preserve every one
## monolith_armor correction

Use case: precise-object-edit. Reformat this sheet into a SQUARE image, exact 4 by 4 grid. Keep these EXACT 16 poses and their order, same stone golem identity, pixel-art style, armor stages and colors. Each square cell must have HUGE empty transparent margins: character and effects occupy ONLY THE CENTRAL 60% of each cell's width AND height. Uniform small character size. Rows separated by large completely transparent horizontal bands. Columns separated by large completely transparent vertical bands. This is a game sprite atlas, NOT a full-bleed illustration. No character part or debris may enter another cell. Background truly transparent. Do not add text, gridlines or labels.

## legacy_monolith and monolith_armor walk rows

Not generated: `tools/build_monolith_walk.py` (November 2026) appends one `walk` row of four frames to `legacy_monolith.png` and `cracked_walk` / `bare_walk` rows to `monolith_armor.png`, each frame the matching idle pose leaned 3° about the pivot (left, up, right, up) with a 5 px lift on the off-steps, nearest-neighbour and re-thresholded so the pixels stay crisp. The manifest and both `.tres` files list them; the script is deterministic and leaves a sheet that already has its rows alone.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
[gd_resource type="SpriteFrames" load_steps=26 format=3]
[gd_resource type="SpriteFrames" load_steps=30 format=3]

[ext_resource type="Texture2D" path="legacy_monolith.png" id="1"]

Expand Down Expand Up @@ -122,6 +122,26 @@ atlas = ExtResource("1")
region = Rect2(576, 960, 192, 192)
filter_clip = true

[sub_resource type="AtlasTexture" id="F24"]
atlas = ExtResource("1")
region = Rect2(0, 1152, 192, 192)
filter_clip = true

[sub_resource type="AtlasTexture" id="F25"]
atlas = ExtResource("1")
region = Rect2(192, 1152, 192, 192)
filter_clip = true

[sub_resource type="AtlasTexture" id="F26"]
atlas = ExtResource("1")
region = Rect2(384, 1152, 192, 192)
filter_clip = true

[sub_resource type="AtlasTexture" id="F27"]
atlas = ExtResource("1")
region = Rect2(576, 1152, 192, 192)
filter_clip = true

[resource]
animations = [
{"frames": [{"duration": 1.0, "texture": SubResource("F0")}, {"duration": 1.0, "texture": SubResource("F1")}, {"duration": 1.0, "texture": SubResource("F2")}, {"duration": 1.0, "texture": SubResource("F3")}], "loop": true, "name": &"idle", "speed": 4.0},
Expand All @@ -139,5 +159,6 @@ animations = [
{"frames": [{"duration": 1.0, "texture": SubResource("F18")}], "loop": false, "name": &"armor_break", "speed": 5.0},
{"frames": [{"duration": 1.0, "texture": SubResource("F19")}], "loop": true, "name": &"exposed", "speed": 4.0},
{"frames": [{"duration": 1.0, "texture": SubResource("F20")}], "loop": false, "name": &"core_hurt", "speed": 8.0},
{"frames": [{"duration": 1.0, "texture": SubResource("F21")}, {"duration": 1.0, "texture": SubResource("F22")}, {"duration": 1.0, "texture": SubResource("F23")}], "loop": false, "name": &"defeat", "speed": 4.0}
{"frames": [{"duration": 1.0, "texture": SubResource("F21")}, {"duration": 1.0, "texture": SubResource("F22")}, {"duration": 1.0, "texture": SubResource("F23")}], "loop": false, "name": &"defeat", "speed": 4.0},
{"frames": [{"duration": 1.0, "texture": SubResource("F24")}, {"duration": 1.0, "texture": SubResource("F25")}, {"duration": 1.0, "texture": SubResource("F26")}, {"duration": 1.0, "texture": SubResource("F27")}], "loop": true, "name": &"walk", "speed": 6.0}
]
Loading
Loading