An immersive Virtual Reality adaptation of the popular Stumble Guys game, built for Meta Quest 3

VR Stumble Guy is a fully immersive virtual reality experience that brings the chaotic fun of obstacle course racing to Meta Quest 3. Navigate through challenging courses, avoid obstacles, and compete to be the last player standing—all in stunning VR. This project leverages the powerful VRIF (VR Interaction Framework) by BNG to deliver smooth, intuitive VR interactions and locomotion mechanics optimized for the Meta Quest 3 platform.

• Immersive VR Obstacle Courses - Navigate through dynamic, challenging environments
• Physics-Based Interactions - Realistic collision and ragdoll physics
• Competitive Gameplay - Race against time and obstacles to reach the finish line
• Multiple Game Modes - Various obstacle courses and challenges

• Hand Tracking Support - Native Meta Quest 3 hand tracking integration
• Smooth Locomotion - Multiple movement options including teleportation and smooth movement
• Intuitive Controls - Natural VR interactions using VRIF framework
• Optimized Performance - Smooth 72Hz/90Hz rendering for comfortable VR experience
• Room-Scale VR - Full 6DOF (Six Degrees of Freedom) movement

• Unity Hub (Latest version)
• Unity 2022.3.59f1 LTS (Exact version recommended)
• Android Build Support module for Unity
• Meta Quest Developer Hub (for deployment and debugging)
• Git (for version control)

git clone https://github.com/m-ahmad-butt/Virtual-Reality.git
cd "Virtual-Reality"

1. Launch Unity Hub
2. Click "Open" or "Add"
3. Navigate to the cloned project folder: Stumble Guy-MetaQuest 3
4. Ensure Unity 2022.3.59f1 is installed
5. Unity will import all assets (this may take several minutes)

1. Go to File → Build Settings
2. Select Android platform
3. Click "Switch Platform" if not already selected
4. Under Texture Compression, select ASTC
5. Click "Player Settings" and configure:
   • Company Name: Your company/developer name
   • Product Name: VR Stumble Guy
   • XR Plug-in Management: Enable Oculus (Meta Quest)

1. Install the Meta Quest Developer Hub or Meta Quest Mobile App
2. Enable Developer Mode on your Quest 3
3. Connect Quest 3 to PC via USB-C cable
4. Allow USB debugging when prompted on headset

1. In Unity, go to File → Build Settings
2. Ensure your Quest 3 is connected and recognized
3. Click "Build and Run"
4. Choose a location to save the APK
5. Unity will build and automatically install on your Quest 3

1. Click "Build" instead of "Build and Run"
2. Save the APK file
3. Use SideQuest or Meta Quest Developer Hub to install manually

Contributions are welcome! Please follow these guidelines:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

• Follow Unity C# coding conventions
• Test all changes on actual Meta Quest 3 hardware
• Document new features and changes
• Ensure backward compatibility when possible

This project is for educational purposes.