Skip to content

Ein Charaktergenerator für das DSA-Hausregelsystem Drachentöter. Starte einfach die Sephrasto.py und leg los!

License

Notifications You must be signed in to change notification settings

brzGatsu/Taverne

 
 

Repository files navigation

Taverne zum Drachentöter

Der Charaktergenerator für Drachentöter, einem alternativen Regelwerk für Aventurien. So vollständig wie möglich. Eine Gebrauchsanweisung findest du, wenn du im Hauptfenster auf den Hilfe-Button klickst.

Taverne ist ein Fork des Ilaris-Charaktergenerators Sephrasto, der von Aeolitus und Gatsu entwickelt wurde.

Screenshot

Features

  • ⚡ Blitzschnelle Charaktererstellung dank Archetypen
  • 📜 Relevante Regeln direkt im Editor und Charakteranhang
  • ⚖️ Hausregeln könne nahtlos eingefügt werden
  • 🧩 Tierbegleiter, VTT-Exports, Manöverkarten und vieles mehr steht durch Plugins bereit
  • ♻️ Steigerungen können rückgängig gemacht werden
  • 🤝 Von und für die Drachentöter-Community entwickelt. Fragen und Vorschläge sind immer wilkommen: Discord

Installation

Windows

Für Windows stellen wir unter https://github.com/brzGatsu/Taverne/releases Builds zur Verfügung.

Bitte installiere außerdem PDTtk Server. Taverne benötigt das Programm für den PDF Export: https://www.pdflabs.com/tools/pdftk-the-pdf-toolkit/pdftk_server-2.02-win-setup.exe

Linux

Für Ubuntu und ähnliche Distributionen kannst du den automatischen Installer benutzen, indem du diesen Befehl in deinem Terminal ausführst:

wget -qO https://raw.githubusercontent.com/brzGatsu/Taverne/master/tools/install_linux.sh | bash -i

Der Installer erstellt einen Taverne Ordner dort, wo er ausgeführt wird, lädt alle Dateien und Pakete die benötigt werden automatisch herunter und erstellt einen Eintrag in deinem Startmenü. Zum späteren Updaten kannst du den Ordner löschen und den Befehl erneut ausführen. Helden, Regeln und Plugins werden standardmäßig in einem anderen Ordner abgelegt.

Manuelle Installation

Du kannst die aktuellste Entwicklerversion von Taverne auch in wenigen Schritten manuell herunterladen und starten. Die folgenden Befehle installieren Python, PDFtk für den Charakterbogen-Export (inklusive das dafür benötigte OpenJDK) und die für Qt benötigte Cursor Lib. Danach wird das Taverne Repository mit git heruntergeladen - alternativ kannst du es natürlich auch manuell herunterladen und entpacken (unter "Code" den Punkt "Download zip" auswählen). Als nächstes wird in Python ein Virtual Environment für Taverne erstellt. Der letzte Befehl installiert alle benötigten Python-Pakete.

cd ziel/pfad/für/Taverne
sudo apt install python3-pip openjdk-11-jdk pdftk libxcb-cursor0
git clone https://github.com/brzGatsu/Taverne.git
mkdir -p ~/.venvs
python3 -m venv ~/.venvs/Taverne
source ~/.venvs/Taverne/bin/activate
pip install -r Taverne/requirements.txt

Gestartet wird Taverne dann folgendermaßen:

source ~/.venvs/Taverne/bin/activate
python3 Taverne/src/Taverne/Taverne.py

Taverne Userordner

Wenn dich der automatisch generierte Taverne-Ordner im Userverzeichnis stört, kannst du ihn von "taverne" in ".taverne" umbenennen, um ihn zu verstecken. Taverne wird dann den "Taverne" Ordner nicht neu erstellen.

MacOS

Gestartet wird Taverne dann folgendermaßen:

  • Navigiere zu Taverne/tools/macOS und doppelclicke auf Taverne
  • Beim ersten PDF-Export musst du wieder über "System Preferences -> Security & Privacy" die Ausführung von PDFtk erlauben, das gleiche für cpdf.
  • Optional kannst du einen Alias für die obige Taverne-Datei erstellen. Dabei geht eventuell das Icon verloren - über Get Info kannst du das Icon kopieren und beim Alias einfügen.

Kommandozeilenargumente

Argument Parameter Beschreibung
--settingsfile "pfad/zu/Taverne.ini" Überschreibt den Pfad der Taverne.ini welche die Einstellungen enthält.
--noplugins kein Parameter Weist Taverne an, keine Plugins zu laden - unabhängig von den Einstellungen.
--debug kein Parameter Lognachrichten werden auch in der Konsole ausgegeben und weitere Debugfeatures werden aktiviert.
--loglevel 0, 1 oder 2 Setzt das Loglevel (0 = error, 1 = warning, 2 = debug). Dies überschreibt das in den Einstellungen konfigurierte Loglevel.
--migrate "pfad/zu/charakter.xml" Lädt und speichert den angegeben Charakter. Dies kann genutzt werden, um ohne UI-Interaktion Migrationen zu applizieren, z. B. für Charakterassistent-Dateien.
--prerelease-plugins kein Parameter Weist den Pluginmanager an, die neuesten Prerelease-Plugins herunterzuladen, falls verfügbar.

Verwendete Pakete und Programme

  • Um Taverne mit Python zu verwenden, wird Version 3.11 empfohlen. Höhere Versionen sollten auch gehen, die Mindestversion ist 3.9.
  • PySide6 für die Grafische Oberfläche
  • lxml als xml-parser
  • PyYAML als yaml-parser
  • RestrictedPython zum Absichern der durch Benutzer erstellbaren Python Scripts
  • cx_freeze (optional) um Taverne-Builds zu erstellen
  • mkdocs und mkdocs-material (optional). Zum Konvertieren der Markdown-Dokumentation in HTML.

Mitgeliefert werden außerdem:

  • fdfgen zum Editieren des Charakterbogens
  • cpdf zur Reduzierung der Dateigröße des Charakterbogens
  • hyphen für das korrekte Umbrechen von Textzeilen im Regelanhang

Die zugehörigen Lizenzen können hier gefunden werden: Acknowledgements

Mitmachen

Falls du Fragen oder Anregungen hast, schreib uns gerne:

Discord | GitHub Issue

Wenn du für dich oder für die Allgemeinheit an Taverne mitarbeiten willst oder ein eigenes Plugin schreiben möchtest lohnt sich ein Blick in die CONTRIBUTING.md.

About

Ein Charaktergenerator für das DSA-Hausregelsystem Drachentöter. Starte einfach die Sephrasto.py und leg los!

Resources

License

Stars

Watchers

Forks

Languages

  • Python 61.5%
  • HTML 23.8%
  • JavaScript 14.6%
  • Shell 0.1%
  • Batchfile 0.0%
  • CSS 0.0%