2.9 KiB
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:
Scripts\RunWindowsGpuStartupVisualCheck.bat --check-tools
To print the full capture checklist:
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.