dubrovskiy-yevhen-stakelogic / rdr1-quest

# Red Dead Redemption VR for 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.
## Requirements
- 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.
## Build and install
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.
Ke