[mitch030504]

Requested by Mitch · project thread

Before: the Steam Frame install script could only build the base game. The headset's eye resolution was fixed at render_scale and could not drop when frames fell behind. A scene load could abort the game while building a shader for a draw that had no position data.

After: steam-frame-install.sh --retro-rewind downloads, keeps up to date, builds and installs Retro Rewind beside the base game. A new, experimental [vr] adaptive_resolution setting (off by default) lowers the race's eye resolution to as little as 70% while new frames fall behind 60 FPS, then raises it again. The scene-load abort is fixed.

All three come from heurazy/Wiicompiled_VR-PLUS, adapted to this fork.

How

• Scene-load crash (from VR-PLUS c2b2500): Nintendo's GXClearVtxDesc, and Aurora's own version (GXGeometry.cpp:222), leave the position descriptor set to direct. The HLE mirror in gx_vertex.cpp cleared it instead. It now matches them, and the shader generator uses a zero position if a stream still arrives without one.
• Retro Rewind: the script follows the steps of the Quest app's RetroRewindPack.kt.
  • It downloads the full pack once, then applies each published update followed by that update's deletions, and writes version.txt last.
  • Deletions only touch paths inside RetroRewind6/. Paths that climb out with .. are refused.
  • It fetches the Retro-WFC payload on every build and keeps the previous one if rwfc.net doesn't answer.
  • It builds both games with --profile both, copies the pack to the Frame only when its version changed, sets [paths] retro_rewind_root, and adds RetroRewind to the Steam library.
  • --retro-rewind-pack DIR uses a folder you already have instead of downloading.
• Adaptive resolution: runtime/include/vr/adaptive_resolution.h decides the scale once a second. A second below 85% of the target lowers the scale by 0.1, and three seconds in a row at the target raise it again. It only measures during races.
  • The eyes render into the top-left corner of the existing swapchain image, and the projection layer's imageRect shows only that corner. The compositor does the upscaling and no swapchain is recreated.
  • The Linux same-device bridge (vulkan_win32_interop.cpp) now copies an eye that is smaller than its target. The Quest bridge and layer already supported this.
  • Windows (D3D12) copies whole eyes, so the setting isn't offered there.
• Not ported: VR-PLUS's fix for the headset going black during race transitions. In this fork, a dropped packet is cancelled after 50 ms (TryCancelPendingPacket), so the 10-second stall it fixes does not happen here.

Testing

• vr_adaptive_resolution_tests (new) and vr_config_tests pass.
• openxr_integration.cpp, openxr_vulkan_win32.cpp and settings_overlay.cpp pass a clang -fsyntax-only check for Linux.
• The Retro Rewind download and update logic ran against a local stand-in for the server. It installed the full pack, applied two updates and their deletions, refused a .. path, and did nothing on a second run.
• shellcheck reports no warnings on the install script.
• Not tested: a full build, anything on the headset, or the real rwfc.net server, which the build sandbox can't reach.
  • VR-PLUS says that server rejects clients without Wheel Wizard's user agent. Like the Quest app, the script sends none, so the first --retro-rewind run will show whether that matters.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Sabhzu6VgoWcHtpSk4C9KZ

---

Generated by Claude Code