Solstice Cipher: Programmieren gegen die Dunkelheit – ein JavaScript-Puzzle

In einer Ära, in der Algorithmen nicht nur Rechenleistung, sondern auch Geschichte schreiben, präsentiert sich Solstice Cipher als einzigartiges Browser-Spiel, das Programmieren zur eigentlichen Spielmechanik erhebt. Entwickelt für den Juni-Solstice-Game-Jam, führt das Spiel Spieler in eine fiktive Welt des Jahres 1941 am Bletchley Park, wo sie als Teil von Alan Turings Team verschlüsselte Botschaften entschlüsseln müssen. Doch statt einfacher Klickspiele steht hier echter JavaScript-Code im Mittelpunkt: Jede gelöste Aufgabe bringt nicht nur Fortschritt, sondern auch mehr Tageslicht in eine dunkle Simulation.

Ein Spiel, das Code zur Waffe macht

Das Kernkonzept von Solstice Cipher ist denkbar einfach: Spieler analysieren eine abgefangene, verschlüsselte Nachricht und müssen eine Funktion namens decrypt(text) im eingebauten Monaco-Editor – demselben Tool, das auch VS Code antreibt – implementieren. Der entscheidende Unterschied zu klassischen Puzzle-Spielen? Hier wird nicht geraten, sondern programmiert. Nach dem Drücken des Run decrypt()-Buttons wird der Code sofort ausgeführt und das Ergebnis mit der erwarteten Lösung abgeglichen. Stimmen die Ausgaben überein, schreitet der Spieler zur nächsten Ebene – und die Sonne geht langsam auf.

Das Spiel umfasst fünf aufeinander aufbauende Schwierigkeitsgrade, die jeweils einer Phase des längsten Tages des Jahres entsprechen. Jede Ebene stellt dabei einen anderen klassischen Verschlüsselungsalgorithmus vor:

• Vorausgang (Level 1): Caesar-Verschiebung mit einem festen Schlüssel
• Sonnenaufgang (Level 2): Atbash-Spiegelung
• Vormittag (Level 3): ROT13-Rotation
• Mittag (Level 4): Vigenère-Verschlüsselung mit dem Schlüsselwort PRIDE
• Längster Tag (Level 5): Kombinierte Caesar-Verschiebung mit Wortumkehr

Jede gelöste Aufgabe füllt eine Tageslicht-Leiste von 15 % auf 100 %, während sich der Himmel hinter der Benutzeroberfläche langsam aufhellt. Der thematische Rahmen ist dabei kein bloßer optischer Effekt, sondern erzählt eine Geschichte: Vom ersten Licht bis zum längsten Tag des Jahres.

Technisch durchdacht: Monaco als Spielwelt

Ein zentraler Aspekt des Spiels ist die Integration des Monaco-Editors, der nicht nur als Textfeld, sondern als vollständige Spielumgebung dient. Die Implementierung verzichtet bewusst auf eine kontrollierte React-Komponente und setzt stattdessen auf eine unkontrollierte Variante mit defaultValue und Referenzen. Dadurch wird eine flüssige Eingabe ohne störende Neurenderungen ermöglicht – eine technische Entscheidung, die für ein reibungsloses Spielerlebnis entscheidend ist.

Für die visuelle Gestaltung wurde ein industrieller CRT-Look gewählt, inspiriert von den Terminals der 1940er Jahre. Die Farbpalette besteht aus phosphorgrünen Zeichenketten, feuerroten Schlüsselwörtern und einem dunklen Hintergrund, der an alte Röhrenmonitore erinnert. Besonders innovativ ist die Integration von Line-Highlighting, das gezielt Zeilen markiert, die von der KI als fehlerhaft identifiziert wurden.

KI-Unterstützung mit Tiefgang – nicht nur ein Chatbot-Ersatz

