Pétanque Turnier-Manager

Turnierleitungssoftware für LibreOffice Calc

View project on GitHub

Logo

Pétanque-Turnier-Manager

License: EUPL v1.2 Wiki

🎯 Einleitung

Der Pétanque-Turnier-Manager ist eine leistungsstarke, Open-Source-Turnierleitungssoftware, die nahtlos als Erweiterung (Extension) in LibreOffice Calc integriert wird.

Die Software wurde speziell dafür entwickelt, die Organisation und Durchführung von Pétanque- und Boule-Turnieren so einfach und effizient wie möglich zu gestalten. Da sie komplett offline und direkt in der Tabellenkalkulation läuft, ist sie extrem ressourcenschonend. Das macht sie zur idealen Lösung für den Einsatz auf dem Bouleplatz – selbst auf älteren Laptops, die beispielsweise mit einem schlanken Linux-System betrieben werden.

Vorteile auf einen Blick:

  • Betriebssystemunabhängig: Läuft zuverlässig unter Linux, macOS und Windows.
  • Kostenlos & Open Source: Keine Lizenzgebühren, keine Werbung.
  • Ressourcenschonend: Perfekt für ältere Hardware geeignet.
  • Alles an einem Ort: Keine externe Datenbank nötig; alles wird direkt in LibreOffice Calc berechnet und gespeichert.

🛠️ Grenzenlose Anpassbarkeit: Mach es zu deinem Turnier!

Das wohl größte Alleinstellungsmerkmal dieses Turnier-Managers ist seine Basis: LibreOffice Calc. Da alle Daten, Tabellen und Ranglisten direkt in reguläre Calc-Tabellenblätter geschrieben werden, bist du nicht in einem starren Programmgerüst gefangen.

💡 Volle Kontrolle mit Calc-Bordmitteln: Du kannst jedes generierte Turniersystem völlig frei und nach deinen eigenen Wünschen erweitern!

  • Eigene Auswertungen: Nutze SVERWEIS, Pivot-Tabellen oder eigene Formeln, um teaminterne Statistiken, Punkteschnitte oder individuelle Sonderwertungen aus den Turnierdaten zu ziehen.
  • Optische Anpassung: Baue dir eigene Dashboards, füge Vereinslogos ein, ändere das Layout für den Ausdruck oder gestalte Präsentations-Ansichten für einen Beamer (z. B. für die Live-Anzeige der aktuellen Rangliste).
  • Eigene Makros & öffentliche API: Wenn du fortgeschrittene Funktionen brauchst, kannst du jederzeit eigene LibreOffice-Makros (Basic, Python etc.) schreiben, die mit den generierten Tabellen interagieren. Das Plugin stellt dafür eine öffentliche API bereit: Alle Menüaktionen sind per ptm:-Protokoll aus Makros aufrufbar, und der PtmPublicService liefert Turnierdaten (System, aktuelle Runde, Spieltag, Betriebszustand) direkt als Rückgabewert. Eigene Calc-Formeln (PTM.ALG.*) ermöglichen zusätzlich den Datenzugriff direkt in Zellen. → Makros & Formeln – vollständige API-Dokumentation

Die Erweiterung erledigt die komplexe Logik (Auslosung, Ranglistenberechnung nach Buchholz etc.) – was du am Ende aus den Daten machst, bleibt komplett dir überlassen!

🏆 Unterstützte Turniersysteme

Die Erweiterung bietet bereits eine breite Auswahl an bewährten Turniermodi, die für kleine Vereinsmeisterschaften bis hin zu großen Turnieren geeignet sind. Die Liste wird kontinuierlich erweitert:

  • Supermêlée / Mêlée: Ideal für lockere Turniere. Spieler werden in jeder Runde (oder für das gesamte Turnier) neuen Teams und Gegnern zugelost.
  • Liga: Für die Organisation einer Vereins- oder Regionalliga mit festen Teams. Der Spielplan wird vorab generiert und legt fest, wer wann gegeneinander spielt. Die Rangliste wird nach Siegen, Kugeldifferenz und direktem Vergleich berechnet. Unterstützt HTML-Export der Ergebnisse und des Spielplans.
  • Schweizer System (Formule Suisse): Das fairste System für Turniere mit vielen Teilnehmern und begrenzter Zeit. Inklusive automatischer Berechnung von Siegen, Kugeldifferenz und (Fein-)Buchholz-Punkten zur exakten Ranglistenermittlung.
  • Jeder gegen Jeden (Round Robin): Das klassische Ligasystem, bei dem jedes Team im Laufe des Turniers gegen jedes andere Team antritt.

