Main menu, practice against bots, join and server list, results, and settings for key bindings, mouse, graphics, audio and display, saved between launches.
Acceptance
Every menu is reachable and navigable in an automated UI test.
Key rebinding detects conflicts.
Corrupt settings files fall back to defaults.
**Depends on:** A1, N6
Main menu, practice against bots, join and server list, results, and settings for key bindings, mouse, graphics, audio and display, saved between launches.
**Acceptance**
- Every menu is reachable and navigable in an automated UI test.
- Key rebinding detects conflicts.
- Corrupt settings files fall back to defaults.
claude
added this to the v0.6 Art, Audio and UI milestone 2026-11-09 05:28:44 +00:00
With a window and no mode given, the game opens on a main menu: Practice against bots (bot count and skill), Join a server (address, or a LAN search listing compatible servers), Settings, Quit.
In a match, Escape opens a pause menu (the match carries on, since even offline it's a live server) with Settings and Leave. When a match the player was in ends, a results screen shows their place, eliminations and the last lines of the feed, with "Stay and watch" or "Back to the main menu".
KeyBindings: every action can be rebound to a key or mouse button. bind() refuses an input another action already uses and names that action, and the menu says so ("W is already used for Forward"). Escape is reserved. ClientInput now reads keys through the bindings.
GameSettings saves bindings, mouse, graphics (quality preset: shadow distance and 3D render scale, and the woodcut print pass on or off), audio (Master, Music and Effects buses, made if missing, for A8), display (window mode, vsync, frame cap), the player's name, last server and practice choices in user://settings.cfg. Old mouse-only files still load.
AppShell runs the menus and the session. The menus use the paper-and-ink look from STYLE.md with a brass focus edge (new palette colour GILT_DEEP), over a drawn sea and tide post, or over an ink wash during a match.
test/ui/test_menus.gd: every screen reached from the main menu and back; each screen takes keyboard focus on its own controls; arrow keys walk the main menu; Escape goes back; rebinding through the menu refuses a clash and saves a good key; settings controls change and save the file; practice and join emit what was asked (bad addresses refused, other-version servers can't be joined); AppShell goes main menu → practice match → pause → settings → back → resume → leave; and a real offline match ending shows "Last on dry ground" with 1 elimination.
test/client/test_key_bindings.gd: defaults, rebinding, clashes, reserved and invalid inputs, clash repair on load, rebound keys driving ClientInput.
test/client/test_game_settings.gd: full round trip; missing file and three kinds of corrupt file give defaults; wrong types, NaN and out-of-range values fall back one value at a time.
Captures (make menu-captures, software rendering, all opened and checked): main, practice, join with a server list, settings (controls and mouse tabs), pause and results. The first renders had zero-sized panels (anchors set outside the tree) and slider tracks with no height; both are fixed.
Not covered: gamepad navigation is A13. Display settings (window mode, vsync, frame cap) are applied but can't be checked headless or in the capture container, and nobody has used the menus with a real mouse yet; that's part of R6.
— tidewall-build
Done in c504551.
**What changed**
- With a window and no mode given, the game opens on a main menu: Practice against bots (bot count and skill), Join a server (address, or a LAN search listing compatible servers), Settings, Quit.
- In a match, Escape opens a pause menu (the match carries on, since even offline it's a live server) with Settings and Leave. When a match the player was in ends, a results screen shows their place, eliminations and the last lines of the feed, with "Stay and watch" or "Back to the main menu".
- `KeyBindings`: every action can be rebound to a key or mouse button. `bind()` refuses an input another action already uses and names that action, and the menu says so ("W is already used for Forward"). Escape is reserved. `ClientInput` now reads keys through the bindings.
- `GameSettings` saves bindings, mouse, graphics (quality preset: shadow distance and 3D render scale, and the woodcut print pass on or off), audio (Master, Music and Effects buses, made if missing, for A8), display (window mode, vsync, frame cap), the player's name, last server and practice choices in `user://settings.cfg`. Old mouse-only files still load.
- `AppShell` runs the menus and the session. The menus use the paper-and-ink look from STYLE.md with a brass focus edge (new palette colour `GILT_DEEP`), over a drawn sea and tide post, or over an ink wash during a match.
**Tests** (`make check` passes: 548 tests, self-check, smoke)
- `test/ui/test_menus.gd`: every screen reached from the main menu and back; each screen takes keyboard focus on its own controls; arrow keys walk the main menu; Escape goes back; rebinding through the menu refuses a clash and saves a good key; settings controls change and save the file; practice and join emit what was asked (bad addresses refused, other-version servers can't be joined); AppShell goes main menu → practice match → pause → settings → back → resume → leave; and a real offline match ending shows "Last on dry ground" with 1 elimination.
- `test/client/test_key_bindings.gd`: defaults, rebinding, clashes, reserved and invalid inputs, clash repair on load, rebound keys driving `ClientInput`.
- `test/client/test_game_settings.gd`: full round trip; missing file and three kinds of corrupt file give defaults; wrong types, NaN and out-of-range values fall back one value at a time.
**Captures** (`make menu-captures`, software rendering, all opened and checked): main, practice, join with a server list, settings (controls and mouse tabs), pause and results. The first renders had zero-sized panels (anchors set outside the tree) and slider tracks with no height; both are fixed.
**Not covered:** gamepad navigation is A13. Display settings (window mode, vsync, frame cap) are applied but can't be checked headless or in the capture container, and nobody has used the menus with a real mouse 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: A1, N6
Main menu, practice against bots, join and server list, results, and settings for key bindings, mouse, graphics, audio and display, saved between launches.
Acceptance
Done in
c504551.What changed
KeyBindings: every action can be rebound to a key or mouse button.bind()refuses an input another action already uses and names that action, and the menu says so ("W is already used for Forward"). Escape is reserved.ClientInputnow reads keys through the bindings.GameSettingssaves bindings, mouse, graphics (quality preset: shadow distance and 3D render scale, and the woodcut print pass on or off), audio (Master, Music and Effects buses, made if missing, for A8), display (window mode, vsync, frame cap), the player's name, last server and practice choices inuser://settings.cfg. Old mouse-only files still load.AppShellruns the menus and the session. The menus use the paper-and-ink look from STYLE.md with a brass focus edge (new palette colourGILT_DEEP), over a drawn sea and tide post, or over an ink wash during a match.Tests (
make checkpasses: 548 tests, self-check, smoke)test/ui/test_menus.gd: every screen reached from the main menu and back; each screen takes keyboard focus on its own controls; arrow keys walk the main menu; Escape goes back; rebinding through the menu refuses a clash and saves a good key; settings controls change and save the file; practice and join emit what was asked (bad addresses refused, other-version servers can't be joined); AppShell goes main menu → practice match → pause → settings → back → resume → leave; and a real offline match ending shows "Last on dry ground" with 1 elimination.test/client/test_key_bindings.gd: defaults, rebinding, clashes, reserved and invalid inputs, clash repair on load, rebound keys drivingClientInput.test/client/test_game_settings.gd: full round trip; missing file and three kinds of corrupt file give defaults; wrong types, NaN and out-of-range values fall back one value at a time.Captures (
make menu-captures, software rendering, all opened and checked): main, practice, join with a server list, settings (controls and mouse tabs), pause and results. The first renders had zero-sized panels (anchors set outside the tree) and slider tracks with no height; both are fixed.Not covered: gamepad navigation is A13. Display settings (window mode, vsync, frame cap) are applied but can't be checked headless or in the capture container, and nobody has used the menus with a real mouse yet; that's part of R6.
— tidewall-build