Files
tidewall/docs/VISUAL_QA.md
T
claudeandClaude Opus 5.5 aa797580a7 #72: The packet ship, the lifeline mortar and the gull-kite
Eric chose option B on #72. The drop is now the GDD's launch:

- A packet ship sails a seeded straight line past the island, offshore,
  as close in as it can while keeping 45 m of open water from any land
  (eight-way probes; up to 32 headings, then the four world sides).
- Jump fires the lifeline mortar along the look heading. How high the
  player aims sets the charge (-10 to 45 degrees: 16 to 110 m/s over
  the ground; every shot climbs at 75 m/s). The climb can't be steered
  and the kite can't open until the arc tops out. Riders still aboard at
  the end are fired towards the middle of the island.
- Drop.reach() mirrors the fall for both ways down (kite at the top, or
  a fall with the kite opening by itself); bots, the soak and autoplay
  clients and the tutorial pilot aim with Drop.aim_charge().
- Bots fire at their landing spot once abeam of it, when in easy reach
  at their own staggered moment, or just before the route ends, and open
  the kite early only when the spot is beyond the rest of a fall.
- Art: VesselModels.ship() (two-masted packet, tanned square sails, a
  salt-white boot-top, a bowsprit and the mortar on its bed, mirrored to
  face the island), the figure's gull-kite (figure.py), and a lifeline
  cord from the muzzle to each player still climbing.
- Renamed barge to ship and wing-sail to gull-kite throughout code,
  tests, captures, docs and the tutorial text. make match now defaults to
  seed 2, where the scripted player still harvests and builds.

Closes #72

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-15 12:49:21 -05:00

4.8 KiB

Visual QA

The checklist for a full visual pass (H6). Render everything with make qa-captures (about 40 minutes, needs Docker), open every image in captures/qa/ and judge it against its line here. The contact sheets in captures/qa/sheets/ are for a first look; open a capture on its own to judge detail. File each defect as a type/bug issue.

Captures are drawn by Mesa's software renderer in a container. They show what is drawn, not how fast, and colours differ a little from a GPU.

The white captions at the top left of the match_*, client_*, quality_* and hud/client_hud* captures are written by the capture scenarios (Godot's default font) to say what the frame is. They are not part of the game's HUD.

The last pass: 2026-11-14

82 scenarios and the HUD at 3840x2160 rendered; all were viewed. Two defects were found and fixed:

  • H15 (#84): a camera placed after the view's last sync kept the murk of where it had been. match_tide came out as a flat teal frame, and match_final and match_results drew dry land in the underwater murk. In the game this was one frame of the wrong murk at every camera cut.
  • H16 (#85): the terrain grid's square edge showed in the sea from the air, as a pale square round the island in the lobby view.

Checklist

Area Captures What to check 2026-11-14
Menus menu_main, menu_practice, menu_join, menu_settings, menu_settings_mouse, menu_pause, menu_results Paper panels over the sea and tide post; every label readable; the version line; focus outline on the first button; nothing clipped. Pass
Lobby match_lobby The whole island from the air, sea round it with no square edge. Pass after H16
The drop match_ship, client_ship, match_glide, client_glide, vessels The packet ship and its 24 passengers offshore; the gull-kite held overhead; the island below. Pass
Landing match_landed, client_landed, quality_low, quality_medium, quality_high The player on the shoulder camera, a sea chest, a building's inside. The three presets differ in shadow and detail, not in what's there. Pass
Biomes props_beach, props_forest, props_highland, props_overview, props_crate, props_felled, terrain, terrain_lod, sea_shore_calm Sand with wet patches and beached boats, pine forest, highland stone and boulders, the marsh flats at low tide. Pass
Points of interest poi_hamlet, poi_dock, poi_lighthouse, poi_quarry, poi_salt_works, poi_shrine, style_* Each reads as its place; the woodcut print pass (outlines, hatching) on, and off in the _plain captures. Pass
Building build_fort, build_fort_side, build_states, client_build, client_build_refused, client_hud_build, match_built, client_basin Every material and state; the ghost green when it can go and red with the reason when it can't; a breakwater basin dry inside at high water. Pass
Players and items figure_states, figure_actions, figure_close, items_held, items_shoulder, items_ground, items_tiers, items_kegs Coats in every colour, every pose, items in hand and on the ground, tier marks. Pass
Combat effects_fight, effects_blast, effects_work, effects_stress Muzzle flash at the muzzle, the hit marker round the reticle, the keg blast and collapse dust, tracers in the stress scene. Pass
HUD client_hud, hud_2160 (CAPTURE_SIZE=3840x2160) Tide plaque, health and armour, the six slots, materials, the feed and count, crisp at 4K. Pass
Chart chart_first, chart_later Place names, the ship's line, the next tide's land hatched, the minimap. Pass
Each tide phase sea_tide_0 … sea_tide_7, water_flood, water_shore The sea rising phase by phase to nothing left; the storm building to a gale with rain; flooding following the terrain. Pass
The gale and under water sea_shore_gale, sea_underwater, match_final Rain, dark sea and whitecaps; the murk and the bright ceiling only when the camera is under the sea. Pass after H15
Results match_tide, match_results The drowned island from the lobby's viewpoint; the last players on the highest ground. Pass after H15
Camera tests camera, camera_aim, camera_wall, canopy, canopy_before Test cards for the camera rig, drawn with plain shapes on purpose; check the framing, not the art. Pass
Terrain tests terrain_cracks, terrain_cracks_control Magenta shows through gaps: the control must crack and the real terrain must not. Pass

Placeholders

Nothing the game draws is a stand-in. test_world_art fails on any primitive mesh or placeholder resource under src/ or assets/. The plain shapes in the camera* scenarios are test cards under test/capture/, which isn't shipped.