# Quest Game Patcher



**Windows tool for patching and sideloading Oculus Quest APK files**

Created by **Gool54** (u/Pale-Requirement9041)

---

## 🎯 Features

- **Version Patching**: Two methods to bypass Quest version checks
  - **Standard Method**: Version string spoofing (experimental - may not work for all games)
  - **Advanced Method**: Reverse-engineered (more reliable, based on deep analysis)
- **Direct Sideloading**: Install APKs and OBB files directly to your Quest via USB
- **Real-Time Device Monitoring**: 
  - Firmware version display
  - Storage usage with color-coded bars
  - Battery level with charging indicator
 - **Automatic OBB Detection**: Finds and copies all game data files (.obb, .bundle, etc.)
- **APK Signing**: v1+v2+v3 signatures for Android 11+ compatibility
- **Automatic Backups**: Creates backup copies before patching

---

## 📋 Requirements

- **Operating System**: Windows 10 or later
- **Java Runtime Environment**: Required for APK signing ([Download Java](https://www.java.com/download/))
- **USB Cable**: To connect Quest device
- **Quest Device**: Must be in Developer Mode with USB debugging enabled

---

## 🚀 Quick Start

1. **Download** the installer: `QuestGamePatcher_Setup_v1.0.exe`
2. **Run** the installer and follow the setup wizard
3. **Connect** your Quest device via USB
4. **Enable** USB debugging on your Quest (allow the prompt in headset)
5. **Launch** Quest Game Patcher
6. **Select** your APK file
7. **Choose** patching method (or skip to just sideload)
8. **Click** "Sideload APK" to install to your Quest

---

## 📖 How It Works

### Version Patching Methods

**Standard Method (Experimental)**
Spoofs the Oculus version string embedded in APK files by modifying the version number. This is a simple string replacement that may not work for all games, as some perform additional validation checks.

**Advanced Method (Recommended)**
Uses reverse-engineered components to replace internal files with modified versions. This method is more reliable as it's based on deep analysis of Quest's internal structure and bypasses most version validation mechanisms.

### Sideloading
The tool automatically detects ADB (Android Debug Bridge) from popular Quest tools like SideQuest or Rookie, then installs the APK and copies all associated data files to your Quest device.

### OBB File Handling
Place your APK file and a folder with the same name as the package (e.g., `com.example.game/`) in the same directory. The tool will automatically detect and copy all files inside to your Quest's storage.

---

## ⚠️ Important Notes

- **Educational Purpose**: This tool is provided for educational and research purposes only
- **No Warranty**: The author is NOT responsible for any damages to your Quest device
- **Firmware Compatibility**: Target version must be lower than or equal to your Quest firmware
- **Backup Recommended**: Always keep original APK files as backups

---

## 🔧 Troubleshooting

### Java Not Found
If you see a Java error, download and install Java from [java.com/download](https://www.java.com/download/)

### Device Not Detected
1. Enable Developer Mode on your Quest
2. Enable USB debugging in Quest settings
3. Allow USB debugging prompt in headset when connected
4. Try a different USB cable or port

### OBB Files Not Copying
Ensure your folder structure is correct:
```
YourFolder/
├── game.apk
└── com.example.game/
    ├── main.123456.com.example.game.obb
    └── patch.123456.com.example.game.obb
```

---

## 📄 License

**Proprietary License** - Copyright © 2026 Gool54

This software is proprietary and confidential. Unauthorized copying, distribution, modification, or reverse engineering is strictly prohibited. See LICENSE.txt for full terms.

---

## 💬 Support

For issues, questions, or feedback, contact **u/Pale-Requirement9041** on Reddit.

---

## 📦 Download

**Latest Release**: v1.0

**[⬇️ Download QuestGamePatcher_Setup_v1.0.exe](https://github.com/divisionalmediaa-cmd/quest-game-patcher/releases/download/v1.0/QuestGamePatcher_Setup_v1.0.exe)**

Or browse all releases: [Releases Page](../../releases)

---

**Made with ❤️ for the Quest community**
