STAR FOX ENHANCED - PCVR DEVELOPMENT BUILD

Requires a Vulkan-capable GPU and an active OpenXR runtime. For Valve Index,
start SteamVR and select it as the active OpenXR runtime. Connect and wake
your headset/controllers before launching starfox_pcvr.exe.
An SDL-compatible Xbox, PlayStation or other standard gamepad can also be
used: left stick/D-pad steers; A fires, B bombs, X boosts, Y brakes; triggers
roll; Start pauses/opens the menu, Back changes view. Stick sensitivity is
adjustable in OPTIONS. Head tracking still requires the OpenXR headset.

Drag your own supported, unmodified retail Star Fox/Starwing ROM onto
BUILD-ASSETS.bat. The included builder creates Starfox-Assets.BIN beside
starfox_pcvr.exe. The builder and player are from the same build; do not reuse
a BIN from an older package. No ROM, generated BIN or music is included.
Do not distribute those files.

Launch with LAUNCH-PCVR.bat so missing-asset and runtime errors remain visible,
or use:
  starfox_pcvr --bundle "PATH/Starfox-Assets.BIN"
For optional MSU-1 music, put your Starfox-MSU1.PAK beside the executable or
beside the BIN passed with --bundle; it is detected automatically. You can
also pass --msu "PATH/Starfox-MSU1.PAK". Check pcvr-log.txt for the selected
pack and whether the saved startup music setting is ON.
The remaining optional argument is --data-dir "PATH".
Saves, preferences and shader cache are kept in vr-data beside the executable
unless --data-dir is provided. Extract to a writable folder. Existing flat-game
settings/saves are not modified. Ctrl+C in its terminal requests a clean exit.

If the game closes during play:
1. Do not repeatedly relaunch before copying the logs.
2. Copy pcvr-log.txt and vr-data/vr-session.log. Include
   vr-data/vr-session.previous.log if it exists. An explicit --data-dir keeps
   the session logs in that directory instead.
3. Tell us Original or EX, the last stage, headset/OpenXR runtime, GPU,
   approximate time played, settings and whether it closed or only went black.
The launcher keeps any nonzero exit code visible, including negative Windows
exception codes. Session logs persist even if a console window disappears.
Share logs privately if they contain personal file paths. A diagnostic build
collects useful evidence; it does not mean the reported crash is fixed.

This launches the game, not the 120-frame/30-second runtime diagnostic.
The VR startup menu selects Original/EX; headset session duration is unlimited.
Physical Index tracking, controls, comfort and sustained performance still
require validation. Successful compilation does not prove headset compatibility.
