# Years Apart - Installationsanleitung

Dieses Repository enthält den Source Code für das VR-Puzzlespiel **Years Apart**.
Zielplattform: **Meta Quest 3**.

Es gibt zwei Möglichkeiten, das Spiel auf die Brille zu bringen:
1. **Quick Install (Empfohlen):** Installation der fertigen `.apk` Datei.
2. **Build from Source:** Projekt in Godot öffnen und selbst deployen.

---

## Methode 1: Quick Install (via APK & SideQuest)

Diese Methode ist am schnellsten, wenn du das Spiel nur spielen möchtest.

### Voraussetzungen
*   Eine **Meta Quest 3** im **Entwicklermodus** (Developer Mode).
    *   *Anleitung:* Gehe in die Meta Quest Handy-App -> Einstellungen -> Headset-Einstellungen -> Entwicklermodus -> Ein.
*   Ein USB-C Kabel zum Verbinden der Brille mit dem PC.
*   [SideQuest](https://sidequestvr.com/setup-howto) (Advanced Installer) oder der [Meta Quest Developer Hub](https://developer.oculus.com/meta-quest-developer-hub/) auf deinem PC installiert.

### Schritte
1.  Lade die aktuelle **Release-APK** (`YearsApart.apk`) hier herunter:
    *   [🔗 Zum Release Download](https://gitty.informatik.hs-mannheim.de/2211482/vrp-years-apart/releases)
2.  Verbinde deine Quest 3 via USB mit dem PC und erlaube den USB-Zugriff in der Brille.
3.  Öffne **SideQuest**. Oben rechts sollte der Status grün sein ("Connected").
4.  Klicke in SideQuest oben rechts auf das Icon **"Install APK file from folder on computer"** (Pfeil nach unten über einer Box).
5.  Wähle die heruntergeladene `.apk` Datei aus.
6.  Warte, bis SideQuest "All tasks completed" meldet.

**Spiel starten:**
In der Quest 3 findest du das Spiel in der Bibliothek unter **Quellen** (oben rechts im Filter) -> **Unbekannte Quellen** (Unknown Sources).

---

## Methode 2: Build from Source (via Godot Engine)

Nutze diese Methode, wenn du den Code bearbeiten oder debuggen möchtest.

### Voraussetzungen
*   **Godot Engine 4.x** (Die Version, mit der das Projekt erstellt wurde).
*   **Android SDK & OpenJDK 17**:
    *   Godot muss für den Android-Export konfiguriert sein.
    *   Gehe in Godot zu `Editor` -> `Editor Settings` -> `Export` -> `Android` und stelle sicher, dass die Pfade zum Android SDK und Java SDK gesetzt sind.
*   Die Quest 3 im **Entwicklermodus** (siehe oben).

### Schritte
1.  **Repository klonen:**
    ```bash
    git clone https://gitty.informatik.hs-mannheim.de/2211482/vrp-years-apart.git
    ```
2.  **Projekt öffnen:**
    Starte Godot und importiere die `project.godot` Datei aus dem Ordner.
3.  **Verbindung herstellen:**
    Verbinde die Quest 3 via USB. Erlaube USB-Debugging in der Brille, falls gefragt.
4.  **Remote Deploy:**
    *   Oben rechts im Godot Editor sollte nun ein **Android-Icon** sichtbar sein (neben den Play-Buttons), oder unter "Remote Debug".
    *   Klicke auf das Icon ("Remote Debug" / "Run on Android Device").
    *   Godot kompiliert das Projekt und installiert es direkt auf der Brille. Das Spiel startet automatisch.

*(Hinweis: Falls dies der erste Build ist, stelle sicher, dass unter `Project` -> `Export...` ein Android-Preset angelegt ist und die Option "XR Mode" auf "OpenXR" steht.)*