RealmCraft

Erzählendes Strategie-Rollenspiel mit einem Sprachmodell als Spielleiter.

Du führst ein Volk über Jahre und Kapitel. Ein Sprachmodell ist der Spielleiter („der Chronist"): es legt die Lage offen, nennt Zielwert und Modifikatoren, du entscheidest und würfelst 1d10 selbst. Ein mitlaufendes Dashboard („Lagetisch des Rates") spiegelt den Stand und erzeugt Bilder im einheitlichen Stil — Berater, Mächte, Karte und die eigene Siedlung.

Zwei Spielweisen

(a) Im Chat mit einem Frontier-Sprachmodell als Chronist. Man spielt, lässt sich auf „speichern" einen hybriden Speicherstand (lesbares Markdown plus eingebetteter json-Block) ausgeben und lädt das JSON ins Dashboard. Das Dashboard ist dafür eigenständig nutzbar, ein Stand pro Projekt.

(b) Im Terminal mit Claude Code als Chronist gegen den lokal laufenden Live-Server. Der Chronist führt die Partie und schreibt den Stand fort; jeder geschriebene Zug spiegelt sich per Live-Reload sofort ins offene Dashboard.

Schnellstart

npm install
npm run serve          # oder: PORT=4173 node serve.mjs

Dann im Browser auf http://localhost:4173. Einen Speicherstand laden (Knopf oder Drag & Drop), und das Lagebild erscheint. Auf der veröffentlichten Seite ist ein Beispielstand voreingestellt; ein eigener lässt sich jederzeit darüberladen.

Bildgenerierung (optional)

Für die Bilder braucht es einen Gemini-API-Key. Entweder in den Einstellungen (Zahnrad) eingeben oder in eine .env legen:

GEMINI_API_KEY=dein-key

Der Key bleibt lokal und wird nie committet.

Tests

npm test            # Unit-Tests (node:test)
npm run test:e2e    # End-to-End und Visual-Snapshots (Playwright)

Struktur

• index.html, js/, css/ — das Dashboard (vanilla ES-Module, kein Build).
• schema/ — JSON-Schema des Speicherstands.
• examples/ — Beispielstände (u. a. der voreingestellte Stand sowie Backups der laufenden Partien).
• docs/ — siehe unten.
• knowledge/ — verdichtetes Partie-Gedächtnis.

Weiterlesen

• docs/Spielmechanik.md — die Regeln (Spielfluss, Zugarten).
• docs/UI-Gesamtbild.md — Stil, Architektur, die Reiter, Bild-Pipeline und Live-Spiegelung.
• docs/Frontend-Contract.md — die verbindlichen Felder und testids des Dashboards.
• knowledge/INDEX.md — Kampagnen-Hub und Navigation der Partien. Es laufen derzeit zwei: „Die Gestrandeten" (aktuell geladen) und „Die Mehrung" (pausiert); beide sind jederzeit aufnehmbar.

Promptotyping

RealmCraft ist ein Promptotyping-Projekt von Christopher Pollin (DHCraft).

Licence

The code in this repository is released under the MIT Licence (see LICENSE). Documentation, knowledge documents, and other textual content are licensed under CC BY 4.0. Any third-party material included retains the rights of its holders.