Download & Installation

tafl läuft als vorkompilierte Version unter Windows und Linux; der Quellcode ist offen. Ohne Installation geht es direkt auf der Spielseite.

Zweck dieses Dokuments

Dieses Dokument hilft neuen Nutzerinnen und Nutzern, tafl zum Laufen zu bringen und die ersten Schritte zu machen.

Status: Gilt für Version 1.0.1.

Voraussetzungen

Es gibt zwei Wege, tafl zum Laufen zu bringen: eine vorkompilierte Version herunterladen (kein Rust nötig, siehe „Vorkompilierte Version verwenden" unten) oder aus dem Quellcode selbst bauen (siehe „Installation aus dem Quellcode" unten). Für den Quellcode-Weg wird benötigt:

• Eine aktuelle, stabile Rust-Toolchain (mindestens Version 1.85, da das Projekt die Rust-Edition 2024 verwendet). Installation über rustup.rs, unabhängig vom Betriebssystem.
• Ein Git-Client, um den Quellcode herunterzuladen.

Das Programm ist für Windows und Linux gebaut und getestet. Unter macOS gibt es keine vorkompilierte Version; die grafische Oberfläche verwendet zwar das plattformunabhängige Rust-Framework egui/eframe, ein macOS-Build ist aber nur über den Quellcode möglich und nicht getestet (siehe unten). Das AppImage für Linux auf ARM (aarch64) ist ungetestet.

Vorkompilierte Version verwenden (empfohlener Weg für die meisten Nutzer)

Wer keine Rust-Toolchain installieren und keinen Quellcode bauen möchte, kann eine fertige Version direkt herunterladen und starten.

Download: https://gitlab.com/tafl-world/tafl/-/releases

Eine Veröffentlichung besteht aus Archiven, die vollständig entpackt werden müssen, bevor tafl gestartet wird. Jedes Archiv enthält einen Wurzelordner (z. B. tafl-<version>-windows-x86_64/), in dem alle Dateien beieinander liegen:

