Player guide

Setup

Account risk: this unofficial injector may be detected or blocked by anti-cheat, and account restrictions or a ban are possible. Use at your own risk; there is no publisher approval or account-safety guarantee. Read the risk notice before launching.

Download the beta ZIP (asset WuWa-VR-Launcher.zip), extract it, and open WuWa VR Launcher.exe. Keep the app and python folders beside it. You need your own game, a Windows PC VR headset/runtime, and an Xbox/XInput controller connected to the PC. No separate Python installation is needed.

Which build?

The beta contains one build for game version 3.7: 3.7 + reflection + far lighting fix v2 · 1 Oct 18:17 BST, tested by the owner. It ports the HUD, menus, ultimate-camera fix, Same Pass and the Resonators reflection fix to 3.7, and makes far trees, props and far lighting match between the eyes. Its profile starts with Native Stereo Fix and Same Pass on; the fixes depend on them. Your saved settings are retained; use Reset this build for supplied defaults.

Earlier packages (28 Sep experimental, 26 Sep beta) were made for the previous game version.

Install and launch

1. Extract the whole ZIP to a simple path such as C:/Games/WuWa VR.
2. Start your headset software, then open WuWa VR Launcher.exe.
3. Read the risk notice, choose how you start the game, and click Apply & launch.
4. Accept Windows' prompt, then press Play in the game launcher.
5. In game, L3 + R3 (or Insert) opens UEVR settings. Custom options are under VR → WuWa Controls. Close settings before using gameplay shortcuts.

Actual renders of the launcher page from the private test package, 25 September 2026, in a sample state. It runs only on your PC; your paths and status will differ.

The EXE is unsigned; Windows may warn. Download from this project's GitHub Releases and check the published hash if unsure. Do not disable antivirus or anti-cheat. Injection needs elevation to match the game.

SteamVR / Steam Link headset support does not establish Steam-store injection. The full latest-build headset check and a clean-PC test remain pending.

Simulator or headset: use the two buttons at the top of the launcher with WuWa and the injector closed. This changes OpenXR globally, asks for Windows permission, and applies next launch. Use headset restores the previously saved runtime. Opening the launcher itself does not change it.

The launcher changes your UEVR profile, not game files. Backups are in the launcher's data folder under snapshots.

First-minute recovery

The candidate's supplied profile starts with game UI, Xbox shortcuts, Xbox mouse shortcuts and the shortcut sheet enabled. The 22:37 build keeps the settings it was saved with: game UI and sheet on, Xbox mouse shortcuts off. Both start in the game camera; experimental collision is off.

• L3 + B shows the game UI. A blurred menu with no buttons can simply mean the UI is hidden. The candidate also has Show game UI now in WuWa Controls.
• Enable Xbox mouse shortcuts in WuWa Controls before using mouse/HUD adjustment. Leave Physical gamepad passthrough off to use the mod's shortcuts; passthrough deliberately bypasses them.
• The linked 26 Sep public beta supplies Native Stereo Fix → Enabled off. Newer candidates enable it with a timing correction; use their package guide rather than turning it off. Native Stereo is a separate rendering method setting.
• Start in the ordinary game camera, with the portal and freecam off. Press L3 + A while sitting comfortably to recenter. Increase HUD size separately from world scale.

Make it comfortable

VR → WuWa Controls holds the Xbox shortcuts, camera and HUD controls, with Optional experiments and diagnostics last in the candidate. WindowMode → 6DOF Window controls the portal. LuaLoader → Script UI → WuWa VR comfort controls contains extra camera/HUD bookmarks and resets.

For a personal HUD, choose follow-view and adjust panel size and distance together. For a portal, enable Attach HUD to window and adjust coverage. For a stationary panel, turn follow-view off and recenter where you want it. The sheet's feet position uses the recentered tracking origin, not the game character's feet. See comfort settings.

Switch, undo or remove

UEVR saves its normal settings when the game exits normally. Close the game before switching builds; the launcher refuses while it is running.

• Reset this build (under Recovery on the launcher page) replaces that build's settings with the ones it was supplied with, after a backup.
• Restore my settings from before WuWa VR returns your UEVR profile and injector choice to how they were before the launcher first changed them. The mod's settings stay in a backup, so applying the build later brings them back.
• To remove everything: if the simulator is active, use Use headset first and confirm the displayed runtime no longer points to this package. Then restore your settings, choose Stop launcher, and delete the WuWa VR folder. Delete %LOCALAPPDATA%\WuWa VR Launcher too if you no longer need its backups and logs. UEVR's own log files in its profile folder are left for you to inspect or delete.
• Check package files on the page, or Verify-Package.ps1 in the folder, confirms that no packaged file is missing or changed.

