Billard Scoreboard Dokumentation v4.5

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 {
    background-color: rgba(0, 0, 0, 0);
    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

CSS mit Textausrichtung

Um den Text vertikal zentriert und horizontal ausgerichtet darzustellen, folgende CSS-Varianten verwenden:

Text linksbündig:

body {
    background-color: rgba(0, 0, 0, 0);
    color: #ffffff;
    font-family: "Arial";
    font-size: 40px;
    font-weight: bold;
    text-shadow: 2px 2px 4px #000000;
    overflow: hidden;
    margin: 0;
    height: 100vh;
    display: flex;
    align-items: center;
    justify-content: flex-start;
}

Text zentriert:

body {
    background-color: rgba(0, 0, 0, 0);
    color: #ffffff;
    font-family: "Arial";
    font-size: 40px;
    font-weight: bold;
    text-shadow: 2px 2px 4px #000000;
    overflow: hidden;
    margin: 0;
    height: 100vh;
    display: flex;
    align-items: center;
    justify-content: center;
}

Text rechtsbündig:

body {
    background-color: rgba(0, 0, 0, 0);
    color: #ffffff;
    font-family: "Arial";
    font-size: 40px;
    font-weight: bold;
    text-shadow: 2px 2px 4px #000000;
    overflow: hidden;
    margin: 0;
    height: 100vh;
    display: flex;
    align-items: center;
    justify-content: flex-end;
}

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 (Server)

# 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

23 In-App Backup & Restore NEU v4.3

Direkt in der App können alle Daten als JSON-Datei exportiert und wieder importiert werden.

Backup erstellen

1. Navigiere zur Spieler-Datenbank
2. Klicke auf "Backup" (Download-Icon)
3. Eine JSON-Datei wird heruntergeladen: billard-backup-YYYY-MM-DD.json

Backup importieren

1. Klicke auf "Restore" (Upload-Icon)
2. Gib den Master-PIN ein
3. Wähle die JSON-Backup-Datei aus
4. Bestätige den Import - alle Daten werden überschrieben

Enthaltene Daten

• Spieler und Vereine
• Alle Statistiken (inkl. Disziplin-Stats, H2H)
• Spielhistorie
• Trainingsergebnisse

24 Rangliste NEU v4.3

Die Rangliste zeigt alle Spieler in einer sortierbaren Tabelle.

Sortieroptionen

Angezeigte Spalten

• # - Rang
• Name - Spielername und Verein
• Win% - Siegquote in Prozent
• W - Siege
• L - Niederlagen
• HS - Höchstserie
• GD - Bester Gesamtdurchschnitt

25 Spieler-Statistiken NEU v4.3

Detaillierte Statistiken pro Spieler, erreichbar über das Spieler-Action-Popup.

So öffnest du die Statistiken

1. Navigiere zur Spieler-Datenbank
2. Klicke auf eine Spielerkarte
3. Im Popup auf "Statistiken" klicken

Enthaltene Informationen

Win% auf Spielerkarten

Die Siegquote wird direkt auf jeder Spielerkarte angezeigt (bei mindestens 1 Spiel). Spieler mit 3+ Siegen in Folge erhalten ein grünes Streak-Badge (z.B. "5W").

Win% Champion

Im Champions-Bereich wird der Spieler mit der besten Siegquote angezeigt (mindestens 5 Spiele erforderlich).

26 Spieler-Vergleich NEU v4.3

Zwei Spieler können direkt miteinander verglichen werden.

So öffnest du den Vergleich

1. Navigiere zur Spieler-Datenbank
2. Klicke auf "Vergleich" (Waage-Icon)
3. Wähle zwei Spieler aus den Dropdowns

Verglichene Werte

27 History-Verbesserungen NEU v4.3

Filter

Einträge können gefiltert werden:

• Spieler-Suche - Freitextsuche nach Spielernamen
• Disziplin - Dropdown mit allen gespielten Disziplinen

CSV Export

Die Spielhistorie kann als CSV-Datei exportiert werden (Semikolon-getrennt, UTF-8 mit BOM für Excel).

Enthaltene Spalten: Datum, Disziplin, Race, Spieler 1, Spieler 2, Ergebnis 1, Ergebnis 2, Gewinner

28 Trainings-Fortschrittsdiagramm NEU v4.3

Zeigt die Entwicklung der Trainingsergebnisse als Liniendiagramm.

So öffnest du das Diagramm

1. Klicke auf eine Spielerkarte
2. Im Popup auf "Trainingsverlauf" klicken
3. Wähle eine Übung aus dem Dropdown

Diagramm-Elemente

• Grüne Linie - Score-Verlauf (letzte 20 Ergebnisse)
• Rote gestrichelte Linie - Zielwert der Übung
• Statistik-Box - Durchschnitt (Ø) und Maximum

29 Spiel abbrechen NEU v4.4

Im Popup-Menü (Werkzeug-Icons) steht ein neuer Button zum Abbrechen des laufenden Spiels zur Verfügung.

Funktionsweise

1. Während eines Spiels auf den Werkzeug-Button (Schraubenschlüssel) klicken
2. Im Popup erscheint neben Restart, Undo und Hilfe ein neues Abbrechen-Icon (Kreuz)
3. Nach Klick wird ein Bestätigungs-Popup angezeigt
4. Bei Bestätigung wird das Spiel beendet - ohne dass Werte in die Statistik/Bilanz übernommen werden

30 Icon-Konfiguration NEU v4.4

In der config.php kann das Aussehen der Buttons konfiguriert werden.

Einstellungen

Beispiel config.php

define('ICON_STYLE', 'square');   // 'round' oder 'square'
define('ICON_3D', true);          // true = 3D-Schatten, false = flach

31 Impressum & Datenschutz NEU v4.4

Über das Seitenmenü können Impressum und Datenschutzerklärung aufgerufen werden. Die Seiten enthalten Mustertexte, die angepasst werden sollten.

Aktivierung

In der config.php:

define('SHOW_LEGAL', true);   // true = sichtbar, false = ausgeblendet

Zugang

1. Sidebar öffnen (Burger-Menü)
2. Unterhalb von "Vollbild" erscheinen die Links Impressum und Datenschutz
3. Auf den jeweiligen Link klicken

32 Login-System NEU v4.5

Die Startseite (index.php) kann optional mit einem Login geschützt werden. Es gibt zwei Login-Methoden: Admin-Login und Spieler-Login.

Aktivierung

In der config.php:

define('REQUIRE_LOGIN', true);    // true = Login erforderlich, false = kein Login
define('LOGIN_USER', 'admin');    // Admin-Benutzername
define('LOGIN_PASS', 'billard'); // Admin-Passwort

Admin-Login

Mit den in config.php definierten Zugangsdaten (LOGIN_USER / LOGIN_PASS) kann sich der Administrator anmelden.

Spieler-Login

Spieler können sich mit ihrem Namen und ihrer PIN anmelden, sofern die Checkbox "Login Startpage" im Spieler-Editor aktiviert ist.

1. Navigiere zur Spieler-Datenbank
2. Spieler bearbeiten (Stift-Icon)
3. Checkbox "Login Startpage" aktivieren
4. Speichern

Login-Formular

• Feld Name - Admin-Benutzername oder Spielername
• Feld Passwort / PIN - Admin-Passwort oder Spieler-PIN
• Die Namenseingabe ist nicht Groß-/Kleinschreibung-sensitiv

Logout

In der Sidebar erscheint ein Logout-Button (nur sichtbar wenn Login aktiv ist). Klick darauf beendet die Session.

Version History

• v4.5 (Februar 2026) - Login-System (Admin + Spieler-Login mit Name/PIN, konfigurierbar in config.php, Logout-Button in Sidebar)
• v4.4 (Februar 2026) - Spiel abbrechen (ohne Statistik), Icon-Konfiguration (rund/eckig, 3D-Schatten), Impressum & Datenschutz (Mustertexte, config.php)
• v4.3 (Februar 2026) - Rangliste, Spieler-Statistiken (pro Disziplin, H2H, Win%, Streaks), Spieler-Vergleich, History-Filter, CSV Export, Trainings-Fortschrittsdiagramm, In-App Backup/Restore
• 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.5 | Entwickelt für Billard-Spieler