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.

Dans Darkwood, la boucle de jeu est simple et explicite :

1. GET /api/darkwood/state → observer la situation actuelle

2. Interpréter la réponse JSON

3. POST /api/darkwood/action → décider de l'action à effectuer

4. Recevoir l'état mis à jour

5. 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.

Darkwood divise l'accès en deux niveaux :

Chaque demande doit inclure :

X-API-Key: <your-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)

Pour jouer avec un personnage spécifique (progression persistante, combats, statistiques), vous vous authentifiez avec :

Authorization: Bearer <jwt-token>

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/

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

Il existe deux types de clés :

• Clé API personnelle

• Actions quotidiennes limitées

• Accès à l'état jouable actuel

• Accès aux archives impossible

• 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.

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.

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.

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.