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

le 7 mars 2026

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 :

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.

Deux niveaux d'accès

Darkwood divise l'accès en deux niveaux :

1️⃣ Accès API

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)

2️⃣ Identité du joueur

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/

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.