Restore checks the backup's recorded file hashes before changing your active settings. If files are missing or changed, it stops and keeps your current settings. Backups from older packages without a recorded file inventory are kept for manual recovery; they cannot be verified automatically. Keep those backups rather than deleting them or treating their presence as proof that recovery succeeded.

In the development workspace, Start WuWa VR Launcher.cmd opens the fuller diagnostic dashboard instead. It needs Python 3.10+ and is not the player package. A private recovery archive is a verified copy of one checkpoint, not an installer.

If something fails, use troubleshooting. For the next candidate, one short sequence covers the important changes without repeated timed tests.

Controller guide

Actual renders of the supplied in-VR shortcut sheet, not game screenshots. The new HUD toggle is a candidate awaiting headset checks. Open an image at full size or use the searchable text below.

Everyday shortcuts

Camera controls

HUD and mouse adjustment

Using UEVR settings

All Xbox shortcuts

This reference describes the current control set. See the included builds and grouped checklist for build-specific defaults and acceptance status. Bindings were checked against the Lua and native shortcut sheet; this does not establish headset acceptance. Earlier checkpoints can differ. Physical gamepad passthrough bypasses mod shortcuts.

L3 / R3: click the left / right stick. View: two squares. Menu: three lines. Use gameplay shortcuts with UEVR settings closed. Release controls when entering/leaving modes and after returning from Alt-Tab.

Everyday

LB + Y is not rebound by these shortcuts. Flight/grapple selection is the game's behavior. A visible target highlight alone has not proved first-person aim and the game's targeting agree.

HUD/mouse adjustment

Enable Xbox mouse shortcuts in VR → WuWa Controls, close UEVR and press L3 + LB once, then release. Repeat to exit. This latches the mode so you do not need to hold a bumper. The mode starts off at each launch.

The game does not receive ordinary pad input during adjustment. First-person placement remains; freecam motion pauses. Game time continues. With the mode off, menus keep their normal gamepad controls by default. The legacy automatic mouse-in-menus option is separate and starts off.

An amber HUD / MOUSE MODE ON notice appears when the shortcut sheet is hidden. An enabled sheet stays visible during mouse mode and includes the recovery hint; its automatic page chooses page 03. Use L3 + LB to exit, or WuWa Controls → Exit mouse mode now. That button also disables legacy automatic mouse-in-menus. Release all controls before resuming play.

The heading stays HUD / MOUSE MODE. When the optional legacy setting activates the cursor for a detected menu, a smaller note says Activated automatically in this menu: cursor only. HUD distance/height controls are available after entering manual adjustment with L3 + LB.

With game UI hidden, a red recovery hint appears only when a game menu is detected. Ordinary gameplay stays clear. Detection is not guaranteed for every menu, so L3 + B restores the UI even if no warning appears.

First person and fixed camera

In the new First person section, choose keep the full mesh, hide the character or hide supported head bones while retaining the body. Animated head/neck following and the late-position refresh are separate options. Unsupported rigs can fall back; this is not guaranteed universal head tracking.

Full animation rotation → Use game view while either stick moves keeps the preferred stick override, returning to animation after 0.4 seconds neutral. Smooth transition between animation and game view blends that transition over 0.05–0.75 seconds. The 17:30 profile enables it at 0.2 seconds; older saved profiles retain their choice. It also blends reported movement-mode transitions, such as takeoff/landing, when the character exposes that signal. It does not continuously smooth animation or headset tracking. Position updates immediately. The pitch-only legacy option is under Aiming and right-stick pitch. Full animation can still disagree with the game's aim; smoothing is not an aim-alignment fix.

The 20:11 candidate uses the current game-camera angle and matching eye offsets after a game-view handover finishes. Returning to animation starts from the last displayed game view. These repairs have component checks, with headset acceptance pending. Full animation needs Game aim with Decoupled Pitch off. If these conflict, a warning appears beside First person motion and game-view rotation is used. Use game aim for full animation explicitly restores compatible settings; it does not make the game's grapple targeting follow your headset.

Hide head bones; full shadow copy is the supplied default in the 17:30 candidate, following the owner's successful test of the 15:39 version. It rechecks visibility and retries delayed source meshes automatically after a character swap. A failure leaves the ordinary head-hiding mode available; the status reports active shadow copies and pending retries.

For vertical aim, Use right-stick pitch disables the horizon lock and selects game aim. Try headset aim selects UEVR Head aim with player control rotation. These are global UEVR aim settings and change only when selected. Grapple/wing behavior still needs comparison in the game.

Recover your profile controls

Open WuWa Controls → Restore profile settings. Restore supplied profile controls restores the selected build's original camera, first-person/freecam, aim and HUD settings. Restore controls from this launch returns to the settings loaded when this game started, including your saved custom choices. Undo last controls reset restores the settings from before that reset.

Temporary HUD/mouse adjustment turns off in all three cases. Rendering choices, Native Stereo Fix, runtime selection, recording and streamer privacy are outside this reset. An older profile without wuwa-profile-defaults.txt can use launch recovery; the supplied-profile button explains why it is unavailable. These controls are separate from UEVR's factory reset. Settings persist through the usual UEVR save.

Freecam and flight

Choose Freecam movement style in Camera customization, then double R3 to enter or exit. These move your viewpoint; your character remains in the game and is not protected or paused.

Acro recovery: hold LB to pause/disarm; LB + RB levels and stops. Tap RB can disarm. Menus and focus loss disarm it. Double R3 exits. Full acro roll needs its own headset comfort check. Optional collision depends on the scene's traceable geometry and cannot stop physical headset leaning through a wall.

UEVR settings open

Page 04 on the shortcut sheet is a reference to this settings-open context. It is not a second set of gameplay bindings. If scrolling seems absent, release RT and focus the panel. Insert remains a keyboard recovery path.

Differences in the 22:37 Camera + acro checkpoint

The owner-tested build predates the later HUD-input, motion and recovery changes. Some important differences are below; its own shortcut sheet/settings describe the features available in that build.

Check the package guide for the selected build's status; these differences describe the older 22:37 checkpoint, not every baseline or candidate.

HUD and camera comfort

Most settings apply live. A native DLL change needs a restart; adjusting a HUD or camera option normally does not.

When an effect differs between eyes

Start with the selected build's supplied settings. The 28 Sep shared-frame candidate enables Native Stereo Fix, Use Same Stereo Pass and the native timing correction with r.OneFrameThreadLag=0. Earlier profiles differed. BUILD GUIDE.html in the ZIP lists the actual supplied values; saved personal settings take priority. The candidate's remaining visual fixes need a playtest.

WuWa Controls > Stereo rendering compatibility is an optional comparison, not required setup. Use separate-eye renderer selects Synchronized Sequential / Skip Draw. Use native stereo selects the ordinary native path. Both comparison buttons turn Native Stereo Fix off. To recover the settings you had before the comparison, use its Restore button; selecting native alone does not restore NSF. Camera, HUD and Xbox settings are unchanged.

The owner's separate-eye comparison produced a black scene with the HUD still visible, so it is not the recommended route. Opening the section changes nothing; making a selection can pause the image while targets rebuild, and UEVR saves the settings left selected. See UEVR's rendering guide.

Three HUD arrangements

These are still stereo panels with a chosen distance. Following your view is not a promise of zero eye strain. A closer panel is not automatically easier to read: increase its physical size as well, and keep important text away from the extreme edges. The headset is the final check; a flat spectator capture cannot establish comfortable stereo fusion.

Use L3 + B to hide/show the game UI. It also hides menus. Recent builds show the red recovery warning only when a menu is detected, not during ordinary gameplay. Detection cannot cover every menu. Use L3+B or Show game UI now in WuWa Controls to restore it even if no warning appears.

Recenter is not world scale

L3 + A recenters the view. Position reset can be enabled separately. World scale changes the relation between physical head movement and game units, so it can change perceived height and offsets. Keep it steady while tuning first person. Use camera height and forward offset for camera placement, rather than maxing world scale to compensate.

The OpenXR Simulator's Home key resets its own simulated pose. UEVR has a separate origin, and the game has another camera. Resetting one does not reset all three. In the simulator, release mouse capture, focus its preview, press Home, then recenter UEVR. A real headset uses its tracking pose instead.

First person

Use L3+View, then compare walking, sprinting, wing flight and character swaps. The head can be hidden while the body stays visible, but leaning, animation and camera placement can still expose the torso. In the 15:39 control-recovery candidate, use WuWa Controls > First person (older builds placed this in Camera and gameplay controls > Camera customization):

The last three choices sample after animation, before drawing. Full animation calibrates rig axes to the pose where you enter first person; enter while standing neutrally. Choose Animated position for ordinary right-stick aiming. The owner reported that Animated position + stick pitch now tracks sprinting, grappling and wing flight well. The 17:30 candidate preserves that path. In first person, L3 + D-pad Down switches full animation on/off, returning to the previous motion choice. Close UEVR and game menus before using this shortcut.

Under Full animation: stick override, choose exact animation or game view while either stick is active. The owner prefers the latter: animation returns after 0.4 seconds with both sticks neutral. Smooth transition between animation and game view blends that handover. The 17:30 supplied profile enables it at 0.2 seconds; older saved profiles retain their choice. Reported movement-mode changes also trigger a blend. Custom flight states that do not expose a change cannot be detected by this signal. Legacy pitch-only is under Aiming and right-stick pitch. These choices only affect full animation. Its game-view override now uses the blended view's yaw for eye offsets, so walking backward does not turn the offset behind the head while the view stays forward. This has regression checks; game-aim disagreement remains under investigation.

The 20:11 candidate also removes the old camera-angle lag after a handover ends and starts the return blend from the last displayed game view. It retains game-view rotation if global headset/controller aim or Decoupled Pitch conflicts with full animation. The warning beside the motion selector explains how to restore compatible settings without silently changing your global aim choice. This does not establish headset-aligned grapple targeting.

Character visibility is a separate choice. Hide head bones; keep body keeps the visible body but also removes head geometry from the shadow. Its camera reconstructs the head from a visible parent bone, which is an approximation. Hide body; keep original shadows leaves head bones intact for tracking and requests hidden shadows only from components that were visible shadow casters before the mod hid them. It no longer enables unused equipment casters, addressing the reported duplicate wing shadows.

Hide head bones; full shadow copy keeps the body visible and uses a hidden, non-colliding pose copy for the original caster's shadow. The visible head stays hidden. The 15:39 candidate repaired automatic swap handling; the owner subsequently reported this mode working perfectly. The 17:30 profile makes it the default. Unsupported rigs can still fall back. Leaving the mode destroys owned copies and restores the original shadow settings. Visible-body modes can still expose the torso when leaning or during unusual animations; they cannot promise an unbreakable first-person illusion.

The previous Custom controls remain available:

• Follow animated head / neck position follows the supported rig instead of a fixed height. It can introduce animation bobbing.
• Refresh first-person position before drawing (Custom) samples that existing position later in the frame. The other presets do this automatically.
• Keep first person horizon level removes visual pitch. Use the dedicated Use right-stick pitch button if you want the game's vertical camera motion.
• Try headset aim uses UEVR's existing head-aim/control-rotation route. Check actual grapple activation as well as the glow/sound of the target.

If the camera drops inside the body after a swap, return to game camera and back, or swap away/back as the user found helpful. Record the character and movement state if it repeats; do not save a large permanent height offset to compensate for a transient rig problem.

Shortcut sheet

L3+Menu toggles it. Select front placement first to verify visibility; then try feet placement and adjust width, drop, forward distance and tilt. Its anchor is your recentered tracking origin, not your avatar. A desktop spectator view may omit compositor layers. UEVR settings can temporarily take priority over the sheet, so close them to inspect placement. The 17:30 candidate keeps the sheet visible during manual or automatic mouse mode, including with game UI hidden. The amber hint indicates active HUD/mouse mode. The red hidden-UI warning requires a detected menu. When the sheet is hidden, those same conditions can show standalone notices; hiding ordinary gameplay UI does not itself show one.

The window

Open WindowMode → 6DOF Window, enable it, then use Recenter Window In Front Of Me. Width, height, distance, edge feather, corners and curvature are live. In HUD placement, attach the HUD to the window. Fill whole frame with coverage 1.0 now fills both dimensions. This stretches the UI if the portal and HUD have different proportions. Preserve proportions touches one axis; Safe fit also leaves a margin for rounded and feathered edges. The HUD is a flat rectangle: use zero curvature and square corners for exact edge alignment. It is a stereo window into the running scene, not a paused reconstruction. Passthrough/chroma-key support depends on the streaming/runtime setup and has not been established for every Quest connection method here.

Record a problem or a showcase clip

Open WuWa Controls → Recording and privacy. Streamer privacy: cover player IDs draws black rectangles over the usual bottom-right UID and the ESC profile ID in the extracted UI, including its VR/portal and mod spectator copies. It starts off. The top-left box normally follows detected ESC/overlay menus; other popups using that render path may also show it. Privacy box placement lets you adjust the edges or choose Always as a manual fallback. The bottom-right box stays on while privacy is enabled. Control-profile resets preserve this setting.

Inspect a short gameplay and ESC-menu recording before sharing it. The masks have GPU pixel checks, but their live placement still needs verification and other layouts may put an ID elsewhere. They do not redact names, chat, log files, the launcher or pre-injection screens, and cannot edit recordings already saved. Both playtest and content-creation recordings use the same masked VR image when the switch is enabled.

Keep WuWa VR Launcher running. Start/stop from Recording and privacy in UEVR, or Record gameplay in the launcher. The launcher tab can be closed; the local app must stay running. Close UEVR and return focus to WuWa while recording. Video stops after five minutes, game exit or a scene change.

SteamVR and the updated OpenXR Simulator are supported capture routes. VDXR video capture is not implemented. For the simulator, keep its preview open with Both eyes, side-by-side and Full render off. An older registered simulator must be replaced using Use this package's simulator with the game and injector closed; updating the backend alone does not replace it. That button changes the global OpenXR runtime. Capture uses the preview's resolution.

There is no desktop or audio capture. Recording can reduce performance. Choose 30/45/60 fps and 720/1024/1280 pixels per eye; start with 30 / 1024. A 60 fps target cannot create game frames that were not rendered. The report records measured capture throughput; recording performance on this candidate still needs checking.

Open recordings opens the saved folder. clean-sbs.mp4 is the unannotated stereo video. replay.html shows controller presses and camera state separately; it can save clean left-eye, right-eye or stereo PNG stills. If the browser blocks local still export, expand the file-picker help and select that folder's MP4.

On the 17:30 candidate, playtest sidecars can also contain bounded per-eye render_stage0 observations for the NPC-label investigation. They record CPU viewport/depth setup immediately before dispatch, not completed GPU pixels. They do not change render parameters and remain separate from the video and camera replay. Content-creation recordings do not enable this diagnostic trace. Matching is approximate, and stale input is marked unavailable. The new backend records raw and delivered input, post-animation/game/control camera information, HMD position/orientation and recent per-eye rendered poses. Choose Playtest with camera and Xbox data for these sidecars. Content creation: clean video only also supports older backends without motion recording.

For showcase footage, hide the shortcut sheet and close UEVR first; the recorder does not remove game HUD, menus or account identifiers. Keep the original clip and diagnostic sidecars for debugging, and review any footage before publishing. Nothing uploads automatically.

Problems and recovery

Updated September 28, 2026. Keep the selected build name, timestamp and backend hash with a report. The public 26 Sep beta and newer local candidates have different defaults. Use BUILD GUIDE.html in your ZIP for its supplied values; saved personal settings take priority. A result against one checkpoint does not automatically apply to another.

What is not implemented or established

• Global time pause / frozen-time walkaround is not implemented.
• Collision is optional and experimental, and cannot constrain real head movement.
• First-person support has not been checked on every character, outfit or animation.
• No claim of publisher approval, account safety or anti-cheat compatibility.
• No claim that simulator screenshots establish headset comfort or stable Steam Link performance.

The older automated rendering-comparison tool remains available, but it is not required for the shared-frame candidate's playtest. The previous global quality comparisons did not resolve the reported static-left-canopy issue. Use the grouped playtest with this build's defaults instead of repeating those trials. Review recordings for account IDs before sharing.

Useful bug report

Record the checkpoint and hash, runtime/headset, controller connection, camera mode, relevant option states and shortest repeatable steps. For stereo problems, describe each eye separately. Include whether returning to normal camera or restoring UI changes the result. Remove account IDs, personal paths and private Discord information before posting logs or screenshots. Do not share game binaries, memory captures or extracted assets.

Portable launcher

Extract the ZIP, then open WuWa VR Launcher.exe. It carries its own Python and opens a page served only on your PC. Settings, backups and logs are kept in %LOCALAPPDATA%\WuWa VR Launcher.

The linked public beta and newer local test packages have separate release records. Use the guide included in your ZIP. Game injection needs Windows permission to match the game; the launcher leaves game files alone. Use headset / Use simulator changes the global OpenXR runtime only when you click it, with the game and injector closed. Use headset restores the previously saved runtime. Release and distribution notes.