Ce qu’un document de conception prêt pour l’IA doit trancher
Un city-builder à cartes combine deux types de décisions : quelle carte jouer et où le village peut s’agrandir. Un bon document de conception explicite ces choix avant d’élargir le catalogue de cartes. Il donne au créateur, à ses coéquipiers ou à un outil de création de jeu suffisamment de règles communes pour implémenter deux fois le même tour et obtenir le même résultat.
Cet article propose un modèle compact et réutilisable pour un premier jalon. Il s’appuie sur une grille fictive de trois cases sur trois, une tuile de route et trois cartes de bâtiment. L’exemple est un exercice de planification avec des valeurs calculées à la main. Les prompts ci-dessous sont des brouillons : ils n’ont pas été exécutés et aucun jeu jouable ni résultat de test n’est fourni.

Commencez par une phrase qui décrit l’objectif du joueur, puis définissez la plus petite boucle susceptible de donner du sens à cet objectif. Dans cet exemple, le joueur développe un village en posant une carte de bâtiment par manche. Le premier jalon n’est pas « une ville complète », mais une séquence de trois manches où le logement, la nourriture et les revenus comptent chacun, et où le lecteur peut suivre les totaux de ressources sans rien deviner.
Séparez les règles établies des questions auxquelles la conception n’a pas encore répondu. Si un document mélange les deux, la personne chargée de l’implémentation risque d’inventer discrètement une pioche, des règles d’amélioration ou une condition de défaite. Le prototype peut alors sembler plus complet, mais son comportement devient impossible à comparer à l’intention initiale. Délimitez clairement le périmètre : ce jalon utilise une main de départ fixe, sans pioche ni défausse et sans événements aléatoires.
Règles du plateau, du placement et des manches
Pour l’exemple, utilisez une grille de trois cases sur trois avec une tuile de route préinstallée au centre. Un bâtiment ne peut occuper une parcelle vide que si celle-ci partage un côté avec une tuile de route. Un contact en diagonale ne compte pas. Cette règle donne un contrôle de placement clair et laisse les parcelles libres visibles comme choix futurs.
Écrivez l’ordre d’une manche sous forme de séquence numérotée, car cet ordre change les résultats. Dans cette conception, le joueur choisit une carte, vérifie que son emplacement est vide et adjacent à la route, paie son coût, résout la production de tous les bâtiments actifs, puis paie l’entretien en nourriture. Une ferme jouée pendant cette manche produit avant que les habitants consomment de la nourriture au cours de cette même manche. Si le joueur ne peut pas nourrir tout le monde, la population baisse d’un habitant par unité de nourriture manquante, sans jamais passer sous zéro, et le stock de nourriture tombe à zéro.

