👾 Darkwood : Créer un jeu tactique axé sur les API

Darkwood est désormais jouable entièrement via API.

Il n'y a pas d'interface utilisateur dédiée. Aucune interface utilisateur requise. Pas de client graphique.

Vous interagissez avec le jeu via HTTP.

Que signifie réellement « API-First » ?
Dans Darkwood, la boucle de jeu est simple et explicite :

GET /api/darkwood/state → observer la situation actuelle
Interpréter la réponse JSON
POST /api/darkwood/action → décider de l'action à effectuer
Recevoir l'état mis à jour
Répéter
Le jeu se comporte comme une machine à états via HTTP.

Chaque réponse comprend :

état — où vous vous trouvez (principal, combat, infos, boutique, etc.)
mode — sous-phase (combat, victoire, mort, etc.)
data — détails contextuels (vie, ennemi, statistiques, session de combat)
Votre client — qu'il s'agisse de curl, d'un outil en ligne de commande, d'un script ou d'un agent d'IA — lit l'état et décide de la prochaine action.

Il n'y a pas de logique d'interface utilisateur cachée.

Le protocole est la clé du jeu.

Deux niveaux d'accès
Darkwood divise l'accès en deux niveaux :

1️⃣ Accès API
Chaque demande doit inclure :

X-API-Key:
La clé API contrôle :

Si vous pouvez appeler l'API
Que vous fassiez partie de la saison bêta 0
Que vous ayez un accès premium
Votre quota d'actions quotidien (pour les clés gratuites)
2️⃣ Identité du joueur
Pour jouer avec un personnage spécifique (progression persistante, combats, statistiques), vous vous authentifiez avec :

Authorization: Bearer
Le JWT identifie le compte du joueur. La clé API contrôle l'accès et la monétisation.

Ils sont séparés par conception.

La documentation complète est disponible sur GitHub : https://github.com/darkwood-com/darkwood-com/blob/main/docs/

Gratuit vs Premium
Darkwood est actuellement en cours de développement en Bêta Saison 0.

Il existe deux types de clés :

🎟 Accès bêta (gratuit)
Clé API personnelle
Actions quotidiennes limitées
Accès à l'état jouable actuel
Accès aux archives impossible
💎 Fondateur Premium
Clé API personnelle
Actions quotidiennes illimitées
Accès aux instantanés archivés des puzzles
Statut de soutien précoce
Les archives sont des instantanés en lecture seule des états jouables antérieurs. Ils permettent de révéler l'état historique du jeu sans modifier le déroulement en direct.

Édition limitée pour les fondateurs
Pour que ce lancement reste sous contrôle :

5 clés d'accès bêta
5 clés Fondateur Premium
C'est ça.

Il ne s'agit pas d'un lancement à grande échelle. Il s'agit d'une version ciblée visant à valider le modèle.

Les ventes sont gérées par Bonzai :

Accès bêta (gratuit) : https://www.bonzai.pro/matyo91/shop/yDxv_7247/darkwood-api-beta-access-free

Premium Fondateur : https://www.bonzai.pro/matyo91/shop/lQxn_7249/darkwood-api-founder-premium

Chaque clé est personnelle. Les touches peuvent être pivotées si nécessaire.

Pourquoi pas d'interface utilisateur ?
Parce que l'interface est optionnelle.

Vous pouvez jouer à Darkwood avec :

curl
Postman
une interface de ligne de commande personnalisée
un petit client web
un script
un agent d'IA
L'API définit le contrat du jeu.

Le client n'est qu'un interprète.

Saison bêta 0
La logique du jeu reste inchangée.

L'objectif de cette phase est :

Stabilité de l'API
Modèle de monétisation propre (clé API uniquement)
Flux d'état déterministe
Clarté de la documentation
Pas de sur-ingénierie. Aucune fonctionnalité superflue.

Un simple jeu tactique déguisé en protocole.

Darkwood n'est pas qu'un simple projet backend.

C'est un jeu qui fonctionne entièrement via HTTP.

Et la saison 0 de la bêta est maintenant disponible.