👾 Darkwood: Entwicklung eines API-basierten Taktikspiels

vom 7. März 2026

Darkwood ist jetzt vollständig über die API spielbar.

Es gibt keine dedizierte Benutzeroberfläche. Kein Frontend erforderlich. Kein grafischer Client.

Die Interaktion mit dem Spiel erfolgt über HTTP.

Was „API-First“ wirklich bedeutet

In Darkwood ist der Spielablauf einfach und eindeutig:

1. GET /api/darkwood/state → Aktuelle Situation beobachten
2. Die JSON-Antwort interpretieren
3. POST /api/darkwood/action → entscheiden, was zu tun ist
4. Empfangen Sie den aktualisierten Status
5. Wiederholen

Das Spiel verhält sich über HTTP wie ein Zustandsautomat.

Jede Antwort enthält:

• state — wo du dich befindest (Haupt-, Kampf-, Info-, Shop-Bereich usw.).
• Modus — Unterphase (im Kampf, Sieg, Tod usw.)
• data — Kontextbezogene Details (Leben, Feind, Statistiken, Kampfsitzung)

Ihr Client – ​​sei es curl, ein CLI-Tool, ein Skript oder ein KI-Agent – ​​liest den Zustand und entscheidet über die nächste Aktion.

Es gibt keine versteckte UI-Logik.

Das Protokoll ist das Spiel.

Zwei Zugriffsebenen

Darkwood unterteilt den Zugang in zwei Ebenen:

1️⃣ API-Zugriff

Jede Anfrage muss Folgendes enthalten:

X-API-Key: <your-key>

Die API-Schlüsselsteuerung:

• Ob Sie die API aufrufen können
• Ob Sie Teil der Beta-Saison 0 sind
• Ob Sie Premium-Zugang haben
• Ihr tägliches Aktionskontingent (für kostenlose Schlüssel)

2️⃣ Spieleridentität

Um einen bestimmten Charakter zu spielen (fortlaufender Fortschritt, Kampf, Statuswerte), authentifizieren Sie sich mit:

Authorization: Bearer <jwt-token>

Das JWT identifiziert das Spielerkonto. Der API-Schlüssel steuert Zugriff und Monetarisierung.

Sie sind absichtlich getrennt.

Die vollständige Dokumentation ist auf GitHub verfügbar: https://github.com/darkwood-com/darkwood-com/blob/main/docs/

Kostenlos vs. Premium

Darkwood läuft aktuell als Beta-Saison 0.

Es gibt zwei Arten von Schlüsseln:

🎟 Beta-Zugang (kostenlos)

• Persönlicher API-Schlüssel
• Begrenzte tägliche Aktionen
• Zugriff auf den aktuellen spielbaren Zustand
• Kein Archivzugriff

💎 Gründer-Premium

• Persönlicher API-Schlüssel
• Unbegrenzte tägliche Aktionen
• Zugriff auf archivierte Puzzle-Momentaufnahmen
• Status als früher Unterstützer

Archive sind schreibgeschützte Momentaufnahmen vergangener spielbarer Zustände. Sie legen historische Spielstände offen, ohne das laufende Spielgeschehen zu verändern.

Limitierte Gründer-Edition

Um diesen Start kontrolliert durchzuführen:

• 5 Beta-Zugangsschlüssel
• 5 Founder Premium-Keys

Das war’s.

Dies ist kein groß angelegter Start. Es handelt sich um eine gezielte Veröffentlichung zur Validierung des Modells.

Der Vertrieb erfolgt über Bonzai:

• Beta-Zugang (kostenlos): https://www.bonzai.pro/matyo91/shop/yDxv_7247/darkwood-api-beta-access-free

• Gründer-Premium: https://www.bonzai.pro/matyo91/shop/lQxn_7249/darkwood-api-founder-premium

Jeder Schlüssel ist persönlich. Die Schlüssel können bei Bedarf gedreht werden.

Warum keine Benutzeroberfläche?

Weil die Schnittstelle optional ist.

Darkwood kann gespielt werden mit:

• curl
• Postman
• eine benutzerdefinierte CLI
• ein kleiner Webclient
• ein Skript
• ein KI-Agent

Die API definiert den Spielvertrag.

Der Klient ist lediglich ein Dolmetscher.

Beta-Saison 0

Die Spiellogik bleibt unverändert.

Im Mittelpunkt dieser Phase steht:

• API-Stabilität
• Sauberes Monetarisierungsmodell (nur API-Schlüssel)
• Deterministischer Zustandsfluss
• Klarheit der Dokumentation

Keine Überkonstruktion. Keine unnötigen Funktionen.

Ein taktisches Spiel, das als Protokoll entlarvt wurde.

Darkwood ist nicht nur ein Backend-Projekt.

Es handelt sich um ein Spiel, das vollständig über HTTP läuft.

Und Beta Staffel 0 ist jetzt live.