Der Fährmann rudert, eine Tote spielt mit ihm Karten um ein paar Münzen.

Obolus

Making-of · wie aus einem Duell ein Roguelike wurde

In English, in one paragraph. Obolus is a roguelike card game about bluffing and ordering: you lay five memories face down under stacks of coins, reveal them round by round and secretly pick a manoeuvre paid for with breath. It is built as a TypeScript monorepo around a pure, deterministic rules core that runs unchanged in the browser, on the server and in a balancing bot. Because a run is fully described by its seed and the list of player actions, saving, shareable replays and a cheat-proof leaderboard come almost for free: the server never trusts a score, it replays every run itself. A bot plays thousands of nights per character to keep win rates in a target band. The art is AI-generated linocut, processed so that it prints onto the game's paper. Playable in German and English, on phones and desktop, with keyboard and gamepad.
Jetzt spielen Zur Technik

Die Idee

Am Anfang stand ein Duell aus einem älteren Projekt: fünf Karten verdeckt ordnen, Einsätze von 1, 1, 2, 2 und 3, ein Blick auf eine gegnerische Karte, Manöver mit begrenzter Nervenkraft. Das Duell war gut – aber nach zwei Tagen gab es nichts mehr zu entdecken, weil der Fortschritt über Sammeln und Aufleveln lief. Obolus dreht das um: Nichts wird dauerhaft stärker. Jede Nacht beginnt neu, Freischalten bringt nur Auswahl – andere Seelen, mehr verschiedene Erinnerungen, höhere Tiefe.

Dazu kam ein Thema, das die Regeln erklärt, statt sie zu dekorieren: Du bist gestorben und spielst auf der Nachtfähre um die Rückkehr. Karten sind Erinnerungen (mit einem Gefühl: Zorn, Furcht, Sehnsucht oder Still), Einsätze sind Obolen (die Münze für den Fährmann), Manöver kosten Atem, und das Leben eines Laufs ist das Licht deiner Laterne.

Jede der fünf Seelen spielt sich anders: Die Uhrmacherin sieht immer den höchsten Stapel, der Taschendieb zieht dem Gegner blind eine Karte aus der Hand, die Hebamme gewinnt Atem aus jeder gewonnenen Runde, der Schachmeister sieht zwei Karten, spielt aber nur mit vier, und die Seiltänzerin setzt billiger alles – zahlt Niederlagen aber anderthalbfach mit Licht.

Ein Kern, drei Orte

Das wichtigste technische Prinzip steht in ADR 0001: Alle Regeln liegen in einem reinen, deterministischen Kern. Reine Funktionen bekommen einen Zustand und liefern einen neuen – ohne DOM, ohne Uhr, ohne Math.random, nur mit Ganzzahlen. Zufall kommt aus einem eigenen Generator (mulberry32), dessen Zustand Teil des Spielzustands ist.

packages/core Regeln · Zufall · KI · Profil BrowserSvelte 5 · spielt live ServerFastify · spielt nach Balancing-Bottausende Nächte Seed + Aktionen, keine Punkte
Derselbe TypeScript-Kern läuft im Browser, auf dem Server und im Bot. Über das Netz gehen nur Startwerte und Aktionen.

Daraus folgt fast alles Weitere: Ein Lauf ist vollständig beschrieben durch Startwerte + Liste der Aktionen. Gespeichert wird im Browser nur diese Liste; beim Fortsetzen wird die Nacht nachgespielt. Ein Replay-Link ist dieselbe Liste auf dem Server. Und die Bestenliste ist fälschungssicher, weil der Server niemandem Punkte glaubt:

// apps/server/src/pruefen.ts (gekürzt)
if (tag) {
  const soll = tagesnacht(tag, SEELEN_REIHE);          // rein aus dem Datum, ohne Date()
  if (soll.seed !== start.seed || soll.tiefe !== start.tiefe /* … */) return abgelehnt("passt nicht zur Tagesnacht");
}
const z = spieleLaufNach(start, INHALT, aktionen);     // derselbe Kern wie im Browser
if (!z.ende) return abgelehnt("Lauf noch nicht zu Ende");
return { ok: true, punkte: laufPunkte(z) };            // Punkte rechnet nur der Server

Die Tests versuchen genau das zu brechen: eine veränderte Kartenordnung, ein abgeschnittener Lauf, ein fremder Seed als Tagesnacht ausgegeben, eine leichtere Tiefe, eine alte Spielversion, eine erfundene Aktion – alles wird abgelehnt. Spieler bleiben dabei anonym: Kennung plus Token, auf dem Server liegt nur der SHA-256 des Tokens.

