Version 0.1.0 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 from Google Play, version
1.58.63226194(arm64), exported from an Android phone or tablet withEXPORT_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 8 GB of free storage on the headset.
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.
- Export the game from the phone with
EXPORT_RDR_APKS.bat. Keep the whole export folder:base.apk, everysplit_*.apkand theexternalfolder. - Run
BUILD_AND_INSTALL.baton Windows orbash BUILD_AND_INSTALL.shon Linux/macOS. - Select the export folder.
- 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.
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 (the trigger just fires, B reloads, no spin).
- 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.
| Action | Control |
|---|---|
| Move | Left stick |
| Sprint toggle | Left stick click (L3) |
| Turn (snap or smooth) | Right stick left / right |
| Crouch toggle | Right stick click (R3) |
| Jump (on a horse: spur, tap repeatedly) | A |
| Reload, interact; open the revolver cylinder (on a horse: jump) | B |
| Whistle for the horse | X |
| Use, mount, dismount | Y |
| Dead Eye | Left trigger + R3 |
| Recenter | Hold L3 + R3 |
| Draw from a holster | Grip at the holster |
| Fire | Trigger of the hand holding the weapon |
| Pause menu | Left menu button |
| VR menu | Hold the left menu button |
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,640or690MHz (default690).690also raises the CPU to its top clock (2.36 GHz), which keeps busy places such as towns smooth. The row showsNO HELPERwhen 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
690to640. -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.battakes 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.batfile uses another folder; Linux and macOS ask for it.-SkipExtrasleavesRDR2EXTRAS.SAVout. 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 asRDR2SAVE0.SAVand so on tosaves-from-headsetin 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 tosave-backupsin the work folder.-FromHeadset -IncludeBackupscopies 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.
- 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.batorbash RESET_VR_SETTINGS.shrestores the default VR settings after confirmation. Saved games are not touched.COLLECT_REPORT.batcollects a diagnostic report from the headset into the work folder. Nothing is uploaded.
- 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.