# Packaged Client GPU Startup Visual Test

This test validates the packaged Windows investor demo through the real GPU
desktop path. Do not use QEMU guest-agent screenshots for this gate; they are
useful for administration but cannot prove that the interactive rendered
desktop is visible, focused, or readable.

## Purpose

Run this before calling an investor package visually ready. The test is meant
to catch the problems that headless automation misses: black screens, unfocused
menus, mouse capture problems, startup credits appearing under gameplay, missing
foliage or terrain visuals, and pause/save/quit menu confusion.

## Required Path

- Windows build VM with the packaged demo in `Builds\WindowsDevelopment`.
- Sunshine running on the Windows build VM.
- Moonlight connected to the Windows build VM desktop from a real viewing
  client.
- The packaged demo launched from the investor launcher, preferably
  `Start Agrarian Demo - DX12.cmd`; use the compatibility launcher only when
  validating fallback rendering.

## Capture Set

Save screenshots or a short clip under:

`Saved\VisualQA\GpuStartup\<YYYYMMDD-HHMM>\`

Required evidence:

- `01-startup-credits` - cinematic credits are full-screen and no gameplay
  interaction appears active underneath.
- `02-character-selection` - the UMG character selection segment is readable,
  clickable, and focused.
- `03-server-join` - the server/join segment is readable and separate from the
  character segment.
- `04-loading` - the loading segment is readable and does not show accidental
  gameplay input.
- `05-first-spawn` - first playable view after closing the frontend.
- `06-pause-menu` - Escape opens the pause menu, mouse cursor is visible, and
  gameplay is blocked.
- `07-save-quit` - Save & Quit shows the saving segment before closing.
- `08-terrain` - Ground Zero terrain reads as shaped coastal terrain, not a
  flat tan placeholder.
- `09-vegetation` - grasses, shrubs, bushes, and trees are visible without
  hiding interaction targets.
- `10-water` - the freshwater source reads as collectable water with bank/edge
  dressing.
- `11-campfire` - the campfire reads as a campfire object, not a primitive
  debug shape.
- `12-shelter` - the primitive shelter reads as a shelter object, not primitive
  debug blocks.

Create `visual-startup-check.txt` in the capture folder with:

- package path;
- launcher used;
- capture method, normally Sunshine plus Moonlight;
- tester name;
- pass/fail result;
- notes on visible defects.

## Windows Helper

Run this from the Windows project checkout before the capture session:

```bat
Scripts\RunWindowsGpuStartupVisualCheck.bat --check-tools
```

To print the full capture checklist:

```bat
Scripts\RunWindowsGpuStartupVisualCheck.bat
```

This helper intentionally does not accept QEMU guest-agent screenshot evidence.
It verifies the packaged demo path and Sunshine service, then tells the tester
what real-GPU startup captures to collect.