(in Arbeit)

  • Poule-System: Klassischer Modus mit Gruppenphase (Poules) und anschließender Aufteilung in K.-o.-Bäume (A-, B-, C-, D-Turnier).
  • Direktausscheidung (K.-o.-System): Für klassische Finalrunden oder reine K.-o.-Turniere, bei denen der Verlierer ausscheidet.

💻 Systemvoraussetzungen

Um den Turnier-Manager reibungslos nutzen zu können, müssen folgende Voraussetzungen erfüllt sein:

  • LibreOffice: ab Version 25.x (oder neuer)
  • Java (JRE/JDK): ab Version 25
  • Betriebssystem: Linux, macOS oder Windows

⚙️ Installation & Einrichtung

Die Einrichtung erfolgt in drei einfachen Schritten. Bitte achte darauf, dass die Architektur deiner Java-Version (32-Bit oder 64-Bit) zwingend mit deiner LibreOffice-Installation übereinstimmen muss.

Schritt 1: Java installieren

Falls noch kein Java installiert ist, lade eine aktuelle Version herunter und installiere sie. Wir empfehlen:

Schritt 2: Java in LibreOffice aktivieren

Damit LibreOffice die Erweiterung ausführen kann, muss die Java-Laufzeitumgebung verknüpft werden:

  1. Öffne LibreOffice.
  2. Navigiere in der Menüleiste zu: Extras ▸ Optionen ▸ LibreOffice ▸ Erweitert. (Unter macOS: LibreOffice ▸ Einstellungen...)
  3. Setze unter der Überschrift „Java-Optionen“ ein Häkchen bei „Eine Java-Laufzeitumgebung verwenden“.
  4. Wähle die installierte JRE aus der erscheinenden Liste aus. (Sollte die Liste leer sein, klicke auf „Hinzufügen“ und wähle den Ordner deiner Java-Installation manuell aus.)
  5. Bestätige die Einstellungen mit OK und starte LibreOffice zur Sicherheit einmal neu.

Schritt 3: Die Erweiterung installieren

  1. Lade die aktuellste Version der Erweiterung (Dateiname: PetanqueTurnierManager-vx.xx.oxt) aus dem Bereich Releases herunter.
  2. Doppelklicke auf die .oxt-Datei. LibreOffice öffnet automatisch den Extension Manager und fragt nach der Installation.
  3. Bestätige die Installation und akzeptiere (falls nötig) die Lizenzbedingungen.
  4. Schließe den Extension Manager. Die Installation ist nun abgeschlossen!

🚀 Erste Schritte & Verwendung

  1. Starte LibreOffice Calc und öffne ein komplett leeres, neues Tabellenblatt.
  2. Blicke in die obere Menüleiste von Calc. Dort findest du nun einen neuen Menüpunkt namens „PétTurnMngr“.
  3. Klicke auf diesen Reiter. Es öffnet sich das Kontrollzentrum der Erweiterung, über das du Spieler anlegen, den Turniermodus auswählen und die Runden generieren kannst.
  4. Das Programm führt dich ab hier menügesteuert durch das Turnier. Gib einfach die Ergebnisse der gespielten Partien in die generierten Felder ein, die Tabellen und nächsten Runden berechnen sich auf Knopfdruck von selbst.

📖 Dokumentation & Hilfe

Die vollständige Dokumentation, ausführliche Erklärungen zu den einzelnen Menüpunkten sowie Tipps zur Fehlerbehebung findest du in unserem offiziellen Wiki: 👉 Hier geht es zum Projekt-Wiki

🤝 Mitwirken (Contributing)

Da dies ein Open-Source-Projekt ist, sind Beiträge aus der Community jederzeit willkommen! Egal ob es sich um das Melden von Fehlern (Issues), das Einreichen von Code-Verbesserungen (Pull Requests) oder das Erweitern der Dokumentation handelt – wir freuen uns über jede Unterstützung.

Lizenz: Dieses Projekt steht unter der EUPL-1.2 Lizenz.