Ein weiteres Highlight von Solstice Cipher ist die KI-basierte Hilfefunktion, die über die bloße Bereitstellung von Chatbot-Oberflächen hinausgeht. Spieler können optional die Gemini-3.5-Flash-API nutzen, um gezielte Hinweise zu erhalten. Doch bevor eine API-Anfrage erfolgt, führt das Spiel eine lokale statische Code-Analyse durch. Diese prüft:

• Ob unveränderte Starter-Codezeilen vorhanden sind
• Typische Fehler wie fehlende Verschiebungen (result += char ohne Modifikation)
• Den aktuellen Ausführungsstatus (nicht ausgeführt, Laufzeitfehler, falsche Ausgabe, korrekt)
• Die optimale Art der KI-Hilfe (Anleitung, Debugging oder Fehlerbehebung)

Erst danach wird die Analyse zusammen mit dem Quellcode an Gemini übermittelt. Die KI liefert dann zeilenspezifische Hinweise, die direkt auf den Code verweisen – ohne die Lösung vorwegzunehmen. Ein besonderes Feature ist die Fix-Vorschläge, bei denen Gemini einen korrigierten Code-Block zurückgibt. Dieser wird sofort gegen die verschlüsselte Eingabe getestet, und die erste funktionierende Version wird übernommen. Falls die KI keine Lösung findet, springt ein lokales Diff-System ein, das Starter- und Lösungscode zeilenweise vergleicht.

Die Implementierung der KI-Funktionen erfordert nur eine .env-Datei mit dem Schlüssel VITE_GEMINI_API_KEY. Ohne diesen Schlüssel funktioniert das Spiel dennoch vollständig offline.

Sicherheit und Ausführung: Code ohne Risiko

Ein zentrales Anliegen bei der Entwicklung war die sichere Ausführung von Benutzercode. Da das Spiel vollständig im Browser läuft, wird jeder Code über new Function() ausgeführt – allerdings mit strengen Sicherheitsauflagen. Die Funktion decrypt(text) muss zwingend definiert sein und eine Zeichenkette zurückgeben. Vor dem Vergleich mit der erwarteten Lösung werden Ausgaben normalisiert (Großbuchstaben, Leerzeichen entfernt). Netzwerkzugriffe oder serverseitige Operationen sind ausgeschlossen. Das Spiel bleibt damit eine vollständig statische Anwendung ohne externe Abhängigkeiten.

Ein Spiel mit historischem Gewicht und modernem Anspruch

Solstice Cipher ist mehr als nur ein weiteres Programmier-Puzzle. Es verbindet historische Kryptografie mit modernen Entwicklerwerkzeugen und schafft damit eine einzigartige Lernerfahrung. Durch die Integration von Alan Turings Kontext und die Betonung von Algorithmen als Spielmechanik wird nicht nur das Verständnis für Verschlüsselungstechniken gefördert, sondern auch die Fähigkeit, komplexe Probleme durch Code zu lösen.

Die Entwicklungszeit von Solstice Cipher zeigt, wie aus einer einfachen Idee ein technisch anspruchsvolles und thematisch tiefgründiges Spiel entstehen kann. Mit einer Kombination aus React 19, TypeScript und Vite für die Frontend-Entwicklung, dem Monaco-Editor als Spielwelt und Gemini-3.5-Flash für KI-Hilfen beweist das Projekt, dass moderne Webtechnologien auch für kreative und lehrreiche Anwendungen genutzt werden können.

In einer Zeit, in der künstliche Intelligenz und Programmierung immer stärker verschmelzen, könnte Solstice Cipher nicht nur als unterhaltsames Spiel, sondern auch als didaktisches Werkzeug dienen. Denn hier wird nicht nur gespielt – hier wird gelernt, analysiert und gelöst. Und am Ende wartet nicht nur der Sieg über die Dunkelheit, sondern auch die Erkenntnis, dass Code mehr ist als nur ein Werkzeug: Er ist eine Waffe gegen Unwissenheit.