TTRPG — Dungeon Master System

Narratives Rollenspiel mit Claude als Dungeon Master. Ein D20 für alles, keine Würfelmechanik-Bürokratie, dafür gute Geschichten.

Signal-Bot: Dieses Repo enthält die Spielwelt-Daten (Engine, Templates, Abenteuer). Der dazugehörige Signal-Bot (Routing, Claude API, Avatar-Generierung) liegt in phieb/ttrpg-signal.

Zwei Spielmodi

Direkt mit Claude Code — kein Bot, kein Server, kein Setup: Einfach dieses Repo in Claude Code öffnen. Claude liest CLAUDE.md und zeigt sofort ein Menü — laufende Abenteuer, neues Abenteuer starten, Spieler registrieren. Alles läuft in der Konversation.

Mit dem Signal-Bot — asynchron über Signal auf dem Smartphone: phieb/ttrpg-signal läuft als Docker-Dienst, bindet dieses Repo ein und routet Signal-Nachrichten an die DM-Engine. Spieler schreiben in eine Signal-Gruppe, der Bot antwortet als DM.

Beide Modi nutzen dieselben Engine-Dateien, dieselben Abenteuer-Ordner und dieselben Charakterblätter. Der einzige Unterschied: players/[name].yaml braucht nur ein Telefonfeld, wenn der Bot genutzt wird.

---

Struktur

ttrpg/
├── _engine/
│   ├── DUNGEON_MASTER.md        ← DM-Logik (reguläres Spiel + Session 0)
│   ├── CHARACTER_SETUP.md       ← privater 1:1 Charakter-Setup Kanal
│   ├── TOP_DM_REGELN.md         ← Kernregeln (immer geladen)
│   ├── templates/               ← Vorlagen für neue Abenteuer
│   │   ├── character.yaml
│   │   ├── setting.yaml
│   │   ├── npcs.yaml
│   │   └── session.yaml
│   ├── flavours/                ← ein Unterordner pro Flavour (built-in)
│   │   ├── fantasy/
│   │   ├── mythical/
│   │   └── historical/
│   │   # Addons werden via Docker-Volume hier eingehängt
│   └── tools/
│       └── generate_character_pdf.py
├── players/                     ← ein YAML pro registriertem Spieler
├── status.yaml                  ← Abenteuer-Übersicht + Signal-Gruppen
├── status.example.yaml
└── adventures/
    └── [abenteuer-name]/
        ├── setting.yaml         ← Welt, Flavours, verfuegbare_spezies
        ├── npcs.yaml
        ├── session.yaml
        ├── spielprotokoll.jsonl
        └── characters/
            ├── [name].yaml
            └── [name]_avatar.png

Flavour Addons

Addon	Inhalt
ttrpg-flavour-horror	Kosmisches Grauen, Verstand-Mechanik, Safety Tools

Wie du ein eigenes Addon baust: siehe _engine/ARCHITECTURE.md.

Spielen

Claude Code im Root-Ordner (ttrpg/) öffnen — Claude zeigt automatisch ein Menü:

• Laufende Abenteuer mit Status und letzter Szene
• Option: Neues Abenteuer starten

Von dort alles auswählen — kein manuelles Kopieren von Ordnern, kein cd nötig.

Während dem Spiel

Kommando	Was passiert
pause	Spielstand speichern
session 0 abschließen	Weltenbau beenden, PDFs generieren
D20 würfeln und Zahl eintippen	Würfelergebnis

PDFs neu generieren

cd adventures/[abenteuer-name]
pip install reportlab pyyaml
python3 ../../_engine/tools/generate_character_pdf.py

Würfelsystem

Ein D20 für alles. Physisch würfeln, Ergebnis eintippen.

Ergebnis	Bedeutung
1	Kritisches Versagen
2-5	Versagen
6-10	Teilerfolg mit Haken
11-15	Erfolg
16-19	Voller Erfolg
20	Kritischer Erfolg

Relevanter Skill = eine Stufe besser. Schwäche trifft zu = eine Stufe schlechter.