Zum Inhalt

Event aufbauen

Diese Anleitung führt von leeren Tischen zum laufenden Turnier. Für den ersten Aufbau rund eine Stunde einplanen. Spätere Events verwenden die Installation weiter und brauchen nur ein neues Event.

flowchart LR
    A["<span style='color:#ffffff'>1 · Netzwerk</span>"]:::ext --> B["<span style='color:#111111'>2 · Host-PC</span>"]:::ltm --> C["<span style='color:#111111'>3 · Tokens & Event</span>"]:::ltm --> D["<span style='color:#111111'>4 · Stationen</span>"]:::core --> E["<span style='color:#111111'>5 · Terminal</span>"]:::term --> F["<span style='color:#ffffff'>6 · Bildschirme & OBS</span>"]:::ext --> G["<span style='color:#111111'>7 · Testspiel</span>"]:::ltm

    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

1 · Netzwerk

  • Einen eigenen Switch (oder ein VLAN) für das Turnier aufstellen und Host-PC, Stationen, Terminal und Stream-PC möglichst per Kabel anschließen.
  • Dem Host-PC eine feste IP-Adresse geben, zum Beispiel 192.168.50.10. Alle anderen Geräte zeigen darauf.
  • Während des Events wird kein Internet gebraucht, nur zum Herunterladen von Updates.

2 · Host-PC

  • NestrisLTM-Setup-<version>.exe vom neuesten Release laden und prüfen.
  • Den Installer als der Windows-Benutzer ausführen, der das Turnier betreibt, dann:
    • PostgreSQL 18 und Mosquitto angehakt lassen (oder abwählen, um vorhandene Server zu nutzen),
    • Autostart und Firewall-Regeln anhaken (TCP 7990 und 1883, nur lokales Subnetz),
    • das PostgreSQL-Passwort wählen und aufschreiben.
  • Auf die abschließende Prüfseite warten. Datenbank, Broker und Port müssen grün sein.
  • NestrisLTM öffnet sich. Das erste Admin-Konto anlegen.

Status auf einen Blick

Das Tray-Icon ist grün, wenn Datenbank und Broker laufen, und orange, wenn einer fehlt. Mit der Maus darüberfahren für Details, oder nestris-ltm check ausführen.

3 · Tokens & Event

  • Einstellungen → API-Tokens: ein Token mit Scope stations und eines mit Scope terminal anlegen. Gleich kopieren, sie werden nur einmal angezeigt.
  • Events: Event anlegen (Name und Zeitfenster) und aktivieren. Highscore, Turnierbaum und Overlays zeigen immer das aktive Event.

4 · Stationen

Auf jeder Debian-Station:

sudo apt install ./nestris-station_<version>-1_amd64.deb
sudoedit /etc/nestris-station/station.toml
/etc/nestris-station/station.toml (minimal)
[station]
id = "station-1"            # pro Station eindeutig
name = "Station 1"

[capture]
device = "/dev/v4l/by-id/usb-…-video-index0"   # siehe: nestris-station list-devices

[rfid]
port = "/dev/serial/by-id/usb-…"

[mqtt]
host = "192.168.50.10"      # Host-PC
live_max_hz = 60

[host]
url = "http://192.168.50.10:7990"
token_file = "/etc/nestris-station/host.token"   # Token mit Scope "stations"
sudo nestris-station check-config          # prüft die Datei, verbirgt Geheimnisse
sudo nestris-station test-mqtt             # prüft, ob der Broker erreichbar ist
sudo systemctl enable --now nestris-station
  • Die Station erscheint innerhalb von Sekunden im Dashboard von NestrisLTM.
  • NES-Capture und Leser anstecken. Das Dashboard zeigt capture: ok, rfid: ok und den Lock-Zustand.

5 · Anmelde-Terminal

  • RetroverseTerminal-Setup-<version>.exe auf dem Touch-PC installieren. Es braucht keine Administratorrechte.
  • Im Assistenten die Host-URL http://192.168.50.10:7990 und das terminal-Token eintragen.
  • Leser anstecken. Das Terminal findet ihn automatisch.
  • Kiosk absichern: automatische Anmeldung, kein Energiesparen, keine Benachrichtigungen, Randwischgeste aus.

6 · Bildschirme & OBS

Ausgabe URL
Hallenanzeige (Highscore + Turnierbaum) http://192.168.50.10:7990/view/highscore
Nur Highscore / nur Turnierbaum …/view/highscore?only=highscore / ?only=bracket
Transparent für OBS …/view/highscore?transparent=1
Stream-Overlay einer Szene http://192.168.50.10:7990/o/<szenen-slug>
Admin von einem anderen PC http://192.168.50.10:7990/

Szenen unter Szenen anlegen. Siehe Streaming & OBS.

7 · Testspiel

  • Am Terminal einen Testspieler anmelden und eine Karte beschreiben lassen.
  • Die Karte an einer Station auflegen. Der Leser zeigt den Nickname.
  • Ein kurzes Spiel spielen. Das Overlay zeigt es live, und nach dem Game Over aktualisiert sich der Highscore.
  • Das Spiel in der Admin-Oberfläche öffnen und als Replay abspielen, um zu prüfen, dass die Aufzeichnung angekommen ist.
  • Den Testspieler ausblenden oder löschen, bevor die Türen öffnen.

Während des Events

  • Das Dashboard im Auge behalten: Stationen, Capture-Zustand, laufende Spiele, Log.
  • Spiele mit Cheat- oder Ungültig-Markierung haben einen eigenen Filter. Sie prüfen und das Replay als Beweis nutzen.
  • Die Datenbank vor und nach jedem Tag sichern:
& "C:\Program Files\PostgreSQL\18\bin\pg_dump.exe" -U postgres -Fc -f "D:\Backup\nestrisltm-$(Get-Date -f yyyyMMdd-HHmm).dump" nestrisltm

Fehlersuche

Symptom Prüfen
Tray orange, Datenbank rot Dienst postgresql-x64-18 gestartet? Passwort in der Konfiguration richtig (nestris-ltm configure --db-password)?
Tray orange, MQTT rot Dienst Mosquitto Broker gestartet? C:\ProgramData\mosquitto\mosquitto.log ansehen.
Tray rot / Port belegt Ein anderes Programm nutzt 7990. nestris-ltm check nennt es; mit --http-port ändern.
Station erscheint nicht Station mqtt.host = Host-IP, gleiches topic_prefix, Firewall-Regel für 1883, gleiches Subnetz.
Aufzeichnungen fehlen Station host.url und Token (Scope stations), Firewall-Regel für 7990. Die Station wiederholt Uploads aus ihrer Warteschlange.
Leser zeigt PC getrennt USB-Kabel oder Port; an der Station status.rfid prüfen.
Station meldet rfid: outdated Auf dem Leser läuft alte Firmware. Das aktuelle nestris-rfid-reader-Release flashen.