Download-Seite: Playtest-APK + Sideload-Anleitung (SideQuest/ADB)
This commit is contained in:
commit
4e3575eea1
2 changed files with 120 additions and 0 deletions
38
README.md
Normal file
38
README.md
Normal file
|
|
@ -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.
|
||||
82
SIDELOAD-ANLEITUNG.md
Normal file
82
SIDELOAD-ANLEITUNG.md
Normal file
|
|
@ -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.
|
||||
Loading…
Reference in a new issue