Vaticinium

Ein Vorhersage-Stichspiel im Browser · vaticinium.html · GitHub

Vaticinium bringt das klassische Wizard-Kartenspiel vollständig in den Browser — solo gegen drei KI-Gegner oder in Echtzeit mit Freunden über einen eigenen Node.js-Server.

Überblick

Vaticinium — lateinisch für „Prophezeiung" — ist ein Vorhersage-Stichspiel: Vor jeder Runde sagt jeder Spieler an, wie viele Stiche er machen wird. Wer seine Ansage exakt trifft, punktet am meisten.

60 Spielkarten in 4 Farben (Werte 1–13), dazu 4 Zauberer und 4 Narren
Bei 4 Spielern läuft eine vollständige Partie über 15 Runden
Keine Installation für Mitspieler nötig — läuft im Browser, responsiv auf Desktop und Mobilgerät

Solo & Multiplayer

Zwei Wege an den Spieltisch: Solo gegen drei KI-Gegner mit lokaler Bestenliste, oder Multiplayer in Echtzeit mit Freunden über Socket.io — ohne Firebase oder andere externe Dienste.

Grundprinzip

In jeder Runde erhält jeder Spieler eine Karte mehr als in der vorigen Runde
Bevor die erste Karte ausgespielt wird, sagt jeder Spieler voraus, wie viele Stiche er in dieser Runde erzielen wird
Es wird reihum ausgespielt; wer den höchsten Wert der angespielten Farbe zeigt (oder einen Zauberer), gewinnt den Stich
Am Ende der Runde wird verglichen: Ansage gegen tatsächlich erzielte Stiche

Karten

Kartentyp	Anzahl	Wirkung
Zahlenkarten	52 (4 Farben × 1–13)	Normale Stichkarten — höchster Wert der angespielten Farbe gewinnt, sofern kein Zauberer im Stich liegt
Zauberer	4	Gewinnt den Stich immer. Wird als erste Karte eines Stichs gespielt, bestimmt keine Farbe für die anderen
Narren	4	Verliert den Stich immer, außer alle gespielten Karten sind Narren

Ansage & Stiche

Die Ansage erfolgt verdeckt für die Mitspieler, bevor die Runde beginnt, und ist danach bindend — sie kann während der Runde nicht mehr geändert werden. Am Ende jeder Runde zeigt die Auswertung Ansage und erzielte Stiche jedes Spielers nebeneinander.

Punktewertung

Punkte: Eine exakt getroffene Ansage bringt 20 Punkte plus 10 Punkte je angesagtem Stich. Bei einer Abweichung werden 10 Punkte je Stich Differenz abgezogen.

Solo-Modus

Im Solo-Modus tritt man gegen drei KI-Gegner an. Die KI nutzt eine adaptive Bietstrategie mit bewusst eingebauten kleinen menschlichen Unschärfen, damit sich die Gegner nicht wie reine Taschenrechner verhalten.

Solo-Ergebnisse landen in einer lokalen Bestenliste (Guest-Highscore im Browser-localStorage)
Mit einem Benutzerkonto wird der Spielstand zusätzlich serverseitig gespeichert und ist geräteübergreifend verfügbar

Multiplayer & Tische

Tisch erstellenEin Spieler eröffnet einen Tisch und teilt den Zugang mit den Mitspielern. Optional kann der Host „Nachträgliches Beitreten" aktivieren.

WarteraumMitspieler treten dem Tisch bei und warten dort, bis der Host die Partie startet.

SpielenRunden, KI-Züge (bei nicht besetzten Plätzen), Stichauswertung und Punkteberechnung laufen zentral auf dem Server — alle Teilnehmer sehen denselben, synchronen Spielstand.

TischchatEin integrierter Echtzeit-Chat läuft während der ganzen Partie mit.

Late-Join

Wenn der Host „Nachträgliches Beitreten" beim Erstellen des Tisches aktiviert hat, können neue Spieler während einer laufenden Partie einen von der KI besetzten Platz übernehmen. Die KI spielt die aktuelle Runde noch zu Ende — ab der nächsten Runde übernimmt der Mensch.

Benutzerkonto

Ein Konto ist optional — Vaticinium funktioniert vollständig ohne Registrierung.

Ohne Konto (Gast)	Mit Konto
Solo-Spiele laufen normal	Spielstand wird serverseitig gespeichert (browserübergreifend)
Spielstand nur im Browser-`localStorage`	Beim Start eines Solo-Spiels wird der neuere Stand (Server vs. lokal) zur Wahl angeboten
Kein Eintrag in der Hall of Fame	Sieg als eingeloggter Nutzer wird automatisch in die Hall of Fame eingetragen

Ein Konto wird über den 👤 Konto-Button in der Lobby angelegt. Das Login-Token wird im localStorage gespeichert und bleibt über Browser-Neustarts erhalten.

Datenschutz: Passwörter werden serverseitig mit PBKDF2 (100.000 Iterationen, SHA-256, individueller Salt) gehasht — nie im Klartext gespeichert.

Selbst hosten

Vaticinium ist kein gehosteter Dienst, sondern wird selbst betrieben — auf einem eigenen Server, NAS oder lokal.

Voraussetzungen

Node.js 18 oder neuer

Installation

git clone https://github.com/noyse27/vaticinium.git
cd vaticinium
npm install
node server.js

Der Server startet auf Port 3000. Im Browser http://localhost:3000 aufrufen.

Port ändern

PORT=8080 node server.js

Dauerhaft laufen lassen

Für den Dauerbetrieb, z. B. auf einem Synology-NAS, eignet sich ein Prozess-Manager wie PM2:

npm install -g pm2
pm2 start server.js --name vaticinium
pm2 save