Gardez un tableau de règles près du début du document de travail afin que les prompts suivants puissent reprendre des termes exacts :
- Plateau : grille 3×3 ; une route centrale au départ.
- Parcelle constructible : vide et adjacente orthogonalement à une route.
- Limite d’action : jouer exactement une carte par manche.
- Ordre des phases : poser et payer → produire → entretien en nourriture.
- Pénurie : perdre un habitant par unité de nourriture manquante ; la population minimale est zéro.
Ces règles sont volontairement limitées. N’ajoutez pas de marché de cartes, d’action de construction de route, de bonus de voisinage ou de modificateur saisonnier avant d’avoir pu vérifier la première boucle. Un jalon restreint est plus facile à implémenter et à réviser si l’exemple met un problème au jour.
Un schéma de carte qu’un outil peut suivre
Représentez les cartes sous forme de données, et pas uniquement en prose. Une fiche cohérente évite que le même effet soit décrit différemment dans le prompt, l’interface et la logique du jeu. Les champs suivants suffisent à définir les trois bâtiments de départ :
{
"id": "farm_basic",
"name": "Farm",
"category": "food",
"cost": {"coins": 2},
"placementRule": "empty_plot_orthogonally_adjacent_to_road",
"production": {"food": 4},
"upkeep": {},
"capacityEffect": {},
"roundTiming": "production_phase_each_round_after_placement",
"adjacency": [],
"notes": "Fictional starter card; values are design assumptions."
}
Associez une unité et une règle de timing à chaque champ numérique. « Produit quatre unités de nourriture » ne suffit pas si la personne qui développe le jeu ne sait pas si cela se produit une fois, à chaque tour ou uniquement près d’une chaumière. Pour le premier jalon, la production se répète à chaque manche après l’entrée en jeu de la carte. Aucune carte de départ ne bénéficie d’un bonus de voisinage. Cela évite volontairement les interactions cachées.
La main de départ fictive comprend une chaumière qui coûte 3 pièces et ajoute 2 places de logement, une ferme qui coûte 2 pièces et produit 4 unités de nourriture par manche, et un marché qui coûte 2 pièces et rapporte 2 pièces par manche. Le joueur commence avec 7 pièces, 2 unités de nourriture, 2 habitants et une capacité de logement de 2. La chaumière augmente le plafond de capacité ; elle n’ajoute pas d’habitants à elle seule.
Dans un tableur ou un fichier JSON, gardez une fiche par carte et vérifiez que chaque identifiant est unique, que chaque coût est non négatif, que chaque règle de placement est reconnue et que chaque valeur de production a un type de ressource défini. Le document doit aussi indiquer si les effets d’une carte commencent immédiatement après sa pose. Ici, c’est le cas : un bâtiment posé pendant la phase d’action est actif lors de la phase de production de cette même manche.
Un exemple de trois manches vérifiable à la main
Le tableau ci-dessous applique l’ordre indiqué. Les soldes sont présentés après toutes les phases de chaque manche. Le stock initial est de deux unités de nourriture : le village peut donc nourrir ses deux habitants au premier tour même s’il ne possède pas encore de bâtiment producteur de nourriture.
| Manche | Carte et coût | Après production | Après l’entretien en nourriture | Autre état |
|---|---|---|---|---|
| Départ | — | 7 pièces, 2 unités de nourriture | — | 2 habitants, logement pour 2 |
| 1 | Chaumière, −3 pièces | 4 pièces, 2 unités de nourriture | 4 pièces, 0 unité de nourriture | 2 habitants, logement pour 4 |
| 2 | Ferme, −2 pièces | 2 pièces, 4 unités de nourriture | 2 pièces, 2 unités de nourriture | 2 habitants, logement pour 4 |
| 3 | Marché, −2 pièces | 2 pièces après les +2 du marché ; 6 unités de nourriture avant l’entretien | 2 pièces, 4 unités de nourriture | 2 habitants, logement pour 4 |
La production se répète à chaque manche pour tous les bâtiments actifs. À la troisième manche, la ferme produit encore 4 unités de nourriture, tandis que les 2 pièces rapportées par le marché compensent son coût de pose de 2 pièces. Avec les 2 unités de nourriture restantes après la deuxième manche, le village termine la troisième avec 4 unités après l’entretien. Son état final est de 2 habitants, une capacité de logement de 4, 2 pièces et 4 unités de nourriture.
Cette trace explicite rend le timing visible. Une ligne compacte de « résultats attendus » doit lui correspondre exactement : après la première manche, 4 pièces et 0 unité de nourriture ; après la deuxième, 2 pièces et 2 unités de nourriture ; après la troisième, 2 pièces et 4 unités de nourriture. Si la conception prévoit que la nourriture n’est produite que pendant la manche de pose, c’est une autre règle qui doit figurer dans le champ de timing de la ferme.