Die Tagesnacht ohne Uhr

Jeden Tag spielen alle dieselbe Nacht: fester Seed, eine Seele, eine Sonderregel, Tiefe 2. Damit Client und Server dasselbe ausrechnen, ohne dass der Kern eine Uhr kennt, wird das Datum als Text übergeben und mit reiner Ganzzahl-Arithmetik in einen Tageszähler umgerechnet (der Algorithmus days from civil). Seed und Regel folgen daraus.

Balancing per Bot

Ein Roguelike lebt davon, dass Läufe knapp sind. Weil der Kern deterministisch und schnell ist, spielt ein einfacher Bot – er sieht nur, was ein Mensch sieht – tausende Nächte je Seele. Das Ziel aus dem Konzept: 55–70 % Siege für den Bot auf Tiefe 0, und keine Grabbeigabe darf die Siegquote um mehr als 15 Punkte verschieben.

Ziel 55–70 % Uhrmacherin61 % Taschendieb65 % Hebamme65 % Schachmeister59 % Seiltänzerin59 % 0 %100 %
500 Bot-Nächte je Seele, Tiefe 0, Anfangspool. Erzeugt mit npm run lauf-sim -- 500 alle 0 0 --bericht.

Die erste Messung lag bei 1 % – und deckte nebenbei auf, dass der Bot verdeckte Einsätze lesen konnte, also geschummelt hat. Später war der Taschendieb mit 90 % viel zu stark: Selbst ein blinder Kartentausch ist ein Geschenk, wenn die Karten des Gegners im Schnitt besser sind als die eigene schwächste. Die Lösung kam aus der Geschichte statt aus einer Zahl: Eine gestohlene Erinnerung ist fremd und zählt 4 Kraft weniger.

Für die Grabbeigaben musste das Messverfahren selbst korrigiert werden: Wer am Ende viele Beigaben besitzt, hat schlicht länger überlebt. Gemessen wird deshalb gegen den Schnitt aller Beigaben-Läufe, nicht gegen die Gesamtquote. Damit es 60 verschiedene Beigaben geben kann, ohne dass der Kern zu einem Dickicht aus Sonderfällen wird, beschreibt jede ihre Wirkung als Daten ({ kraft: { zorn: 3, furcht: -1 } }), und der Kern rechnet alle Wirkungen eines Laufs zusammen.

Der Linoldruck

Der Look ist heller Linoldruck: Knochenweiß, Tinte, Blattgold und je Karte eine Gefühlsfarbe. Die Illustrationen sind mit Gemini entstanden, alle mit demselben Stilblock im Prompt. Ein kleines Skript schätzt den Papierton jedes Bildes, hebt ihn auf reines Weiß und schneidet zu. Im Spiel liegen die Bilder dann mit mix-blend-mode: multiply auf dem Spielpapier – Weiß verschwindet, Tinte bleibt, und alles wirkt wie auf dasselbe Blatt gedruckt.

Die Witwe im Schilf Der Pfandleiher Der Leuchtturmwärter Der Fährmann

Eine Falle auf dem Weg dorthin: Bildet irgendein Vorfahr eine eigene Stapelebene (z-index, filter), fehlt dem Multiplizieren der Papiergrund – und aus dem Druck wird ein weißer Kasten. Der Klang kommt ganz ohne Audiodateien aus: Papierschnalzen, Münzklirren und Atemzüge entstehen im Browser aus Rauschen und Sinustönen (Web Audio).

Für alle spielbar

Entscheidungen und Ablauf

PhaseErgebnis
1 KernMonorepo, deterministischer Duellmotor, Gegner-KI, Bot mit 30.000 Duellen
2 LaufUfer-Karte, Licht, Krämerin, Rast, Wächter, Speichern durch Nachspielen
3 LookGemini-Bilder als Druck, Animationen, Klang, Querformat
4 Tiefe5 Seelen, Tiefe 1–20, Pool-Stufen, Archiv, Fetzen, Balancing-Bericht
5 ServerTagesnacht, Bestenliste per Nachspielen, Replay-Links, Teilen-Karte
6 FeinschliffEnglisch, Anleitung, Controller, Barrierefreiheit, Lighthouse 95+
7 Startdiese Seite, README, öffentliche Fassung

Die tragenden Entscheidungen sind als Architecture Decision Records festgehalten: deterministischer Kern · Bestenliste nur über Nachspielen · Grabbeigaben als Daten · Zweisprachigkeit im Markup · Bilder als Druck auf dem Spielpapier.

Obolus spielen

Obolus – ein privates Projekt ohne Werbung · Impressum · Datenschutz