• tafl-<version>-windows-x86_64.zip – für Windows (64 Bit)
• tafl-<version>-x86_64-unknown-linux-gnu.tar.gz und tafl-<version>-aarch64-unknown-linux-gnu.tar.gz – für Linux-Desktops mit grafischer Oberfläche (x86_64 bzw. ARM)
• tafl-<version>-x86_64-unknown-linux-musl.tar.gz und tafl-<version>-aarch64-unknown-linux-musl.tar.gz – statisch gelinkte Linux-Archive mit tafl_server und den Kommandozeilenwerkzeugen (siehe „Kommandozeilenwerkzeuge“ unten), aber ohne tafl_gui; für das normale Spielen am Desktop werden sie nicht benötigt
• THIRD-PARTY-LICENSES.html – Lizenzen aller verwendeten Abhängigkeiten
• SHA256SUMS – Prüfsummen aller Archive (siehe „Download prüfen" unten)

Wer unsicher ist, wählt unter Windows das .zip-Archiv und unter Linux das gnu-Archiv der eigenen Prozessorarchitektur (die Ausgabe von uname -m zeigt sie: x86_64 oder aarch64).

Was im Archiv enthalten ist

• die ausführbaren Programme: in den Windows- und gnu-Archiven tafl_gui bzw. tafl_gui.exe samt tafl_server (unter Linux zusätzlich das AppImage), in den musl-Archiven nur tafl_server; dazu in den Windows- und musl-Archiven die Kommandozeilenwerkzeuge,
• die Datei THIRD-PARTY-LICENSES.html mit den Lizenzen der verwendeten Abhängigkeiten,
• die Dokumentation: dieses Handbuch (docs/manual/) und die technische Dokumentation inklusive aller Spielanleitungen (docs/software/).

Programm und Dokumentation müssen nebeneinander liegen bleiben: Der Doku-Tab der GUI liest die Spielanleitungen aus docs/software/00_game_rules/ neben der Programmdatei, und „Lokalen Server starten?“ im Mehrspieler-Dialog benötigt tafl_server. Deshalb tafl immer aus dem entpackten Ordner starten und die Dateien nicht einzeln herauskopieren.

Windows

1. Das .zip-Archiv herunterladen und vollständig entpacken (Rechtsklick → „Alle extrahieren…“). tafl lässt sich nicht aus dem ZIP-Archiv heraus starten.
2. Im entpackten Ordner tafl_gui.exe per Doppelklick starten – keine Installation nötig.
3. Beim ersten Start zeigt Windows eventuell eine SmartScreen-Warnung (siehe nächster Abschnitt).

Hinweis zum Symbol: tafl hat ein neues Programmsymbol. Ist ein älteres tafl bereits an die Taskleiste angeheftet, zeigt Windows eventuell weiterhin das alte Symbol (Symbol-Zwischenspeicher). Abhilfe: das angeheftete Symbol einmal lösen und tafl danach neu anheften.

Warnung „Der Computer wurde durch Windows geschützt“ (SmartScreen)

Beim ersten Start von tafl_gui.exe kann Windows Defender SmartScreen eine blaue Warnung anzeigen. Ursache: Die Programmdatei ist neu und nicht digital signiert; SmartScreen kennt sie deshalb noch nicht und warnt vorsorglich vor jeder unbekannten Datei. Das ist kein Hinweis auf einen Fehler oder Schadcode in tafl.

So starten Sie das Programm trotzdem:

1. In der Warnung auf „Weitere Informationen“ klicken.
2. Danach erscheint die Schaltfläche „Trotzdem ausführen“ – darauf klicken.

Die Programmdatei ist derzeit nicht digital signiert; die Warnung erscheint deshalb. Prüfsummen (siehe nächster Abschnitt) schützen gegen Übertragungsfehler, nicht gegen gezielte Manipulation.

Download prüfen (Prüfsummen)

Zu jeder Veröffentlichung gehört die Datei SHA256SUMS mit dem SHA-256-Wert jedes Archivs. Beide Dateien (Archiv und SHA256SUMS) in denselben Ordner legen und dort prüfen:

• Windows (PowerShell): Get-FileHash .\tafl-<version>-windows-x86_64.zip -Algorithm SHA256 – der ausgegebene Wert muss mit der Zeile für dieses Archiv in SHA256SUMS übereinstimmen. Alternativ in der Eingabeaufforderung: certutil -hashfile tafl-<version>-windows-x86_64.zip SHA256.
• Linux: sha256sum -c SHA256SUMS --ignore-missing – für jedes vorhandene Archiv muss OK erscheinen.

Weicht der Wert ab, die Datei erneut herunterladen und nicht ausführen. Die Prüfsumme erkennt beschädigte Downloads; gegen gezielte Manipulation, bei der auch SHA256SUMS verändert wurde, schützt sie nicht.

Linux

1. Das passende .tar.gz-Archiv herunterladen und entpacken: tar -xzf tafl-<version>-<target>.tar.gz
2. In den entpackten Ordner wechseln und tafl starten – auf eine der beiden Arten: * AppImage (empfohlen): Die .AppImage-Datei bündelt die benötigten Laufzeitbibliotheken bereits mit, sodass in der Regel keine zusätzliche Systeminstallation nötig ist. Ausführbar machen mit chmod +x tafl-<architektur>.AppImage und starten mit ./tafl-<architektur>.AppImage. * tafl_gui: die rohe, dynamisch gelinkte Programmdatei ohne AppImage-Hülle. Sie benötigt bereits auf dem System installierte GTK3-/X11-/libxkbcommon-Laufzeitbibliotheken – für die meisten Nutzerinnen und Nutzer ist das AppImage deshalb der einfachere Weg.

Das x86_64-AppImage ist getestet; die aarch64-Variante (ARM) wird mitgebaut, ist aber ungetestet – bei Problemen bitte melden (Kontakt siehe unten).

Kommandozeilenwerkzeuge (für Fortgeschrittene)

Die Windows- und die musl-Archive enthalten neben dem eigentlichen Spiel acht Kommandozeilenprogramme, die ohne grafische Oberfläche laufen:

• benchmark_baseline – Benchmark der KI über alle Varianten,
• evaluate_position – Bewertung einer einzelnen Stellung,
• random_selfplay – Selbstspiel mit Zufallszügen,
• sprt_gate, weights_sprt_gate, nnue_sprt_gate – statistische Vergleichsläufe (SPRT) zweier KI-Einstellungen,
• spsa_tune – automatische Feinabstimmung von Bewertungsgewichten,
• export_selfplay_dataset – Export von Selbstspiel-Daten.

Sie sind interne Werkzeuge ohne Stabilitätszusage: Aufrufoptionen und Ausgabeformate können sich von Version zu Version ändern. Für das Spielen werden sie nicht benötigt. Wer sie nutzen möchte, findet Zweck und Optionen in der technischen Dokumentation im Quellcode-Repository (Bereich „Tools“ der Engine-Dokumentation).

macOS

Es gibt keine vorkompilierten macOS-Binaries. Auf macOS bleibt nur der Quellcode-Weg (siehe unten); dieser ist nicht getestet – ein Build kann gelingen, wird aber derzeit weder geprüft noch unterstützt. Fehlerberichte sind willkommen, eine Zusage zur Behebung gibt es nicht.

Lizenzhinweis

Jedem Archiv liegt eine Datei THIRD-PARTY-LICENSES.html mit den Lizenzen aller verwendeten Abhängigkeiten bei (siehe „Lizenzinformationen“ unten).

Installation aus dem Quellcode

Wer stattdessen selbst bauen möchte – etwa für eine Plattform ohne vorkompilierte Binary (siehe macOS oben, dort nur Quellcode, nicht getestet) oder um eine Entwicklungsversion zu nutzen. Eine eigenständige Programmdatei erhalten Sie mit cargo build --release; das Ergebnis liegt dann unter target/release/ (tafl_gui bzw. tafl_gui.exe).

1. Quellcode herunterladen:

text git clone https://gitlab.com/tafl-world/tafl.git cd tafl

2. Die grafische Oberfläche bauen und direkt starten:

text cargo run --release -p tafl_gui

Der erste Aufruf dauert spürbar länger (vollständiger Kompiliervorgang); danach startet das Programm zügig.

3. Alternativ nur bauen, ohne direkt zu starten:

text cargo build --release -p tafl_gui

Das fertige Programm liegt danach unter target/release/tafl_gui (unter Windows: target\release\tafl_gui.exe) und kann von dort aus erneut gestartet werden, ohne erneut zu kompilieren.

--release wird empfohlen: Ohne diese Option läuft das Programm spürbar langsamer, insbesondere die KI-Gegenseite.

Schnellstart: die erste Partie

1. Programm starten (siehe oben). Es öffnet sich standardmäßig eine Partie der Copenhagen-Variante, Mensch gegen Mensch.
2. Spielmodus wählen (Konfigurationsfußleiste unterhalb des Bretts): „Mensch vs. Mensch", „KI = Angreifer", „KI = Verteidiger" oder „KI vs. KI".
3. Ziehen: eine eigene Figur anklicken, danach das Zielfeld anklicken.
4. Andere Variante ausprobieren: über den Button „Variante wählen…" in der Kopfleiste lässt sich aus allen vorhandenen Varianten wählen, gruppiert nach Spielfamilie.
5. Unterstützung durch den Coach: im Dock-Reiter „Coach" lässt sich eine Erklärung des letzten Zugs oder ein Vorschlag für den nächsten Zug einschalten – unabhängig davon, ob eine KI mitspielt.

Unbekannte Begriffe (Thron, Eckflucht, Berserker-Kette, …) sind in glossar.md (dieser Ordner) erklärt.

Weiterführende Dokumentation

• Ausführliches Benutzerhandbuch (alle Bedienbereiche): benutzerhandbuch.md
• Begriffe und häufige Fragen: glossar.md
• Übersicht aller unterstützten Spielvarianten: variantenuebersicht.md
• Bekannte Einschränkungen: bekannte_einschraenkungen.md
• Wie der Blended-KI-Gegner funktioniert: nnue_sprt_erklaerung.md
• Vollständige, technische Beschreibung aller GUI-Bereiche (für technisch interessierte Leser): technische Dokumentation zur GUI im Quellcode-Repository
• Wie das Projekt entstanden ist und woran es aktuell arbeitet: projektgeschichte.md

Kontaktmöglichkeit für Fehlerberichte und Feedback: siehe unten.

Lizenzinformationen

Die Lizenzwahl für tafl ist eine bewusste, endgültige Entscheidung:

• Quellcode (crates/): Dual-Lizenz MIT OR Apache-2.0 – frei nutzbar, veränderbar und einbettbar, auch kommerziell und auch in geschlossenen Projekten. Volltexte: LICENSE-MIT und LICENSE-APACHE im Projekt-Root.
• Dokumentation (docs/, einschließlich dieses Handbuchs): Creative Commons Attribution 4.0 International (CC BY 4.0) – frei teil- und bearbeitbar, auch kommerziell, solange die Urheberschaft genannt wird. Volltext: LICENSE-DOCS im Projekt-Root.
• Rechteinhaber: Marcus Lipski.
• Ausgenommen: Das Verzeichnis research/ (historische Recherchenotizen, teils Übersetzungen/Auszüge urheberrechtlich geschützter Sekundärliteratur Dritter) ist bewusst nicht Teil dieser Lizenzierung und wird nicht veröffentlicht – es handelt sich um ein internes Arbeitsverzeichnis. Die daraus abgeleiteten Erkenntnisse fließen aber, soweit relevant, in die lizenzierte Dokumentation (docs/) ein.

Kontakt für Fehlerberichte und Feedback

Für Rückfragen und Feedback stehen zwei Kanäle zur Verfügung:

• Allgemeine Anfragen: kontakt@tafl.world
• Fehlerberichte und Funktionswünsche: GitLab-Issue-Tracker des tafl-Repositorys

Zusammenfassung

tafl lässt sich entweder als vorkompiliertes Archiv herunterladen (ZIP unter Windows, .tar.gz unter Linux, siehe „Vorkompilierte Version verwenden" oben; dort auch Hinweise zur Windows-SmartScreen-Warnung und zur Prüfung der Prüfsummen) oder aus dem Quellcode heraus mit cargo run --release -p tafl_gui starten. Nach dem Start lässt sich direkt eine Partie spielen, die Spielvariante und der Spielmodus (Mensch/KI) wechseln und der Coach zur Unterstützung einschalten. Lizenzinformationen sind final; für Fehlerberichte und Feedback stehen kontakt@tafl.world und der GitLab-Issue-Tracker zur Verfügung.