# 🏀 Basketball VR 🏀

**Shoot some hoops in VR!**  
A simple basketball experience built in Unity 2020.3 for Oculus headsets, utilizing the XR Interaction Toolkit.

---

## 📂 Repository Structure

- **`README.md`**: This documentation file.
- **`VRGroup1/`**: Contains the Unity project files:
  - **`Assets/`**: Core game assets (scenes, scripts, models, etc.).
  - **`ProjectSettings/`**: Unity project settings.
  - **`Packages/`**: Unity package manifest.
  - *(Other Unity-generated folders)*

---

## 🚀 Getting Started

### 1️⃣ Clone the repository:
```bash
git clone <repository-url>
```
*(Replace `<repository-url>` with the actual URL.)*

### 2️⃣ Open in Unity Hub:
- Launch **Unity Hub**.
- Click **"Add"** or **"Open"**.
- Navigate to the cloned repository folder and select the **`VRGroup1`** subfolder.
- Ensure you are using **Unity version 2020.3.21f1**.

### 3️⃣ Install Required Packages:
Verify that the required packages are installed via the Unity Package Manager:
- **Oculus XR Plugin** (`com.unity.xr.oculus`)
- **XR Interaction Toolkit** (`com.unity.xr.interaction.toolkit`)

### 4️⃣ Configure VR:
Ensure your Oculus VR headset and software are properly set up.

### 5️⃣ Open Main Scene:
- In the Unity Editor, navigate to `VRGroup1/Assets/Scenes`.
- Open the `Ballin.unity` scene.

### 6️⃣ Play the Game! 🎮
- Enter **Play mode** in the Unity Editor and enjoy!

---

## 📋 Project Details

- **Unity Version**: `2020.3.21f1`
- **Target Platform**: Oculus VR (Quest, Rift)
- **Core Packages**:
  - Oculus XR Plugin (`com.unity.xr.oculus`)
  - XR Interaction Toolkit (`com.unity.xr.interaction.toolkit`)
- **Main Scene**: `VRGroup1/Assets/Scenes/Ballin.unity`
- **Core Script**: `VRGroup1/Assets/Scripts/ScoreScript.cs`

---

## 💡 Additional Notes

- Make sure your VR headset is connected and configured properly before running the project.
- For any issues or questions, feel free to reach out via the [Issues](https://github.com/MarwanSummakieh/Basket-Ball-VR/issues) tab.

---

**Enjoy the game!** ⛹️‍♀️🔥