nestris-terminal Retroverse Terminal¶
nestris-terminal ist der Selbstbedienungs-Kiosk für Spieler. Er läuft im Vollbild auf einem Touch-PC mit RFID-Leser, ohne Tastatur und Maus. Spieler melden sich an, lassen ihre persönliche Karte beschreiben, sehen Statistik und Platzierung und schauen Replays ihrer eigenen Spiele.
Das Terminal ist ein reiner Client von NestrisLTM. Es greift nie auf die Datenbank zu und spricht mit dem Host nur ĂĽber eine tokengeschĂĽtzte REST-API.
Repository Neueste Version laden
Was Spieler sehen¶
| Situation | Bildschirm |
|---|---|
| Keine Karte am Leser | Hauptmenü (Attract-Modus): Highscore des aktiven Events, Replays anderer Spieler, Knopf „Neu anmelden“ |
| Bekannte Karte aufgelegt | Spielerseite: Gesamtstatistik, Verlauf pro Event, aktuelles Event (Platz, Bestwert, Abstand zum nächsten Platz), eigene Spiele mit Replay, „Score eintragen“ |
| Leere Karte aufgelegt | Anmeldung, Karte bereits zugeordnet |
| Ältere Karte mit Namen, aber unbekannter UID | Über den Namen gefunden, danach wird die Karte dem bestehenden Spieler zugeordnet |
| „Neu anmelden“ ohne Karte | Geführter Ablauf: Daten → „Karte auflegen“ → Karte wird beschrieben → „Karte bitte entnehmen“ → fertig |
| Karte abgenommen | Spielerseite schlieĂźt nach 3 s, oder nach 2 Minuten ohne BerĂĽhrung |
stateDiagram-v2
direction LR
state "MenĂĽ" as Menu
state "Spielerseite" as Player
state "Anmeldung" as Register
state "Karte schreiben" as WriteCard
state "Score eintragen" as ScoreEntry
[*] --> Menu
Menu --> Player: bekannte Karte
Menu --> Register: leere Karte
Menu --> Register: Neu anmelden
Register --> WriteCard: Daten eingegeben
WriteCard --> Player: Karte beschrieben + geprĂĽft
Player --> Replay: Spiel auswählen
Replay --> Player
Player --> ScoreEntry: Score eintragen
ScoreEntry --> Player
Player --> Menu: Karte weg (3 s) / inaktiv (2 min)
Anmeldung: Nickname (Pflicht, eindeutig, wird beim Tippen geprüft), Vor- und Nachname sowie E-Mail-Adresse mit Einwilligungs-Häkchen. Öffentlich wird immer nur der Nickname gezeigt.
Selbst eingetragene Scores (zum Beispiel von einer Konsole ohne Station) zählen sofort, sind aber als self_reported markiert, damit die Crew sie prüfen oder ausblenden kann.
Für Touch gemacht. Eingebaute Bildschirmtastatur und Ziffernblock, Touch-Flächen von mindestens 56 px, standardmäßig Deutsch, Englisch umschaltbar. Replays nutzen denselben NES-Renderer wie NestrisLTM.
Architektur¶
flowchart LR
U["<span style='color:#111111'>Touch-Oberfläche<br/>Svelte 5</span>"]:::term <--> B["<span style='color:#111111'>Lokale Bridge<br/>FastAPI 127.0.0.1:7991</span>"]:::term
K["<span style='color:#111111'>Kiosk-Fenster<br/>PySide6 / QWebEngine</span>"]:::term --> U
B <-- "USB-Seriell · v2" --> R["<span style='color:#111111'>RFID-Leser</span>"]:::rfid
B -- "REST + Bearer-Token<br/>/api/terminal/v1" --> L["<span style='color:#111111'>NestrisLTM :7990</span>"]:::ltm
classDef ltm fill:#f5b800,stroke:#7a5c00,color:#111,stroke-width:2px
classDef term fill:#a78bfa,stroke:#6d28d9,color:#111,stroke-width:2px
classDef rfid fill:#f472b6,stroke:#be185d,color:#111,stroke-width:2px
- Die Bridge besitzt den Leser und das Host-Token. Die Browser-Oberfläche spricht nur mit
127.0.0.1. - Der Leser muss Protokoll v2 sprechen. Ältere Firmware wird mit der Meldung „Leser-Firmware veraltet“ abgewiesen.
- Ein simulierter Lesertreiber erlaubt es der Crew, den ganzen Ablauf ohne Hardware zu testen.
- Ein verstecktes, PIN-geschütztes Admin-Menü hat drei Reiter: Einstellungen, Leser (Displaygröße, Helligkeit, Drehung) und Debug.
Die verwendete API steht in der Terminal-API-Referenz.
Installation¶
RetroverseTerminal-Setup-<version>.exevom neuesten Release laden. Es installiert pro Benutzer und braucht keine Administratorrechte.- Im Assistenten die NestrisLTM-URL (zum Beispiel
http://192.168.1.10:7990) und ein Token mit Scopeterminaleintragen. - Autostart und Desktop-Symbol wählen. Startmenü-Einträge: Retroverse Terminal (Kiosk) und Retroverse Terminal (Fenster).
- Leser anstecken. Der Port wird automatisch erkannt (CP210x / CH340).
Kiosk absichern
Für den unbeaufsichtigten Betrieb automatische Anmeldung aktivieren, Energiesparen und Benachrichtigungen abschalten und die Windows-Randwischgeste deaktivieren (AllowEdgeSwipe=0). So können Spieler den Kiosk nicht verlassen.
Kommandozeile¶
| Befehl | Zweck |
|---|---|
nestris-terminal configure --host … --token … |
Host und Token setzen, optional auch Leser-Port, Treiber und Sprache |
nestris-terminal autostart on\|off\|status |
Start bei der Anmeldung |
nestris-terminal set-pin |
Admin-PIN ändern |
nestris-terminal config-path |
Pfad der Konfiguration anzeigen |
nestris-terminal --windowed |
Im Fenster statt im Vollbild starten |
Konfiguration¶
Die Konfiguration liegt in %APPDATA%\NestrisTerminal\config.toml. Umgebungsvariablen NESTRIS_TERMINAL__<SECTION>__<KEY> ĂĽberschreiben sie.
| SchlĂĽssel | Standard |
|---|---|
host.url |
http://127.0.0.1:7990 |
host.token |
Token mit Scope terminal |
rfid.driver |
serial (oder fake) |
rfid.port |
leer = automatisch erkennen |
kiosk.lang |
de |
kiosk.card_grace_s |
3 |
kiosk.idle_timeout_s |
120 |
http.port |
7991 (nur lokal) |
Release-Dateien¶
| Datei | Zweck |
|---|---|
RetroverseTerminal-Setup-<v>.exe |
Installer pro Benutzer (Deutsch / Englisch) |
RetroverseTerminal-<v>-portable.zip |
Portable Ordner-Version |
SHA256SUMS.txt / .sig |
PrĂĽfsummen und Ed25519-Signatur |