Myth & Mimics
KI-gesteuertes Tabletop-RPG mit Powered by the Apocalypse-Regelwerk
Eine Full-Stack-Webanwendung, die klassisches Tabletop-Rollenspiel mit moderner KI verbindet. Ein KI-Spielleiter, angetrieben von Google Gemini, erzählt die Geschichte, würfelt nach PbtA-Regeln, generiert Charakterporträts und liefert Spracherzählung via ElevenLabs TTS.
- —Multi-Agenten-KI-Pipeline: Erzählung, Bildgenerierung und TTS über ein anbieterunabhängiges Laravel AI SDK
- —Optionaler KI-Zweitspieler – ein zweiter Agent spielt seinen eigenen Charakter mit eigener Persönlichkeit
- —Gesprächsgedächtnis mit automatischer Zusammenfassung bei ~8.000 Tokens
- —Interaktive KI-Charaktererstellung als mehrstufiger Dialog statt klassisches Formular
- —Zwei Settings: Dungeon World (Schwert & Zauberei) und Mythos World (Lovecraftianischer Horror)
- —Filament v3 Admin-Panel: Geschichtenersteller, Token-Tracking, API-Schlüsselverwaltung mit Live-Test
- —Spracheingabe via Browser Speech Recognition API und TTS-Autoplay nach jeder Spielleiter-Antwort
Myth & Mimics ist eine Full-Stack-Webanwendung, die klassisches Tabletop-Rollenspiel mit moderner KI-Technologie verbindet. Die Plattform implementiert das Powered by the Apocalypse (PbtA)-Regelwerk in zwei Settings: Dungeon World für klassische Schwert-und-Zauberei-Abenteuer und Mythos World für Lovecraftianische Horrorgeschichten. Ein KI-gesteuerter Spielleiter – angetrieben von Google Gemini – erzählt die Geschichte, reagiert dynamisch auf Spieleraktionen, würfelt nach PbtA-Mechaniken, generiert Charakterporträts und liefert vollständige Spracherzählung via ElevenLabs TTS.
Das Projekt ist die zweite Stufe von Dungeon Duo – das Kernkonzept eines KI-gesteuerten Spielleiters wird von einem React-only-Prototypen zu einer produktionsfertigen Full-Stack-Architektur mit persistentem Zustand, einem echten Backend und einer regelgesteuerten Spiel-Engine ausgebaut.
Technischer Stack
Das Backend basiert auf Laravel 12 mit PHP 8.4, läuft in einer Docker-Umgebung via Laravel Sail. Die KI-Integration nutzt das Laravel AI SDK – eine anbieterunabhängige Abstraktionsschicht, die Gemini (Erzählung, Bildgenerierung) und ElevenLabs (TTS) über eine einheitliche Schnittstelle anspricht und auf andere Anbieter wie Anthropic umgestellt werden kann, ohne den Core zu ändern. Das Admin-Panel ist vollständig mit Filament v3 gebaut. Die Echtzeit-Kommunikation zwischen Server und Frontend läuft über Laravel Reverb (WebSocket). Das Frontend ist ein React 19 + TypeScript SPA mit Tailwind CSS 4 und einem benutzerdefinierten fantasy-*-Farbschema, gebaut mit Vite und navigiert via React Router DOM.
Architektur-Highlights
Multi-Agenten-KI-Pipeline: Jede Spieleraktion durchläuft eine strukturierte Pipeline. Der DungeonMaster-Agent erhält einen dynamisch zusammengesetzten Systemprompt aus Regelwerk, Story-Kontext, NPC-Liste, Bedrohungen, Orten und vollständigem Charakterstatus. Die KI-Antwort enthält narrativen Prosatext sowie einen maschinenlesbaren ||DATA|{...}||-Block mit Spielzustandsänderungen (HP, Inventar, Zaubersprüche). Laravel parst diesen Block serverseitig, aktualisiert die Datenbank und sendet nur sauberes JSON ans Frontend – ein Ansatz, der Prompt-Injection verhindert und Datenintegrität garantiert.
KI-gesteuerter Zweitspieler: Optional übernimmt ein zweiter KI-Agent die Rolle eines Mitspielers mit eigenem Charakter und eigener Persönlichkeit. Der AiPlayer-Agent reagiert auf jede Spielleiter-Erzählung, und der Spielleiter beschreibt seinerseits die Aktion dieses Charakters – ein vollautomatischer Erzählkreislauf, der Soloспielern ein kooperatives Gefühl gibt.
Gesprächsgedächtnis mit Zusammenfassung: Alle Spielnachrichten werden in der Datenbank gespeichert. Wenn die Kontext-Token-Anzahl einen Schwellenwert (~8.000 geschätzte Tokens) erreicht, fasst ein separater Summarizer-Agent ältere Nachrichten kumulativ zusammen. Die letzten 10 Nachrichten werden immer vollständig behalten, sodass der Spielleiter stets mit Kontext antwortet.
Interaktive KI-Charaktererstellung: Statt eines klassischen Formulars führt ein KI-Agent den Spieler durch die Charaktererstellung in einem mehrstufigen Dialog – Name, Geschlecht, Playbook, Attribute, Hintergrundgeschichte. Am Ende wird ein ||DATA|{...}||-Block geparst und der Charakter direkt in der Datenbank erstellt.
Dynamisches Regelwerk: World-Settings definieren eigene Attributnamen, Wertebereiche und Porträtstil-Prompts. Playbooks (Klassen) sind über eine Many-to-Many-Beziehung mit setting-spezifischen Attributen verknüpft, was das System auf weitere PbtA-Varianten erweiterbar macht, ohne den Core-Code zu berühren.
Funktionsübersicht
- Vollständiges Charakter-CRUD mit KI-generiertem Porträt (Gemini Imagen) und Hintergrundgeschichte
- Echtzeit-Spieloberfläche: Chat-Protokoll, Würfeln (serverseitig 2d6), Seitenleiste mit Abenteuerprotokoll, Inventar und Zauberliste
- TTS-Autoplay nach jeder Spielleiter-Antwort mit unterbrechbarer Wiedergabe; Spracheingabe via Browser Speech Recognition API
- Filament Admin: Geschichtenersteller (NPCs, Bedrohungen, Orte), Playbook-Editor, Token-Verbrauchstracking, API-Schlüsselverwaltung mit Live-Test
- GitLab CI/CD-Pipeline: PHPUnit + Vitest, Frontend-Build, rsync-Deployment auf Ubuntu-Server
Status
Sechs von acht geplanten Entwicklungsphasen sind abgeschlossen. Aktuell in Arbeit: Rate-Limiting, erweitertes Fehlerhandling und eine REST-API-Erweiterung als Grundlage für zukünftige iOS/Android-Apps.