abenteuer-schmiede/README.md
Kenearos dc7932af42 refactor: Partymodus von Spieltest zu Autorenrunde, Standalone entfernt
- Partymodus ist jetzt Team-Diskussion der Schreib-Agenten statt
  interaktiver Spieltest (Spieltest geht zum PnP-Simulator)
- Spielercharakter-Vorlagen und Szenen-Zustand entfernt
- Standalone-Claim aus README entfernt, klar als BMAD-Modul positioniert
- CSV-Pfade und Beschreibungen korrigiert
- Workflow-Schritte zwischen CLAUDE.md und README.md angeglichen

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-12 18:37:29 +02:00

131 lines
5.7 KiB
Markdown

# Abenteuer-Schmiede
**BMAD-Modul für KI-gestützte Pen-&-Paper-Abenteuer im DSA-Stil**
Schreibe DSA-Abenteuer mit einem Team spezialisierter KI-Agenten — vom Hook bis zum fertigen Abenteuerband. Mit **Autorenrunde** für Team-Reviews!
## Was ist das?
Abenteuer-Schmiede ist ein [BMAD](https://github.com/bmadcode/BMAD-METHOD)-Modul, das den Prozess der Abenteuer-Erstellung in spezialisierte Rollen aufteilt. Statt alles alleine zu machen, arbeiten 6 Agenten zusammen:
| Agent | Rolle | Was er tut |
|-------|-------|-----------|
| **Spielleiter** (Meister Kronos) | Abenteuer-Architekt | Akte, Szenen, Spannungsbögen, Hooks |
| **Weltenbauer** (Cartograph) | Geographin | Schauplätze, Regionen, Atmosphäre |
| **NSC-Schmied** (Persona) | Menschenkennerin | NSCs mit Werten, Motivation, Stimme |
| **Begegnungsdesigner** (Strategos) | Taktiker | Kampf, Sozial, Erkundung — balanciert |
| **Regelwächter** (Codex) | DSA5-Experte | Werte, Proben, Regelkonsistenz |
| **Handout-Künstler** (Illumina) | Kalligraphin | Briefe, Rätsel, In-World-Texte |
Im **Partymodus** kommen alle Agenten als Autorenrunde zusammen und besprechen das Abenteuer gemeinsam.
## Features
- **Kompendium-System**: Single Source of Truth für NSCs, Orte, Szenen, Begegnungen
- **DSA5-Native**: Proben, Qualitätsstufen, Kampfwerte, Zauber, Liturgien
- **Drei-Akt-Struktur** mit flexiblen Fixpunkten und Freiheitsräumen
- **Partymodus**: Autorenrunde — alle Agenten reviewen und diskutieren dein Abenteuer
- **Balance-Analyse**: Automatische Prüfung von Pacing, Spielertypen-Abdeckung
- **Regelcheck**: Validierung aller Werte und Probenschwierigkeiten
- **Handout-Werkstatt**: Atmosphärische Briefe, Rätsel und Dokumente
- **Export**: Markdown, Druckformat, VTT-kompatibel
- **Wiederverwendbar**: Nutze die Schmiede für jedes neue Abenteuer
> **Spieltest gesucht?** Der [PnP-Simulator](https://github.com/Kenearos/pnp-simulator) simuliert dein Abenteuer mit KI-Spielern — exportiere aus der Schmiede, importiere in den Simulator.
## Installation
Voraussetzung: Ein Projekt mit [BMAD-METHOD](https://github.com/bmadcode/BMAD-METHOD) Setup.
```bash
# In einem bestehenden BMAD-Projekt:
npx bmad-method install
# → Wähle "Abenteuer-Schmiede" aus der Modulliste
```
Nach der Installation stehen alle Agenten und Workflows über die BMAD-Kommandos zur Verfügung.
## Modulstruktur
```
abenteuer-schmiede/
├── module.yaml # BMAD-Modul-Definition
├── agents/ # Agent-Personas (YAML)
│ ├── spielleiter.agent.yaml
│ ├── weltenbauer.agent.yaml
│ ├── nsc-schmied.agent.yaml
│ ├── begegnungsdesigner.agent.yaml
│ ├── regelwaechter.agent.yaml
│ └── handout-kuenstler.agent.yaml
├── skills/ # BMAD-Skills
│ ├── as-setup/ # Projekt-Setup
│ ├── spielleiter/ # Abenteuerstruktur
│ ├── weltenbauer/ # Schauplätze
│ ├── nsc-schmied/ # NSC-Erstellung
│ ├── begegnungsdesigner/ # Begegnungen
│ ├── regelwaechter/ # Regelcheck
│ ├── handout-kuenstler/ # Handouts
│ ├── partymodus/ # Autorenrunde (Team-Diskussion)
│ ├── szenen-balancer/ # Balance-Analyse
│ └── abenteuer-export/ # Export
├── rahmen/ # Abenteuer-Rahmen (pro Projekt befüllt)
│ ├── setting.md # Region, Epoche, Kultur
│ ├── stil.md # Erzählstil, Atmosphäre
│ └── regeln.md # DSA5-Basis + Hausregeln
├── kompendium/ # Single Source of Truth (pro Projekt befüllt)
│ ├── nsc/ # Alle NSCs mit Werten
│ ├── orte/ # Alle Schauplätze
│ ├── szenen/ # Alle Szenen
│ ├── begegnungen/ # Alle Begegnungen
│ └── handouts/ # Spieler-Handouts
├── zustand/ # State-Management
│ └── aktuell.md # Globaler Fortschritt
└── _bmad-output/ # Generierte Dateien
```
## Workflow
```
1. Setup → Rahmen definieren (Region, Ton, Regeln)
2. Konzept → Hook, Prämisse, Akt-Struktur
3. Welt → Schauplätze ausarbeiten
4. NSCs → Alle wichtigen NSCs mit Werten erstellen
5. Szenen → Szene für Szene ausarbeiten (inkl. Begegnungen)
6. Handouts → Briefe, Rätsel, Dokumente erstellen
7. Regelcheck → Alle Werte, Proben, Schwierigkeiten prüfen
8. Balancing → Pacing und Balance analysieren
9. Team-Review → Autorenrunde — alle Agenten reviewen gemeinsam
10. Export → Fertiges Abenteuer exportieren
```
Jeder Schritt ist ein **Gate** — du entscheidest ob es weitergeht.
## Partymodus (Autorenrunde)
Alle Agenten kommen als Team zusammen und besprechen dein Abenteuer:
- **Brainstorming** — Ideen gemeinsam spinnen
- **Review** — Jeder Agent prüft aus seiner Perspektive
- **Szenen-Workshop** — Eine Szene von allen Seiten durchdenken
- **Konflikte lösen** — Wenn Atmosphäre und Regelbalance kollidieren
## DSA-Hinweis
Dieses Modul nutzt die Regeln von **Das Schwarze Auge 5. Edition** als Basis. DSA und Das Schwarze Auge sind eingetragene Marken von Ulisses Spiele. Dieses Projekt ist ein inoffizielles Fan-Werkzeug und steht in keiner Verbindung zu Ulisses Spiele.
## Contributing
Pull Requests willkommen! Besonders gesucht:
- Regionale Setting-Pakete (Mittelreich, Thorwal, etc.)
- Zufallstabellen (NSCs, Begegnungen, Schätze)
- Verbesserungen am Regelwächter
- VTT-Integration (Foundry, Roll20)
## Lizenz
MIT — Mach damit was du willst.
---
Gebaut mit Würfeln und KI von [Kenearos](https://github.com/Kenearos)