Les images sont des illustrations conceptuelles destinées à aider à visualiser l’objectif de conception. Elles ne montrent ni un jeu réel, ni un écran de produit, ni une version testée de ces règles. Conservez l’état de l’exemple sous forme de texte et de données afin que chaque chiffre puisse être vérifié.
Modèle de document réutilisable et séquence progressive de prompts
Copiez ces sections dans un nouveau document de conception, puis remplacez les champs entre crochets par les règles d’un projet précis :
- Promesse au joueur : [Que construit le joueur et qu’est-ce qui rend ses choix intéressants ?]
- Premier jalon : [Un scénario court qui démontre la boucle principale.]
- Plateau et placement : [Forme du plateau, occupation, cases autorisées, voisinage et règles de remplacement.]
- Ordre du tour : [Actions, paiement, effets, entretien et vérifications de fin de manche.]
- Ressources : [Valeurs initiales, plafonds, coûts, production, entretien et comportement en cas de pénurie.]
- Données des cartes : [Identifiant, coût, placement, effet, timing, voisinage et notes.]
- Limites connues : [Fonctionnalités volontairement exclues du premier jalon.]
- Critères d’acceptation : [État initial, séquence d’actions, état attendu et cas d’échec.]
- Questions ouvertes : [Décisions à prendre après la première version jouable.]
Transformez le document en prompts par étapes au lieu de demander un city-builder complet d’un seul coup. Un premier brouillon peut définir la grille, la tuile de route et les placements autorisés. Un deuxième peut ajouter l’état des ressources et les trois cartes de départ. Un troisième peut implémenter l’ordre des phases, y compris la production avant l’entretien. Un dernier brouillon peut demander la séquence de trois manches et afficher chaque transition d’état.
Dans chaque prompt, séparez les résultats attendus des observations. Par exemple : « Attendu selon la conception : après la troisième manche, le village compte 2 habitants, une capacité de logement de 4, 2 pièces et 4 unités de nourriture. Affiche séparément l’état réel produit par la compilation. En cas d’écart, signale-le ; ne modifie pas les règles en silence. » Cette formulation fournit à un testeur ultérieur une comparaison concrète sans prétendre que le test a eu lieu.
Critères d’acceptation et questions ouvertes
Avant un futur test de jeu, vérifiez le plus petit ensemble de comportements qui prouverait que les règles écrites fonctionnent ensemble :
- Un bâtiment ne peut pas être posé sur une parcelle occupée.
- Une liaison avec la route centrale qui ne passe que par la diagonale est refusée.
- Une carte autorisée est facturée une seule fois et apparaît sur la case prévue.
- La ferme produit pendant la manche où elle est posée et à chaque manche suivante.
- L’entretien en nourriture intervient après la production et consomme une unité par habitant.
- Une pénurie réduit la population de la quantité indiquée et ne la fait pas passer sous zéro.
- Les totaux de ressources de la troisième manche correspondent à la trace calculée à la main ci-dessus.
Pour chaque vérification, consignez le plateau, la main et les ressources de départ ; les actions exactes ; le résultat attendu ; le résultat observé ; ainsi que la version du build ou du prompt. Si aucune preuve n’existe encore, laissez le champ d’observation vide. Un document de conception terminé peut être prêt à l’implémentation sans qu’un jeu terminé ou jouable existe déjà.
Gardez les questions à venir visibles au lieu d’en deviner la réponse : comment le paquet est-il renouvelé ? Les bâtiments peuvent-ils être améliorés ou retirés ? Que se passe-t-il si le joueur ne peut pas payer une carte ? Qu’est-ce qui met fin au premier scénario ? Ce sont de bons sujets pour la prochaine étape de conception, mais ils ne sont pas nécessaires pour expliquer cette première boucle.
La page officielle de SEELE AI Game Maker décrit la création d’un jeu 2D ou 3D jouable à partir d’une instruction textuelle, le test d’une première version dans un navigateur et son amélioration avec des prompts de suivi. Il s’agit d’un contexte général sur le produit : cela ne confirme pas cette conception de city-builder à cartes et ne garantit pas que ces prompts préliminaires produiront les règles indiquées. Commencez par la page AI Game Maker lorsque vous serez prêt à développer votre propre concept.
FAQ
Que doit contenir un document de conception pour un city-builder à cartes ?
Définissez l’objectif du village, les règles du plateau et des routes, les champs des cartes, les coûts et la production de ressources, l’ordre des manches et une courte séquence de tours d’exemple. Séparez les questions ouvertes des règles établies.
Comment un modèle de carte prêt pour l’IA doit-il décrire un bâtiment ?
Attribuez à chaque carte un identifiant unique, une condition de placement, un coût, un effet, un moment de production, un entretien et toute condition de voisinage. Ces champs aident un outil de création à implémenter une fiche de carte cohérente.
Comment vérifier la boucle d’un city-builder avant de l’implémenter ?
Notez les ressources avant et après chaque manche, puis appliquez la production et l’entretien dans un ordre fixe. Un exemple calculé à la main peut révéler un déficit ou un coût qui bloque l’action suivante prévue.
Le premier document de conception doit-il inclure toutes les cartes ?
Non. Une petite main de départ aux rôles distincts — logement, nourriture et revenus — suffit à tester la boucle principale. Élargissez le paquet une fois les règles du premier jalon clarifiées.
Ce modèle ou cet exemple de village a-t-il été testé dans un jeu jouable ?
Non. Le modèle et la séquence du village sont des éléments fictifs de planification. Les prompts sont des brouillons non exécutés ; aucun jeu jouable ni résultat de test n’est fourni.


