NestrisLTM Local Tournament Manager¶
NestrisLTM ist die Host-Anwendung des Turniers und das Herz der Suite. Sie läuft auf dem Host-PC und empfängt Live-Daten und Ergebnisse aller Stationen über MQTT. Spieler, Spiele und Events hält sie in PostgreSQL, und sie liefert alles, was man sieht: die Admin-Oberfläche, die OBS-Overlays, die Highscore- und Turnierbaum-Anzeige und die API für das Spieler-Terminal.
Repository Neueste Version laden
Funktionen¶
-
Admin-Oberfläche (Deutsch / Englisch)
- Dashboard: Datenbank, Broker, Stationen, laufende Spiele, Log
- Spieler: anlegen, bearbeiten, zusammenfĂĽhren, suchen; mehrere Karten pro Spieler
- Spiele: Filter nach Event, Station, Cheat oder ungĂĽltig; bearbeiten, neu zuordnen, ausblenden
- Events mit Zeitfenster; genau eines ist aktiv
- Stationen, Turnierkonsole, Szenen, Audit-Log
- Einstellungen: Admin-Konten und API-Tokens; Updates
-
Highscore- & Turnierbaum-Anzeige
/view/highscoreist eine Vollbild-Anzeige. Laufende Spiele erscheinen live mit grĂĽnem Punkt. Sie animiert Wechsel zwischen Liste und Turnierbaum und zeigt Banner fĂĽr neuen Rekord, FĂĽhrungswechsel und Meilensteine, einen Score-Zug, CRT-Effekt und eine Siegerfeier. -
Turnierkonsole
K.-o.-Turnierbaum für 2–64 Spieler mit Freilosen und Spiel um Platz 3. Sieger per Klick setzen; FIX, RESET und UNSEED. Die Konsole steuert auch die Anzeige fern: Schriftgröße, Autoscroll, Effekte, Transparenz, Siegerfeier. Der Turnierbaum übersteht Neustarts.
-
OBS-Szenen
Jede Szene hat eine feste URL
/o/<slug>mit Layout und einer Station pro Slot, als transparentes 1920Ă—1080-Overlay. Siehe Streaming & OBS. -
Replays
Jedes Spiel wird framegenau als NGF gespeichert. Wiedergabe mit 0,25×–8×, Spulen und Einzelbildschritten. Spiele lassen sich als NGF importieren und exportieren.
-
Integrität & Audit
Cheat- und ungültige Spiele zählen, tragen aber ein Abzeichen und haben einen eigenen Filter. Jede Änderung wird mit Vorher/Nachher protokolliert. Alle schreibenden APIs brauchen Tokens mit passendem Scope.
Architektur auf einen Blick¶
flowchart LR
ST["<span style='color:#111111'>Stationen</span>"]:::core -- "MQTT" --> MQ["<span style='color:#ffffff'>Mosquitto</span>"]:::ext --> ING["<span style='color:#111111'>Ingest</span>"]:::ltm
ST -- "PUT .ngf.gz" --> API
ING --> HUB["<span style='color:#111111'>LiveHub</span>"]:::ltm --> WS["<span style='color:#111111'>WebSocket-Hub</span>"]:::ltm
ING --> SP["<span style='color:#111111'>Spool → Worker</span>"]:::ltm --> DB[("<span style='color:#ffffff'>PostgreSQL</span>")]:::ext
DB <--> API["<span style='color:#111111'>FastAPI :7990</span>"]:::ltm
WS --> API
API --> ADM["<span style='color:#ffffff'>Admin-Oberfläche</span>"]:::ext
API --> OV["<span style='color:#ffffff'>Overlays /o/…</span>"]:::ext
API --> HS["<span style='color:#ffffff'>/view/highscore</span>"]:::ext
API --> TAPI["<span style='color:#111111'>/api/terminal/v1</span>"]:::term
API -. "cmd show" .-> MQ
classDef ltm fill:#f5b800,stroke:#7a5c00,color:#111,stroke-width:2px
classDef core fill:#22d3ee,stroke:#0e7490,color:#111,stroke-width:2px
classDef term fill:#a78bfa,stroke:#6d28d9,color:#111,stroke-width:2px
classDef ext fill:#64748b,stroke:#334155,color:#fff,stroke-width:2px
Details: Systemarchitektur.
Runden & Versus-Werte¶
Szenen arbeiten in Runden. Wenn das Spiel auf einem Slot endet, friert das Ergebnis dieses Slots ein. Weitere Spiele auf dem Slot werden ignoriert, bis die Crew eine neue Runde startet: von Hand („Neue Runde“), automatisch („Auto-Runde“) oder per Stream Deck. „Slot zurücksetzen“ lässt einen einzelnen Slot erneut spielen.
Der Server berechnet die Versus-Werte, damit jedes Overlay dieselben Zahlen zeigt:
- Score-Differenz und Live-Differenzgraph
- Vorsprung in Tetrissen: Vorsprung Ă· (1200 Ă— (Level + 1)) des zurĂĽckliegenden Spielers
- Pace hochgerechnet auf Level 29
- „braucht N Tetrisse“ für den zurückliegenden Spieler
Installation¶
NestrisLTM-Setup-<version>.exevom neuesten Release laden und mit Administratorrechten ausführen.- Der Assistent installiert PostgreSQL 18 und Mosquitto 2.1.2, falls sie fehlen (offizielle Downloads, SHA-256-geprüft), oder nutzt vorhandene Installationen. Er stellt beide Dienste auf automatischen Start und legt Firewall-Regeln für TCP 7990 und 1883 an, beschränkt auf das lokale Subnetz.
- Beim ersten Start das erste Admin-Konto anlegen. Das geht nur direkt am Host-PC.
- Unter Einstellungen → API-Tokens Tokens für die Stationen (Scope
stations) und das Terminal (Scopeterminal) anlegen. - Ein Event anlegen und aktivieren. Das Dashboard zeigt jede Station, sobald sie sich verbindet.
Die vollständige Checkliste steht in der Anleitung Event aufbauen.
Tray-Icon¶
| Farbe | Bedeutung |
|---|---|
| Datenbank und Broker OK | |
| Datenbank oder Broker nicht erreichbar | |
| Kern läuft nicht (zum Beispiel Port 7990 belegt) |
Das Schließen des Fensters lässt NestrisLTM im Tray weiterlaufen. Beenden stoppt es sauber und schreibt vorher gepufferte Live-Frames.
Kommandozeile¶
Im Installationsordner liegen die Tray-App NestrisLTM.exe und die CLI nestris-ltm.exe:
| Befehl | Zweck |
|---|---|
nestris-ltm check |
PrĂĽft Datenbank, Broker und Port und nennt das Programm, das einen Port blockiert |
nestris-ltm configure … |
Ändert Verbindungseinstellungen, zum Beispiel --db-password, --http-port |
nestris-ltm autostart on\|off\|status |
Start im Tray bei der Anmeldung |
nestris-ltm set-admin-password |
Setzt ein Admin-Passwort zurĂĽck |
nestris-ltm migrate |
FĂĽhrt Datenbank-Migrationen aus |
nestris-ltm config-path |
Zeigt den Pfad der Konfigurationsdatei |
nestris-ltm --headless |
Startet den Kern ohne Qt-Shell |
nestris-ltm simulate |
Spielt NGF-Aufzeichnungen als simulierte MQTT-Stationen ab (Test ohne Hardware) |
Konfiguration¶
Die Konfiguration liegt in %APPDATA%\NestrisLTM\config.toml. Unbekannte SchlĂĽssel werden abgelehnt. Umgebungsvariablen NESTRIS_LTM__<SECTION>__<KEY> ĂĽberschreiben die Datei.
[database]
host = "127.0.0.1"
port = 5432
name = "nestrisltm"
[mqtt]
host = "127.0.0.1"
port = 1883
topic_prefix = "retroverse/nestris"
[http]
host = "0.0.0.0"
port = 7990
[updates]
enabled = true
channel = "stable" # oder "beta"
check_interval_h = 24
| Abschnitt | SchlĂĽssel |
|---|---|
| oberste Ebene | data_dir |
[database] |
host, port, user, password, name, pool_size, connect_timeout_s |
[mqtt] |
enabled, host, port, username, password, topic_prefix, client_id, keepalive_s, reconnect_max_s |
[http] |
host, port |
[log] |
level, to_file, buffer_size |
[updates] |
enabled, channel, owner, repo, token, check_interval_h, pg_dump |
Logs, Spool und Update-Backups liegen unter %APPDATA%\NestrisLTM\.
Release-Dateien¶
| Datei | Zweck |
|---|---|
NestrisLTM-Setup-<v>.exe |
Installer (Deutsch / Englisch), auch fĂĽr Updates |
NestrisLTM-<v>-portable.zip |
Portable Ordner-Version |
SHA256SUMS.txt / .sig |
PrĂĽfsummen und Ed25519-Signatur |
Zur PrĂĽfung siehe Downloads, zum eingebauten Update-Manager siehe Updates.