Zum Inhalt

NestrisLTM Local Tournament Manager

Latest release CI Platform Python Beta

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/highscore ist 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

  1. NestrisLTM-Setup-<version>.exe vom neuesten Release laden und mit Administratorrechten ausfĂĽhren.
  2. 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.
  3. Beim ersten Start das erste Admin-Konto anlegen. Das geht nur direkt am Host-PC.
  4. Unter Einstellungen → API-Tokens Tokens für die Stationen (Scope stations) und das Terminal (Scope terminal) anlegen.
  5. 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
🟢 grün Datenbank und Broker OK
đźź  orange Datenbank oder Broker nicht erreichbar
🔴 rot 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.

config.toml (Auszug)
[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.