# ScopedVR auf der Meta Quest 3 installieren (Sideload-Anleitung)

Diese Anleitung ist für Einsteiger ohne Technik-Vorkenntnisse geschrieben. Zeitaufwand: ca. 15–20 Minuten (einmalig; spätere Updates gehen in 2 Minuten).

## Was du brauchst

- Meta Quest 3
- Windows-PC oder Mac
- USB-C-Kabel (das Ladekabel der Quest funktioniert, es muss ein **Datenkabel** sein)
- Die APK-Datei: `scopedvr-client_v0.1.0-m2b.apk` — Download-Link siehe [README](README.md)

---

## Schritt 1: Entwicklermodus aktivieren (einmalig, für beide Methoden nötig)

1. Auf dem Handy die App **„Meta Horizon“** öffnen (früher hieß sie „Oculus“; kostenlos im App Store / Play Store)
2. Deine Quest 3 ist dort unter **Geräte** verbunden (dein Meta-Account)
3. Headset auswählen → **Headset-Einstellungen** → **Entwicklermodus** auf AN schalten
   - Falls der Schalter fehlt oder grau ist: Einmal auf [developer.oculus.com](https://developer.oculus.com) mit demselben Meta-Account eine **Entwickler-Organisation anlegen** (kostenlos, der Name ist egal — z. B. dein Spitzname). Danach erscheint der Schalter.
4. Quest 3 **neu starten** (ein-/ausschalten), sonst ist der Modus nicht aktiv

## Schritt 2: USB-Debugging zulassen

1. Quest per USB-C an den PC anschließen
2. **Brille aufsetzen** — im Headset erscheint ein Dialog: **„USB-Debugging zulassen?“** → **Zulassen** (falls angeboten: „Immer von diesem Computer“ anhaken)
3. Ohne diesen bestätigten Dialog kann keine Software von außen installieren — dieser Schritt ist der häufigste Stolperstein

---

## Methode A (empfohlen): SideQuest

1. Auf dem PC herunterladen: [sidequestvr.com/download](https://sidequestvr.com/download) → installieren → öffnen
2. Quest per USB verbinden (Schritte 1–2 oben). Oben links in SideQuest erscheint ein grünes Gerät/Häkchen, wenn die Verbindung steht
3. In SideQuest die Kachel **„Install APK file from folder on device“** anklicken — oder die APK-Datei einfach **per Drag & Drop** ins SideQuest-Fenster ziehen
4. Die heruntergeladene `scopedvr-client_v0.1.0-m2b.apk` auswählen → warten, bis **„Installed“** erscheint
5. Weiter unten bei **„Erster Start in der Quest“** lesen

## Methode B (Alternative): Direkt per ADB (ohne SideQuest)

1. Die **Platform-Tools** herunterladen: [developer.android.com/tools/releases/platform-tools](https://developer.android.com/tools/releases/platform-tools) → ZIP entpacken, z. B. nach `C:\platform-tools`
2. In diesem Ordner ein Terminal öffnen (Windows: den Ordner öffnen, in die Adressleiste des Explorers `cmd` eintippen, Enter)
3. Prüfen, ob die Quest erkannt wird:

   ```
   adb devices
   ```

   → Es muss ein Gerät mit dem Status **device** gelistet werden (sonst Schritt 1–2 oben wiederholen)
4. Installieren:

   ```
   adb install -r scopedvr-client_v0.1.0-m2b.apk
   ```

   → **„Success“** = fertig. (Pfad zur Datei ggf. anpassen, z. B. `adb install -r C:\Downloads\scopedvr-client_v0.1.0-m2b.apk`)

---

## Erster Start in der Quest

1. App-Bibliothek öffnen (Leiste unten in der Kopfleiste)
2. Rechts oben im Filter **„Unbekannte Quellen“** („Unknown Sources“) auswählen
3. **ScopedVR** starten
4. Beim ersten Start fragt die App nach **Mikrofon-Berechtigung** → zulassen (wird für Voice im Spiel gebraucht)
5. **Nickname** vergeben
6. Wrist-Panel öffnen → **Server-Browser** → offiziellem Server beitreten

---

## Probleme?

| Problem | Lösung |
|---|---|
| SideQuest/`adb devices` zeigt kein Gerät | Datenkabel prüfen (kein reines Ladekabel), Dialog „USB-Debugging zulassen“ im Headset bestätigen, Entwicklermodus (Schritt 1) prüfen + Quest neu starten |
| App nach der Installation nicht zu finden | App-Bibliothek → Filter **„Unbekannte Quellen“** |
| Installation schlägt fehl, Meldung wie `INSTALL_FAILED_UPDATE_INCOMPATIBLE` | Erst die alte Version entfernen: `adb uninstall de.slyphax.questtest` — dann neu installieren |
| „Verbindung fehlgeschlagen“ im Server-Browser | Quest braucht Internet (WLAN). Kurz warten und **Aktualisieren** drücken; falls es dauerhaft scheitert, Sly Bescheid geben |
| Neue Version installieren | Gleiche Methode wie oben — die neue APK überschreibt die alte, Einstellungen bleiben erhalten |

## Sicherheits-Hinweis

Diese APK kommt direkt von Sly und ist selbst signiert — sie steht **nicht** im Meta-Store. Warnt Android/Quest vor „unbekannter Quelle“, ist das bei Sideloads normal und hier genau der Sinn der Sache.