Zum Inhalt

nestris-terminal Retroverse Terminal

Latest release CI Platform Input Beta

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

  1. RetroverseTerminal-Setup-<version>.exe vom neuesten Release laden. Es installiert pro Benutzer und braucht keine Administratorrechte.
  2. Im Assistenten die NestrisLTM-URL (zum Beispiel http://192.168.1.10:7990) und ein Token mit Scope terminal eintragen.
  3. Autostart und Desktop-Symbol wählen. Startmenü-Einträge: Retroverse Terminal (Kiosk) und Retroverse Terminal (Fenster).
  4. 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