Billard Scoreboard Dokumentation v4.2

Diese Dokumentation enthält alle Schritte zur Installation sowie Erklärungen zur Tischansteuerung, UI-Logik, Training-Features und OBS-Integration.

1 Voraussetzungen

• Getestet auf Ubuntu Server (24.04 LTS)
• PHP 8.3 mit SQLite3-Unterstützung
• Nginx Webserver
• Internetverbindung für Material Design Icons (MDI)

2 System-Installation

sudo apt update
sudo apt install nginx php8.3-fpm php8.3-sqlite3 -y

3 Ordnerstruktur

sudo mkdir -p /var/www/billard/assets/css
sudo mkdir -p /var/www/billard/assets/js
sudo mkdir -p /var/www/billard/logos

4 Rechte vergeben

sudo chown -R www-data:www-data /var/www/billard
sudo chmod -R 775 /var/www/billard

oder z.B.:

sudo chown -R www-data:www-data /var/www/html
sudo chmod -R 775 /var/www/html

je nachdem wo die Dateien liegen.

5 Nginx Konfiguration

Konfigurationspfad: /etc/nginx/sites-available/default

server {
    listen 80;
    root /var/www/billard;
    index index.php index.html;

    location / {
        try_files $uri $uri/ =404;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;
    }
}

sudo nginx -t
sudo systemctl restart nginx

6 URL-Übersicht

7 Tisch-Steuerung via URL

Farbschema via URL NEU

Das Farbschema kann direkt über einen URL-Parameter gesetzt werden. Sowohl deutsche als auch englische Bezeichnungen werden akzeptiert:

Sprache via URL NEU

Die Sprache kann direkt über einen URL-Parameter gesetzt werden:

8 OBS Studio Integration NEU

Einrichtung in OBS

1. In OBS: Quellen → + → Browser
2. Name eingeben (z.B. "Scoreboard Tisch 1")
3. URL eingeben: http://[SERVER-IP]/obs_big.php?Tisch=1
4. Breite: 1400 (big) oder 700 (small)
5. Höhe: 150 (big) oder 100 (small)
6. "Benutzerdefiniertes CSS" leer lassen
7. "Aktualisieren wenn Szene aktiv" aktivieren

Empfohlene Größen

Vereins-Logos einrichten

Logos werden automatisch angezeigt, wenn eine PNG-Datei mit dem exakten Vereinsnamen existiert:

# Logo-Ordner erstellen
sudo mkdir -p /var/www/billard/logos

# Logos hochladen (Beispiele)
/var/www/billard/logos/BC Berlin.png
/var/www/billard/logos/BC Bremen.png
/var/www/billard/logos/Imperium.png

9 Spielzeit & Header-Anzeige NEU v4.2

Während eines laufenden Spiels werden im Header die Disziplin und die laufende Spielzeit angezeigt.

Funktionen

• Die aktuelle Disziplin wird zentriert im Header angezeigt
• Darunter läuft die Spielzeit im Format HH:MM:SS
• Das Logo wird rechts im Header angezeigt (auf allen Seiten sichtbar)
• Bei Rematch läuft die Spielzeit ohne Unterbrechung weiter
• Beim Beenden des Spiels stoppt die Spielzeit

10 OBS Textdateien NEU v4.2

Zusätzlich zu den Browser-Overlays werden automatisch einzelne TXT-Dateien im Ordner /obs/ generiert. Diese können als Browser-Quellen in OBS eingebunden werden.

Verfügbare Dateien pro Tisch

Einrichtung in OBS (Browser-Quelle)

Die empfohlene Methode ist die Verwendung einer Browser-Quelle mit dem Plugin xObsBrowserAutoRefresh:

1. Plugin xObsBrowserAutoRefresh installieren
2. In OBS: Quellen → + → Browser
3. URL eingeben: http://[SERVER-IP]/obs/table1_score1.txt
4. Breite/Höhe nach Bedarf anpassen
5. Benutzerdefiniertes CSS für die Textformatierung eintragen:

body {
    color: #ffffff;
    font-family: "Arial";
    font-size: 40px;
    font-weight: bold;
    text-shadow: 2px 2px 4px #000000;
    overflow: hidden;
}

6. Rechtsklick auf die Browser-Quelle → Filter
7. Über + den Filter "Browser Auto-refresh" hinzufügen
8. Intervall auf 15 Sekunden stellen

11 Winner-/Wechselbreak

Bei 8-Ball, 9-Ball und 10-Ball kann im Setup der Break-Modus gewählt werden:

Ablauf

1. Im Setup Disziplin wählen (8-Ball, 9-Ball oder 10-Ball)
2. Break-Modus auswählen (Wechselbreak oder Winnerbreak)
3. Beim Klick auf SPIEL STARTEN erscheint das Popup "Wer beginnt mit dem Anstoß?"
4. Spieler auswählen - der aktive Spieler wird mit schwarzem Rahmen markiert
5. Bei REMATCH wird erneut gefragt, wer beginnt

12 Hilfe-Buttons (Regeln & Aufbau)

Alle Disziplinen (14/1, 8-Ball, 9-Ball, 10-Ball) haben einen Hilfe-Button (blaues Fragezeichen) in der Steuerungsleiste.

Inhalte pro Disziplin

13 GD (Gesamtdurchschnitt)

Der GD (Gesamtdurchschnitt = Punkte / Aufnahmen) wird bei 14/1-Spielen an mehreren Stellen angezeigt:

14 14/1 Verlauf (Spieler-Statistik)

Jeder Spieler hat nun ein Verlaufsdiagramm für seine 14/1 Spiele. Das Diagramm zeigt die Entwicklung von Höchstserie und GD über die letzten 20 Partien.

So öffnest du den Verlauf

1. Navigiere zur Spieler-Datenbank
2. Klicke auf eine Spielerkarte
3. Im Popup auf "14/1 Verlauf" (blauer Button) klicken

Diagramm-Erklärung

Statistik-Box

Unter dem Diagramm werden folgende Werte angezeigt:

• Ø Höchstserie - Durchschnitt aller angezeigten Höchstserien
• Max Höchstserie - Beste Höchstserie im Zeitraum
• Ø GD - Durchschnittlicher Gesamtdurchschnitt
• Max GD - Bester GD im Zeitraum
• Anzahl Spiele - Wie viele 14/1 Spiele angezeigt werden

15 Mehrsprachigkeit (i18n)

Das Scoreboard unterstützt nun vollständige Mehrsprachigkeit. Die Sprache kann jederzeit in der Sidebar umgeschaltet werden.

Unterstützte Sprachen

Sprachwechsel

1. Sidebar öffnen (Burger-Menü)
2. Unten auf DE oder EN klicken
3. Die gesamte UI wird sofort übersetzt

16 14/1 Live-Aufnahmen

Während eines 14/1-Spiels kann jederzeit eine Übersicht aller bisherigen Aufnahmen angezeigt werden.

So öffnest du die Übersicht

1. Während eines 14/1-Spiels
2. Klicke auf den History-Button (Uhr-Symbol) in der Steuerungsleiste
3. Ein Popup zeigt alle bisherigen Aufnahmen mit Punkten und Zwischenständen

Angezeigte Informationen

17 Neue Disziplinen

Rotation

61 Punkte-Spiel mit der 3-Foul-Regel. Verliert ein Spieler 3 Fouls in Folge, verliert er das Spiel.

One Pocket

Kugeln in die eigene Tasche versenken. Standardziel: 8 Kugeln.

Bank Pool 9-Ball

Nur Bankshots erlaubt. Ziel: 5 Kugeln.

Bank Pool 15-Ball

Nur Bankshots mit allen 15 Kugeln. Ziel: 8 Kugeln.

Doppel-Modi

8-Ball, 9-Ball und 10-Ball können als Doppel (2 vs 2) gespielt werden. Die Teamnamen werden automatisch kombiniert.

18 Equal Offense Training

Pool 14/1 Level (1-4)

9-Ball Level (1-3)

Bowlliards NEU

Bowling-Wertung auf dem Pooltisch. Einzelspieler-Training mit klassischer Bowling-Punkteberechnung.

Wertung

10. Frame Sonderregeln

• Strike: 2 Bonuswürfe (max. 3 Würfe gesamt)
• Spare: 1 Bonuswurf (max. 3 Würfe gesamt)
• Open: Kein Bonus (2 Würfe)

19 PIN-System

20 API-Endpunkte

21 Fehlersuche

22 Backup

# Backup erstellen
cd /var/www
sudo tar -czf billard-backup-$(date +%Y%m%d).tar.gz billard/

# Backup wiederherstellen
sudo tar -xzf billard-backup-20250127.tar.gz

Version History

• v4.2 (Februar 2026) - Spielzeit-Anzeige im Header (Disziplin + Timer), OBS-Textdateien (Einzeldateien pro Wert im /obs/ Ordner, konfigurierbares Intervall)
• v4.1 (Februar 2026) - URL-Parameter für Farbschema (theme) und Sprache (lang), OBS-Overlays mit i18n, monitor_en.php
• v4.0 (Februar 2026) - Mehrsprachigkeit (DE/EN), 14/1 Live-Aufnahmen Button, dunkler Button-Text, Rotation mit Foul-Logik, One Pocket, Bank Pool, Doppel-Modi
• v3.8 (Februar 2026) - 14/1 Verlauf im Spieler-Popup mit Kurvendiagramm (Höchstserie & GD), Chart.js Integration
• v3.5 (Februar 2026) - Bowlliards Training, Material Design Icons, einheitliche blaue Buttons, Browser-Kompatibilität (Firefox/Opera)
• v3.2 (Januar 2026) - Hilfe-Buttons 8/9/10-Ball, GD-Anzeige & Champion, EO4-Logik (14+X), History-PIN-Schutz
• v3.1 (Januar 2026) - Winner-/Wechselbreak, 4 neue OBS Overlays, Game Over Sperre
• v3.0a (Januar 2025) - Fix: Equal Offense Restart
• v3.0 (Januar 2025) - OBS Integration, Logos
• v2.0 (Januar 2025) - Equal Offense Training
• v1.0 (2024) - Basis-Scoreboard mit Monitor

Pro Billiard Scoreboard System v4.2 | Entwickelt für Billard-Spieler