From 4e3575eea116b6f75a2e7fc8d250c71fefbcd194 Mon Sep 17 00:00:00 2001 From: ops-deploy-bot Date: Thu, 15 Oct 2026 11:19:38 +0200 Subject: [PATCH] Download-Seite: Playtest-APK + Sideload-Anleitung (SideQuest/ADB) --- README.md | 38 ++++++++++++++++++++ SIDELOAD-ANLEITUNG.md | 82 +++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 120 insertions(+) create mode 100644 README.md create mode 100644 SIDELOAD-ANLEITUNG.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..9d10393 --- /dev/null +++ b/README.md @@ -0,0 +1,38 @@ +# ScopedVR — Playtest-Downloads (Meta Quest 3) + +Hier gibt es die aktuelle Playtest-APK zum **direkten Download — ohne Account, ohne Anmeldung**. + +## Aktueller Build + +| | | +|---|---| +| Datei | `scopedvr-client_v0.1.0-m2b.apk` | +| Version | 0.1.0 (versionCode 14) | +| Stand | Commit `9ebe8ef` (origin/main, 15.10.2026) | +| Größe | 81.973.165 Bytes (~78 MB) | +| SHA256 | `5a7f91211091745aa4d9a20ee8238c5e472b8044a5d9da176b251bcaa2989bf9` | +| Zielgerät | Meta Quest 3 (arm64, OpenXR) | + +**→ [APK direkt herunterladen](releases/download/m1-playtest/scopedvr-client_v0.1.0-m2b.apk)** + +(Release-Seite mit Details und älteren Builds: [Releases](releases)) + +## Installation (Sideload) + +Die APK ist **nicht im Meta-Store** — sie muss per Sideload auf die Quest 3. +Das ist mit der Anleitung unten auch ohne Technik-Erfahrung in ca. 15–20 Minuten erledigt. + +**→ [Sideload-Anleitung (SideQuest / ADB, Schritt für Schritt)](SIDELOAD-ANLEITUNG.md)** + +## Schnell-Checkliste + +1. APK über den Link oben herunterladen +2. Sideload-Anleitung folgen (Entwicklermodus an der Quest 3 aktivieren, dann SideQuest oder ADB) +3. In der Quest: App-Bibliothek → „Unbekannte Quellen“ → **ScopedVR** starten +4. Wrist-Panel → **Server-Browser** → offiziellem Server beitreten + +## Hinweise + +- Die APK ist selbst signiert (CN=ScopedVR, OU=Playtest) — Android/Quest warnt beim ersten Start ggf. vor „unbekannter Quelle“. Das ist bei Sideloads normal. +- Nach Updates: einfach die neue APK-Datei derselben Installationsmethode installieren — sie überschreibt die alte. +- Bugs: Issue in diesem Repo anlegen (Forgejo-Account nötig) oder direkt Sly Bescheid geben. diff --git a/SIDELOAD-ANLEITUNG.md b/SIDELOAD-ANLEITUNG.md new file mode 100644 index 0000000..5f53bec --- /dev/null +++ b/SIDELOAD-ANLEITUNG.md @@ -0,0 +1,82 @@ +# 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.