Billard Scoreboard Dokumentation v4.0

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

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 Winner-/Wechselbreak NEU

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

10 Hilfe-Buttons (Regeln & Aufbau) NEU

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

Inhalte pro Disziplin

11 GD (Gesamtdurchschnitt) NEU

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

12 14/1 Verlauf (Spieler-Statistik) NEU

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

13 Mehrsprachigkeit (i18n) NEU

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

14 14/1 Live-Aufnahmen NEU

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

15 Neue Disziplinen NEU

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.

16 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)

17 PIN-System

18 API-Endpunkte

19 Fehlersuche

20 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.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.0 | Entwickelt für Billard-Spieler