Skip to content

VectorXR 0.20.2: guides, and crash fixes for Virtual Desktop and DLSS 5 mods - #140

Merged
mdiener87 merged 8 commits into
masterfrom
0.20.2
Nov 14, 2026
Merged

mdiener87 merged 8 commits into
masterfrom
0.20.2

Conversation

@mdiener87

Copy link
Copy Markdown
Collaborator

Requested by Michael · project thread

VectorXR 0.20.2: a fix release for 0.20.1 with an in-app Guides page. Supersedes #139.

Changes

  • Crash fixes from Fix re-entering VR crash (#138) and startup crash with DLSS 5 mod layers #139. Every function taken from the runtime's instance is dropped with it, so a game that starts VR again no longer calls into an unloaded runtime (issue 138, MSFS 2024 on Virtual Desktop). A layer above VectorXR that asks for a function before any instance exists (Cheeky Foveated DLSS) gets XR_ERROR_HANDLE_INVALID instead of a call through an empty pointer. The log names Cheeky's layer and its position.
  • Guides page. Ported from the forward branch for features that ship in 0.20: start, anti-cheat, Quadviews, Turbo, Frame Generation, Pivot, Depth and the OSD, with animated walkthroughs, in all 11 languages. Each enhancement page links to its guide, and a guide opened that way leads with Back to that page.
  • Patreon promotion, off by default. community.json gains a patreon entry (enabled, url, optional message). Home and About show a Patreon button beside Ko-fi only while it is enabled with an https patreon.com page; a missing entry or failed fetch hides it. A local community.override.json previews it. See docs/community-config.md.
  • Version 0.20.2 and release notes (release/notes/v0.20.2.md).

Testing

  • App: 155 unit tests, vue-tsc, cargo check; Guides navigation and the Patreon button checked in a headless browser with and without the config.
  • Layer: Release build, 48/48 tests.
  • Flown Nov 13: MSFS 2024 on Virtual Desktop, several VR exits and re-entries without a crash; DCS with Turbo on PimaxXR and on SteamVR (lighthouse), no problems.

🤖 Generated with Claude Code

mdiener87 and others added 8 commits November 12, 2026 11:36
…s layer

Issue 138: MSFS 2024 crashed re-entering VR on Virtual Desktop. 0.20.1
stamps the runtime's clock just before xrCreateSession (dab7806), through
xrConvertWin32PerformanceCounterToTimeKHR taken at the previous session.
That pointer outlived its instance; after xrDestroyInstance the runtime's
DLL is unloaded, so the next xrCreateSession called into unmapped code
(the crash dump's faulting call is that clock call in the signed 0.20.1
DLL). Every function taken from the runtime's instance now goes with it
(the clock, xrGetInstanceProperties, xrGetVisibilityMaskKHR,
xrPathToString, xrGetCurrentInteractionProfile and the chain's
xrGetInstanceProcAddr), and the clock is taken again for each instance.

DLSS 5 mods: a layer above VectorXR that asks for a function before any
instance exists (Cheeky Foveated DLSS's layer probes
xrEnumerateInstanceExtensionProperties that way) made VectorXR call
through an empty pointer, so the game crashed at startup whenever such a
layer was above it. It now gets XR_ERROR_HANDLE_INVALID, which such
probes treat as unknown.

The log names Cheeky Foveated DLSS's OpenXR layer above or below
VectorXR, and its in-game modules. Above, it takes the application's
quad-view request for its own quad views, and the Quadviews INACTIVE line
now says so instead of pointing at the game's setting.

Test: layer_load. A function asked for before any instance, and after
the last instance is destroyed, is refused with no call below; an
instance above Cheeky's layer logs it. The framegen presenter timing
tests (pacing, ceiling, policy_late) failed on this run with Star Citizen
holding the CPU at 100%; unrelated to this change.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The clock conversion was also taken at instance creation, which gave an
instance's first xrCreateSession a runtime clock stamp it did not have in
0.20.1, and with it the clock-based stale-event check instead of the
first-IDLE fallback. Only the clearing is needed for issue 138; the
clock is again taken at the session's Turbo setup, so first sessions
behave exactly as in 0.20.1.

Test: layer_load, eye_gaze, turbo_frame, turbo_trace, turbo_recovery.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Ports the in-app guides and walkthroughs from the forward branch for what
0.20 already ships: the start guide, anti-cheat, Quadviews, Turbo, Frame
Generation, Pivot, Depth and the On-Screen Display. The Performance Crop,
Sharpening & Color and Screenshots guides stay behind until those features
ship. Each enhancement's page links to its guide.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
community.json gains a patreon entry (enabled, url, optional message, one
string or one per language). The button shows on Home and About only while
it is enabled with an HTTPS patreon.com page; a missing entry, a failed
request or anything invalid hides it. The published entry starts disabled.

A community.override.json beside settings.json replaces the published
config's fields, so a build can preview the promotion before it is
published.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
On Home the promotion is a third titled column beside Discord and Ko-fi,
with every column's button aligned along the bottom. On About its button
matches Ko-fi's.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…l badges

A guide opened by an enhancement page's "Read the guide" link now leads with
"Back to <page>", with All guides on the right. Opened from the Guides page,
it keeps All guides and Open <page>. Quadviews and Frame Generation no longer
carry an Experimental badge in the guides.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Leaving the Guides page closes the open guide, so the sidebar's Guides
always shows the list. A "Read the guide" link still opens its guide.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@mdiener87
mdiener87 merged commit 3f1e174 into master Nov 14, 2026
4 of 6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant