dubrovskiy-yevhen-stakelogic/rdr1-quest

Version 0.1.1 alpha. Source code and build tools for the Quest VR mod.

An unofficial VR mod for the Android version of Red Dead Redemption. It runs standalone on Meta Quest 3 and Quest 3S, without a PC or Quest Link.

• Red Dead Redemption for Android, version 1.58.63226194 (arm64), exported from an Android phone or tablet with EXPORT_RDR_APKS.bat.
• Meta Quest 3 or Quest 3S with Developer Mode enabled and a USB-C data cable.
• Windows 10/11, Linux x86_64 or macOS, an internet connection for the build tools, and about 20 GB of free disk space.
• About 18 GB of free storage on the headset during installation; the installer calculates the requirement with a reserve from the APK set size.

The easiest way: download this repository once (Code > Download ZIP, or git clone), put it in a folder of its own and run UPDATE.bat on Windows or bash UPDATE.sh on Linux/macOS. It gets Git if the PC has none (a private portable copy on Windows, no admin rights), brings the folder to the latest version from GitHub and starts the build and install wizard below. Run the same file again whenever a new version is out: your exported game, the personal signing key and build caches are kept; only the mod's own files are replaced.

1. Download the full game on your phone first. Open it, wait for all additional data to download, and check that you can enter the game world. Then export it with EXPORT_RDR_APKS.bat. Keep the whole export folder: base.apk, every split_*.apk and the external folder. A small APK or incomplete XAPK is not enough; do not rely on the Quest to download missing data.
2. Run BUILD_AND_INSTALL.bat on Windows or bash BUILD_AND_INSTALL.sh on Linux/macOS.
3. Select the export folder.
4. Connect the Quest, allow USB debugging in the headset, and follow the prompts.

The installer downloads and verifies every build tool, builds the mod from these sources, signs the APK set with a personal key and installs it. The game is left stopped. Start it from Library > Unknown sources > RDR while wearing the headset in a well-lit room.

The installer supports two engine variants and identifies them by the SHA-256 of librdr.so, independently of the Rockstar/Netflix package name. Variant 2 has been tested in VR, including gameplay, but has had less testing; some features may behave differently. The installer shows the detected variant and engine ID. An unknown variant is stopped with a request to report the ID to the author; the installer never applies another variant's hooks or replaces the game engine.

Use one complete export of your game. APK, APKS, ZIP and XAPK inputs are accepted. Some XAPKs contain the engine and initial data but omit the world and audio packs. If the installer reports missing resources, let that same game finish downloading on the phone and export it again. A second edition is not required, and the installer does not supply game files.

Keep the personal signing key (see BUILDING.md). Updates must be signed with the same key; otherwise Android requires uninstalling the game, which deletes its saved games. Copy them to the PC first with TRANSFER_SAVES.bat -FromHeadset (see Saves).

• Full 6DoF stereo rendering of the game world with head-tracked camera.
• 36 fps rendering shown at 72 Hz, with optional Application SpaceWarp that uses per-character motion vectors.
• TAA anti-aliasing with adjustable sharpness, foveated rendering, and resolution, shadow, grass and sharpening options.
• The player's own body with arm IK; weapons sit in the hands.
• Body holsters for every weapon slot, physical aiming and firing, two-hand aim, dual wield and hand-to-hand transfer.
• Manual revolver reload, hammer cocking and fanning, gun spin, throwing and catching the revolver.
• Physical knife and fist melee, fist block, two-handed lasso.
• Smooth, native or teleport locomotion, snap or smooth turn, sprint and crouch toggles.
• Horseback riding with a stable seat camera (adjustable height and distance), spurring by tapping A, jumping with B.
• Weapon presets: REALISTIC (gun spin, manual reload one round at a time, hammer cocking) or CASUAL (default: the trigger just fires, B reloads, no spin). CASUAL forwards the held firearm trigger without VR hammer or cylinder gates; hand gestures do not cock or fan the hammer. The game controls ammo and firing cadence. Existing saved settings are preserved; resetting VR settings restores CASUAL.
• HOLSTERS page: choose which of your revolvers, rifles, shotguns, thrown and melee weapons sits in each holster.
• Whistle for the horse by holding an empty hand to the mouth and squeezing the grip.
• HUD on a head-locked panel or with the minimap on the left wrist.
• Cutscenes on a flat screen, in stereo from the cutscene camera, or in first person.
• In-headset VR menu with graphics, movement, weapons, holsters, HUD, cheat, button remapping and controls help pages. Cheats include giving any weapon, every weapon of a type or all weapons.

Holsters: revolver on the right hip, lasso on the left hip, knife on the left chest, throwables at the chest centre, rifles behind the right shoulder, shotguns behind the left shoulder and sniper rifles behind the head. During a cutscene R3 switches between the cutscene modes.

In the VR menu the stick moves up and down, the right trigger steps a value forward and the left trigger back, A opens or applies, B goes back and X / Y switch pages. Settings are saved immediately. Every button above can be moved to another button on the BUTTONS page, separately on foot and on a horse; the CONTROLS page in the headset describes all of them.

Android apps cannot raise the headset GPU clock themselves, so the kit includes a small helper that runs on the headset over ADB. BUILD_AND_INSTALL starts it after the install. A headset restart stops it: run GPU_BOOST.bat or bash GPU_BOOST.sh once after every headset restart, with the headset connected and USB debugging allowed.

• GRAPHICS > GPU BOOST in the VR menu chooses the level: OFF, 640 or 690 MHz (default 690). 690 also raises the CPU to its top clock (2.36 GHz), which keeps busy places such as towns smooth. The row shows NO HELPER when the helper is not running.
• The boost applies only while the game runs. Home and other apps keep their normal clocks.
• Higher clocks drain the battery faster and warm the headset. When the headset gets hot, the game shows a red overheat warning and lowers 690 to 640.
• -Off (--off) stops the helper and restores the normal clocks; -Status (--status) shows its state.

The game keeps its saves in private storage that ADB cannot read. Every time the game starts, the mod copies them to its rdrvr folder on the headset and imports the saves staged there. TRANSFER_SAVES.bat or bash TRANSFER_SAVES.sh moves saves between the PC and the headset; connect the headset and allow USB debugging first.

• PC to headset: TRANSFER_SAVES.bat takes the saves of the newest profile of the PC game (Documents\Rockstar Games\Red Dead Redemption\Profiles). -From <folder> (--from <folder>) or dropping a folder on the .bat file uses another folder; Linux and macOS ask for it. -SkipExtras leaves RDR2EXTRAS.SAV out. The tool lists which headset saves will be replaced, closes the game and stages the files. Start the game once: the saves are imported while it starts.
• Headset to PC: -FromHeadset (--from-headset) copies the headset saves as RDR2SAVE0.SAV and so on to saves-from-headset in the work folder (-To <folder> chooses another empty folder). Close the PC game and copy them into its profile folder. They are the saves as of the last game start: start and close the game once to include newer ones.
• Backups: the headset backs up every save that an import replaces in rdrvr/save-backup/<time>. Before each import the tool also copies the current headset saves to save-backups in the work folder. -FromHeadset -IncludeBackups copies the headset backups to the PC.
• Continue or Load Game: after an import, Continue loads the save with the newest in-game save date, which may be another slot. Use Load Game to pick the imported slot, or replace every slot that is in use.
• -Status (--status) shows the headset saves, saves waiting for import and the end of the transfer log.

Saves of the PC version load unchanged. Saves from consoles are untested.

On Windows, running UPDATE.bat again remembers your game source and reuses a verified build when its inputs have not changed. After a failed USB installation or insufficient headset storage, free space/reconnect and rerun it; keep C:\RDRVRBuild and your signing key. When the mod changes, unchanged data APKs can be reused, and only APKs differing from the installed set are sent to the Quest. File checks still take time. Use BUILD_AND_INSTALL.bat -GamePackage "path" to choose a different input, or add -Rebuild to force a fresh build.

• In the headset: VR menu > RESET ALL, press A twice. Graphics, VR and button settings go back to the defaults. Saved games are not touched.
• RESET_VR_SETTINGS.bat or bash RESET_VR_SETTINGS.sh restores the default VR settings after confirmation. Saved games are not touched.
• COLLECT_REPORT.bat collects a diagnostic report from the headset into the work folder. Nothing is uploaded. While the game is running it requests a fresh diagnostic snapshot, including with the FPS counter off. It does not change settings or start/stop the game. summary.txt states whether that snapshot was confirmed; if not, the saved JSON can contain only startup state and is not evidence of gameplay counters. If a weapon stops firing, try the trigger several times and collect the report while the game is still running, before restarting it. Include the weapon name and whether the problem began after holstering, dropping or changing weapons. New builds record shot attempts and holster events as RdrVrFire in the log, with the last 64 events also saved in vr.weapon.diagnostics in the JSON report. The report ZIP includes a separate fire-diagnostics.txt with these log lines. NATIVE_PAD events and gameBootstrap.nativeInput.delivery record trigger delivery after the native input update: requested/submitted RT, selected controller, native held/pressed buttons, and rejected filters. ROUTED alone only confirms that the VR weapon filter forwarded the press, not that the game consumed it. Input blocks have an explicit reason; NO_ENGINE_FIRE only means no projectile was observed within 700 ms. Its context hint is not a confirmed engine cause.

• The game needs 6DoF tracking. In a dark room the headset cannot track and the game does not start.
• On battery the headset lowers its clocks; busy towns at night can drop below 36 fps.
• The pause menu, front end and loading screens are shown on a flat screen.
• HUD text and subtitles are hidden during stereo cutscenes.
• On horseback only the revolver and the lasso can be drawn from holsters. Duels, mounted guns and scripted scenes use the game's own weapon handling.
• Room-scale movement is experimental and off by default.
• Installing the 3 GB APK set over Wi-Fi ADB can fail; use a USB cable.

See LICENSE, NOTICE.md, and the licenses alongside third-party files. Game APKs, game code and assets, and signing keys are provided locally and are not included in this source kit.