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>.exevom 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
stationsund eines mit Scopeterminalanlegen. 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:
/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: okund den Lock-Zustand.
5 · Anmelde-Terminal¶
-
RetroverseTerminal-Setup-<version>.exeauf dem Touch-PC installieren. Es braucht keine Administratorrechte. - Im Assistenten die Host-URL
http://192.168.50.10:7990und dasterminal-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. |