306 lines
8.2 KiB
Markdown
306 lines
8.2 KiB
Markdown
# Omarchy Citizen 0.6.4 – Plug-&-Play-Installation
|
||
|
||
## Ziel
|
||
|
||
Der Nutzer soll Star Citizen unter Omarchy benutzen können, ohne Linux administrieren zu müssen.
|
||
|
||
Im normalen Alltag sind nur drei Dinge wichtig:
|
||
|
||
1. **EINRICHTEN & STARTKLAR MACHEN** bzw. **STAR CITIZEN STARTEN**
|
||
2. **Problem beheben**
|
||
3. **Support-Paket erstellen**
|
||
|
||
Wine-Runner, DXVK, einzelne Reparaturschritte, Logs und NGL befinden sich unter
|
||
**Erweiterte Optionen**.
|
||
|
||
---
|
||
|
||
## 1. Plugin installieren
|
||
|
||
### Mausfreundlich
|
||
|
||
Entpacke `omarchy-citizen-0.6.0.zip`.
|
||
|
||
Im entpackten Ordner liegt:
|
||
|
||
`INSTALLIEREN.sh`
|
||
|
||
Führe diese Datei über deinen Dateimanager als Programm aus.
|
||
|
||
Falls der Dateimanager Skripte nicht direkt ausführt, bleibt der Terminal-Fallback:
|
||
|
||
```bash
|
||
./INSTALLIEREN.sh
|
||
```
|
||
|
||
oder:
|
||
|
||
```bash
|
||
./install.sh
|
||
```
|
||
|
||
Der Plugin-Installer benötigt kein `sudo` und schreibt nur nach:
|
||
|
||
```text
|
||
~/.config/omarchy/plugins/local.omarchy-citizen/
|
||
```
|
||
|
||
Nach der Installation erscheint **✦SC** in der Omarchy-Leiste.
|
||
|
||
---
|
||
|
||
## 2. Erstes Setup
|
||
|
||
Klicke:
|
||
|
||
**✦SC → EINRICHTEN & STARTKLAR MACHEN**
|
||
|
||
Omarchy Citizen übernimmt danach soweit möglich selbst:
|
||
|
||
- benötigte Systempakete prüfen/installieren
|
||
- `zenity`, `polkit`, `cabextract`, `unzip`
|
||
- LUG Helper aus dem AUR installieren
|
||
- LUG Preflight Check starten
|
||
- Star-Citizen-/RSI-Launcher-Einrichtung starten
|
||
- vorhandenen Wine-Prefix erkennen
|
||
- Start-Script erkennen/reparieren
|
||
|
||
Für Paketinstallationen kann einmal ein sichtbares Omarchy-Terminal erscheinen.
|
||
Das ist absichtlich so, damit Passwortabfragen sicher und nachvollziehbar bleiben.
|
||
Der Nutzer muss dort keine Paketnamen oder Linux-Befehle kennen.
|
||
|
||
---
|
||
|
||
## 3. Normaler Alltag
|
||
|
||
Wenn das Panel **FLIGHT READY** zeigt:
|
||
|
||
**✦SC → STAR CITIZEN STARTEN**
|
||
|
||
Das Plugin verwendet weiterhin das vom LUG Helper verwaltete `sc-launch.sh`.
|
||
|
||
---
|
||
|
||
## 4. Problem beheben
|
||
|
||
Klicke:
|
||
|
||
**✦SC → Problem beheben**
|
||
|
||
Der Assistent prüft zuerst automatisch, ob etwas offensichtlich fehlt.
|
||
|
||
Wenn das System grundsätzlich eingerichtet ist, fragt er nur nach dem Symptom:
|
||
|
||
- Automatisch prüfen
|
||
- RSI Launcher startet nicht / ist kaputt
|
||
- Star Citizen startet nicht
|
||
- Grafik / Performance / Abstürze
|
||
- NGL macht Probleme
|
||
- Problem unklar
|
||
|
||
Dahinter werden die passenden LUG-Helper-Funktionen aufgerufen.
|
||
|
||
Der Nutzer muss keine Begriffe wie Wine-Prefix, DXVK oder `vm.max_map_count` kennen.
|
||
|
||
---
|
||
|
||
## 5. Permanentes Debug-Log
|
||
|
||
Omarchy Citizen protokolliert seine eigenen Aktionen dauerhaft unter:
|
||
|
||
```text
|
||
~/.local/state/omarchy-citizen/omarchy-citizen.log
|
||
```
|
||
|
||
Darin stehen unter anderem:
|
||
|
||
- Plugin-Version
|
||
- aufgerufene Plugin-Aktionen
|
||
- Start-/Reparaturvorgänge
|
||
- LUG-Helper-Aufrufe
|
||
- Setup-/Update-Abläufe
|
||
- Fehlermeldungen des Plugins
|
||
|
||
Das lokale Roh-Log kann in **Erweiterte Optionen → Plugin-Debuglog öffnen**
|
||
angesehen werden.
|
||
|
||
Das Roh-Log wird nicht automatisch hochgeladen oder versendet. Ab ungefähr 4 MiB wird es automatisch gekürzt; die neuesten ungefähr 2 MiB bleiben erhalten.
|
||
|
||
---
|
||
|
||
## 6. Support-Paket für Nutzer
|
||
|
||
Klicke:
|
||
|
||
**✦SC → Support-Paket erstellen**
|
||
|
||
Das Plugin erzeugt automatisch eine Datei wie:
|
||
|
||
```text
|
||
~/Downloads/Omarchy-Citizen-Support-OC-20260831-123456-abcdef.tar.gz
|
||
```
|
||
|
||
Zusätzlich wird eine **Support-ID** angezeigt.
|
||
|
||
### Standardmäßig enthalten
|
||
|
||
- Omarchy Citizen Status
|
||
- Plugin-Version
|
||
- `omarchy debug --no-sudo --print`
|
||
- Kernel/Desktop-Informationen
|
||
- GPU/Vulkan-Zusammenfassung
|
||
- RAM
|
||
- Dateisystemtyp und freier Speicher
|
||
- relevante Paketversionen
|
||
- Star-Citizen-Kernel-Limits
|
||
- Plugin-Validierung
|
||
- letzte Omarchy-Citizen-Debugmeldungen
|
||
- letzter Omarchy-Update-Logauszug, falls vorhanden
|
||
- Star-Citizen-/LUG-Pfadstatus
|
||
- begrenzter `sc-launch.log`-Auszug
|
||
- bereinigte Kopie des LUG-Start-Scripts
|
||
- Go-Updater-Status (Git/ZIP, Auto-Update, Commit-Stand)
|
||
- bereinigter Updater-Logauszug
|
||
|
||
### Nicht standardmäßig enthalten
|
||
|
||
- Browserdaten
|
||
- SSH-Schlüssel
|
||
- Passwortdateien
|
||
- vollständige Star-Citizen-Game.log-Dateien
|
||
- vollständige EAC-Logs
|
||
- Dateien aus dem RSI-Account/Browserprofil
|
||
|
||
### Automatische Maskierung beim Export
|
||
|
||
Das Support-Paket versucht folgende Daten zu maskieren:
|
||
|
||
- Home-Pfad
|
||
- Benutzername
|
||
- Hostname
|
||
- E-Mail-Adressen
|
||
- IPv4-Adressen
|
||
- MAC-Adressen
|
||
- Bearer-/JWT-Tokens
|
||
- typische `token`, `session`, `cookie`, `password`, `secret`-Werte
|
||
- typische Auth-Queryparameter in URLs
|
||
|
||
Die Maskierung ist eine Best-Effort-Funktion. Nutzer können das Archiv vor dem
|
||
Versenden selbst öffnen und prüfen.
|
||
|
||
---
|
||
|
||
## 7. Updates
|
||
|
||
### Plugin selbst
|
||
|
||
0.6.0 enthält ein statisch gebautes Go-Backend. Es erkennt automatisch, ob Omarchy
|
||
Citizen als Git-Plugin oder aus einem ZIP installiert wurde.
|
||
|
||
Bei einer Git-Installation gibt es unter **Erweiterte Optionen → Plugin-Updates**:
|
||
|
||
- **Plugin-Update prüfen**
|
||
- **Plugin jetzt aktualisieren**
|
||
- **Auto-Updates einschalten/ausschalten**
|
||
- **Updater-Log öffnen**
|
||
|
||
Beim Aktivieren von Auto-Updates wird das aktuelle Git-`origin` als vertrauenswürdige
|
||
Quelle gespeichert. Ein systemd-User-Timer prüft ungefähr alle sechs Stunden mit einer
|
||
zufälligen Verzögerung von bis zu 15 Minuten.
|
||
|
||
Ein automatisches Update wird verweigert, wenn:
|
||
|
||
- das Git-Remote nachträglich geändert wurde
|
||
- lokale Änderungen im Plugin-Checkout liegen
|
||
- der lokale Branch vom Upstream abgewichen ist
|
||
- bereits ein anderes Plugin-Update läuft
|
||
- Omarchys Plugin-Validierung fehlschlägt
|
||
|
||
Das Backend baut keinen eigenen Plugin-Paketmanager. Die eigentliche Aktualisierung läuft
|
||
über Omarchys offiziellen nicht-interaktiven Weg:
|
||
|
||
```bash
|
||
omarchy plugin update local.omarchy-citizen --yes
|
||
```
|
||
|
||
Dadurch bleiben Fast-Forward-Prüfung, Validierung und Rollback bei Omarchy.
|
||
|
||
Bei der aktuellen ZIP-Installation zeigt das Backend bewusst **ZIP / nicht Git-verwaltet**.
|
||
Es lädt dann nichts aus einer erfundenen oder unbekannten Quelle herunter. Sobald das
|
||
Projekt als GitHub-/Git-Repository veröffentlicht und mit `omarchy plugin add` installiert
|
||
wird, erkennt das Backend `origin` automatisch.
|
||
|
||
### LUG und Omarchy
|
||
|
||
Zusätzlich befinden sich unter **Erweiterte Optionen**:
|
||
|
||
- LUG Update prüfen
|
||
- LUG aktualisieren
|
||
- Omarchy aktualisieren
|
||
|
||
Systempakete werden weiter über den normalen `omarchy update`-Weg aktualisiert.
|
||
Dadurch bleiben Omarchy-Migrationen und der vorgesehene Update-Ablauf erhalten.
|
||
|
||
### Updater-Dateien
|
||
|
||
```text
|
||
~/.config/omarchy-citizen/updater.json
|
||
~/.local/state/omarchy-citizen/updater.log
|
||
~/.local/lib/omarchy-citizen/omarchy-citizen-backend
|
||
```
|
||
|
||
Der Updater läuft nicht als dauerhafter Webserver. Der systemd-User-Timer startet ihn nur
|
||
für die jeweilige Prüfung.
|
||
|
||
---
|
||
|
||
## 8. NGL
|
||
|
||
NGL bleibt unter **Erweiterte Optionen** und ist deutlich als experimentell markiert.
|
||
|
||
Der normale Star-Citizen-Betrieb ist nicht von NGL abhängig.
|
||
|
||
---
|
||
|
||
## 9. Supportablauf für dich als Plugin-Betreuer
|
||
|
||
Wenn ein Nutzer ein Problem meldet, kannst du ihn bitten:
|
||
|
||
1. **✦SC** öffnen
|
||
2. **Support-Paket erstellen** klicken
|
||
3. dir die erzeugte `.tar.gz` schicken
|
||
4. die angezeigte Support-ID nennen
|
||
|
||
Damit brauchst du im ersten Supportkontakt normalerweise keine Terminalbefehle
|
||
vom Nutzer anzufordern.
|
||
|
||
|
||
## Hotfix 0.6.4 – Setup-Button
|
||
|
||
Version 0.6.4 ändert die Ausführung der Panel-Aktionen grundlegend.
|
||
|
||
Beim Klick auf **EINRICHTEN & STARTKLAR MACHEN** wird die Aktion nun direkt als
|
||
Quickshell-Prozess gestartet. Das Panel zeigt sofort **WIRD GESTARTET**.
|
||
|
||
Wenn der Start fehlschlägt, bleibt das Panel offen und zeigt den Fehler an.
|
||
Außerdem wird der fehlgeschlagene Terminalstart in
|
||
`~/.local/state/omarchy-citizen/omarchy-citizen.log` protokolliert und landet
|
||
im Support-Paket.
|
||
|
||
Nach der Installation wird der Omarchy-Shellprozess einmal neu gestartet, damit
|
||
die neue QML-Version sicher aktiv ist.
|
||
|
||
## 0.6.4 – unvollständiger Wine-Prefix
|
||
|
||
Ein Ordner wie `~/Games/star-citizen` gilt jetzt erst dann als fertiger Wine-Prefix,
|
||
wenn mindestens `drive_c`, `system.reg` und `user.reg` existieren.
|
||
|
||
Wenn nur Runner/Teildateien vorhanden sind, zeigt das Plugin **SETUP REPAIR**.
|
||
|
||
Bei **SETUP SICHER REPARIEREN** wird der alte Ordner nicht gelöscht. Ohne erkannte
|
||
`Data.p4k`-Spieldatei wird er nach `star-citizen-incomplete-<Zeitstempel>` umbenannt,
|
||
die LUG-Zielkonfiguration wird gesichert und der offizielle LUG-Installer startet neu.
|
||
|
||
Das Support-Paket enthält jetzt außerdem den neuesten detaillierten
|
||
`lughelper-install-*.log`, damit Wine-/Winetricks-Fehler analysiert werden können.
|