Dans un roguelike de gestion d’inventaire, une boutique entre les manches peut donner lieu à de vrais arbitrages, mais elle touche à la fois à la phase de jeu, à la monnaie, au stock d’objets, à leur placement dans le sac et aux synergies de voisinage. Confiez la transition au gestionnaire de partie existant, utilisez le système actuel de validation du placement pour chaque achat et regroupez le paiement et le placement de l’objet dans une seule transaction. Testez le rechargement des sauvegardes et le cas du sac plein avant d’élargir le système d’offres.

Ce guide propose d’ajouter une boutique à un roguelike de gestion d’inventaire existant. Le marchand, les objets, les prix, le sac, les synergies et les résultats sont fictifs. Aucun code source, projet, build, fichier de sauvegarde ni test en jeu n’était disponible. Les vérifications ci-dessous constituent un plan de test. L’équilibrage et le comportement du jeu restent à vérifier.
Cartographier les transitions de la partie et les règles d’inventaire
Suivez le déroulement après la fin d’une rencontre. Les récompenses sont attribuées, la partie change de phase, le résultat s’affiche pour le joueur et la salle suivante se charge. Repérez le système qui pilote cette transition et vérifiez si le jeu comporte déjà un campement, un coffre de récompenses ou un menu de préparation. Conservez une sauvegarde de référence en fin de manche, avec un sac partiellement rempli et un solde connu.
Documentez le fonctionnement du sac avant de constituer le stock. Notez les dimensions des cases, l’emprise des objets sur la grille, les règles de rotation et d’empilement, les cases bloquées, les effets de voisinage, les emplacements d’équipement et le comportement lorsque le sac est plein. Déterminez si les synergies sont recalculées dès qu’un objet est placé ou seulement au passage d’une manche à l’autre. La boutique doit appeler la logique de placement existante pour appliquer les mêmes règles que le reste du jeu.
| Système | Fonctionnement de référence à relever | À préserver |
|---|---|---|
| Phase de jeu | Fin de la rencontre, attribution des récompenses, manche suivante | Un seul système pilote la transition |
| Sac | Grille, emprise des objets, rotation, règles d’empilement | Système existant de validation du placement |
| Synergies | Effets de voisinage et des tags d’objets | Moment actuel du recalcul |
| Monnaie | Récompense, achat, renouvellement de l’offre, remboursement | Un seul registre des transactions pour la partie |
| Aléatoire | Graine de la partie et génération des offres | Règles déterministes existantes |
Définir quand la boutique ouvre et ferme
Définissez un enchaînement clair. La rencontre se termine, les récompenses sont définitivement attribuées, la boutique ouvre, les achats sont finalisés, le joueur confirme son départ, puis la rencontre suivante commence. Précisez si le joueur peut revenir à la boutique ou retourner dans une salle précédente. S’il peut passer la boutique, prévoyez une transition directe. Bloquez les commandes de combat et l’attribution des récompenses de rencontre tant que la boutique est ouverte.
Dans la partie fictive de Packlight Delver, un marchand apparaît toutes les deux rencontres. Le joueur peut acheter une relique ou repartir. Il peut aussi payer pour remplacer l’offre affichée. Ce scénario sert d’exemple et n’a pas été implémenté. Dans un jeu réel, choisissez une fréquence adaptée à la durée des parties et à l’économie en place avant de décider s’il faut ouvrir une boutique après chaque salle.
Utilisez des identifiants stables pour la partie et pour chaque visite en boutique. Si le joueur recharge sa sauvegarde alors que la même visite est en cours, affichez le même stock et le même solde, sauf si le jeu facture explicitement un renouvellement de l’offre. Enregistrez le résultat d’un achat une seule fois avant de poursuivre la partie. La réouverture d’un écran ou le rechargement d’une scène ne doit pas régénérer la boutique.

Valider chaque achat en une seule transaction
Avant de débiter le joueur, affichez l’emprise de l’objet dans le sac tel qu’il est et appliquez la vérification de placement existante. Indiquez si l’objet tient dans l’orientation choisie, quelles cases il occupe et s’il modifie des effets de voisinage. Si aucun placement n’est valide, laissez l’achat désactivé ou proposez d’appliquer la règle existante pour jeter ou échanger un objet. Attendez que le joueur choisisse un emplacement avant de le débiter, sauf s’il a confirmé une transaction réversible.
À la validation de l’achat, débitez le solde et ajoutez l’objet à l’inventaire de la partie en passant par les systèmes qui les gèrent déjà. Utilisez un identifiant de transaction stable pour éviter un double débit en cas de rechargement ou de clic répété. Si l’une des étapes échoue, rétablissez le solde et l’inventaire d’origine. Testez les cas limites, comme la dépense de la dernière pièce, une pile déjà pleine, une rotation après l’aperçu ou deux objets qui se disputent les mêmes cases.
Définissez comment la boutique traite les objets que le joueur possède déjà. Si les doublons s’empilent, appliquez la règle d’empilement actuelle. Si un objet unique est déjà équipé, interdisez l’ajout d’un second exemplaire ou précisez comment il se comporte. Si le joueur vend ou échange un objet, faites traiter l’opération par les systèmes d’inventaire et d’économie existants. La boutique doit utiliser directement le sac et le portefeuille existants.
Rendre les synergies compréhensibles
Indiquez quels tags d’objets déclenchent une synergie et quels objets voisins sont pris en compte. Si l’ajout d’une relique modifie les dégâts, la défense, le déplacement ou les gains de ressources, affichez la différence à l’aide du calcul de statistiques existant. Si le jeu se fonde sur des tags cachés ou tient compte de la position relative des objets adjacents, le nom d’un objet ne suffit pas à garantir un bonus. Indiquez à quel moment la synergie est recalculée et si elle persiste après le déplacement de l’objet.
Vérifiez que les objets de la boutique ne rendent pas une seule configuration incontournable. Un objet doté d’un puissant effet de voisinage peut être équilibré par sa taille, son prix, un stock limité ou le coût d’opportunité de son achat. Mesurez l’impact de ces paramètres. Pendant les essais de la boutique, conservez la difficulté actuelle, l’ordre des rencontres et le rythme d’attribution des récompenses. Les exemples fictifs de ce guide ne permettent pas d’affirmer qu’un objet est équilibré.
| Règle de l’offre | Décision | Test |
|---|---|---|
| Stock | Fixe, généré à partir d’une graine ou renouvelable ? | Même graine et même phase après rechargement |
| Prix | Fixe ou évolutif au cours de la partie ? | Solde faible et solde élevé |
| Placement | L’objet doit-il tenir dans le sac avant l’achat ? | Sac plein et objet pivoté |
| Synergie | Quels tags et quels voisins comptent ? | Déplacer un objet pour créer puis rompre le voisinage |
| Doublon | Empiler, équiper ou refuser ? | Objet déjà possédé et objet unique |
Préserver le fonctionnement de l’aléatoire et la compatibilité des sauvegardes
Si le stock est généré de manière procédurale, passez par le système qui gère déjà la graine aléatoire de la partie. Déterminez si la graine fixe tout le stock à venir ou si elle s’applique à chaque visite. Conservez la même offre pour une visite donnée après rechargement. Si le renouvellement est payant, demandez au gestionnaire de partie existant d’incrémenter un compteur ou d’enregistrer le nouvel état du stock, et ne débitez le joueur qu’une fois.
Enregistrez l’état de la boutique séparément des éléments débloqués de façon permanente. Si le jeu sauvegarde déjà les parties en cours, ajoutez uniquement les champs indispensables, à savoir l’identifiant de la partie, l’identifiant de la visite, un instantané du stock ou l’état de la graine, le résultat de l’achat et l’état du renouvellement de l’offre. Prévoyez un comportement sûr pour les anciennes sauvegardes, par exemple en attendant la prochaine transition normale pour activer la boutique. Ne modifiez pas le contenu du sac du joueur pour qu’une offre nouvellement générée puisse y tenir.
Si le projet utilise Godot, la documentation de Resource décrit des conteneurs de données sérialisables qui peuvent être enregistrés sur disque. Cet exemple est propre à ce moteur et laisse le choix du modèle de boutique. Le tutoriel de Godot sur les sauvegardes présente une méthode dans laquelle les objets persistants fournissent les données nécessaires à la sérialisation et au chargement. Aucune de ces deux sources n’établit comment le jeu cible gère ses graines ni quelles règles il applique aux transactions portant sur les objets.
Demander à l’IA une première version de la boutique au périmètre limité
Fournissez une liste des éléments sur lesquels l’IA est autorisée à intervenir, couvrant les phases de jeu, la génération des offres, la monnaie, la validation du placement dans le sac, les tags d’objets et les sauvegardes des parties en cours. Demandez à l’assistant de repérer quel système est déjà responsable de chaque élément avant de modifier le code. Commencez par une offre de test fixe et un seul parcours d’achat. Ajoutez un stock généré à partir d’une graine une fois la transition de phase opérationnelle. Exigez que les modifications préservent le combat, la génération des rencontres et le calcul actuel des synergies.
Gardez une branche de travail propre et des copies de sauvegardes avec un sac vide, partiellement rempli ou plein. Examinez chaque fichier modifié, surtout le code de paiement et de placement des objets. Gardez la possibilité de revenir à une version qui retire la phase de boutique tout en conservant le fonctionnement antérieur des récompenses entre les salles. Si les anciennes sauvegardes doivent être migrées, testez la migration sur des copies et consignez le comportement par défaut.
Tester le rechargement, la capacité du sac et les synergies
Testez un achat valide, un solde insuffisant, un sac plein, le placement d’un objet pivoté, les doublons en stock, le renouvellement payant de l’offre, la sortie sans achat, le rechargement en boutique, la défaite après un achat et le début de la manche suivante. Répétez les essais avec la même graine de partie et comparez les offres. Vérifiez que l’objet acheté reste dans le sac, que le solde ne change qu’une fois et que les effets de synergie correspondent aux règles actuelles.

| Vérification proposée | Action | Élément à vérifier |
|---|---|---|
| Placement valide | Prévisualiser puis acheter un objet qui tient dans le sac | Occupation des cases et une seule modification du solde |
| Sac plein | Tenter un achat sans emplacement valide | Refus explicite et solde inchangé |
| Synergie | Placer, déplacer et retirer des objets adjacents | Effets calculés selon les règles actuelles |
| Renouvellement de l’offre | Payer, recharger la sauvegarde et examiner l’offre | Un seul débit et stabilité du nouveau stock |
| Même graine | Relancer une partie de test reproductible | Suite d’offres attendue en boutique |
| Défaite | Perdre après un achat | Sort de l’objet et traitement de la fin de partie |
| Ancienne sauvegarde | Charger une copie de sauvegarde d’une partie en cours datant d’avant l’ajout de la boutique | Sac et état de la partie préservés |
| Retour en arrière | Restaurer la version de référence | Fonctionnement existant entre les manches |
Ce plan décrit des tests à effectuer. Consignez la version du build, la graine de la partie, l’identifiant de la visite, les identifiants des offres, la disposition du sac avant et après, la variation du solde, les effets de synergie calculés, la transition entre les manches et les écarts entre le comportement attendu et celui observé. Un schéma de sac généré ne suffit pas à prouver que la boutique est équitable ou déterministe.
Faciliter la comparaison des options en boutique
Affichez la taille de l’objet, son prix, ses tags, ses effets de voisinage et le caractère unique ou non de l’offre. Laissez le joueur prévisualiser le placement avant de confirmer. Indiquez le coût d’un renouvellement et précisez si le stock est conservé. Gardez l’option de sortie visible et permettez au joueur de vérifier la place disponible dans son sac sans fermer l’offre. La boutique doit enrichir les choix du joueur sans alourdir chaque manche avec des formalités.
Pour explorer un autre concept de roguelike de gestion d’inventaire, essayez SEELE AI Game Maker. Cet outil sert à explorer des concepts et ne permet pas d’éditer un projet existant.
Questions fréquentes
Quand ouvrir une boutique entre les manches d’un roguelike ?
Utilisez une transition explicite déjà pilotée par le gestionnaire de partie, par exemple entre la fin d’une rencontre et le chargement de la suivante. Précisez si le joueur peut quitter la boutique, y revenir ou renouveler l’offre, puis validez le passage à cette phase une seule fois. Attendez la fin du combat et de l’attribution des récompenses avant d’ouvrir la boutique.
Comment respecter les règles de placement de l’inventaire lors d’un achat en boutique ?
Soumettez chaque achat au système existant de validation du placement dans le sac. Avant tout débit, vérifiez l’emprise de l’objet, sa rotation, les cases bloquées, les limites d’empilement et les synergies de voisinage entre objets. Affichez d’abord un aperçu du placement et de ses effets. Si aucun emplacement n’est valide, laissez l’objet et le solde du joueur en l’état.
Le stock de la boutique doit-il être aléatoire à chaque partie ?
Appuyez-vous sur le système qui gère déjà la graine aléatoire, puis décidez si le stock est généré par partie, par manche ou par visite. Enregistrez suffisamment d’informations pour qu’un rechargement ne permette pas d’obtenir une meilleure offre. Le renouvellement doit alors résulter d’une action volontaire et payante. Testez plusieurs rechargements de sauvegarde avec la même graine et la même phase de boutique.
Que devient le stock de la boutique après le départ du joueur ?
Déterminez si les objets invendus disparaissent, restent disponibles jusqu’à la manche suivante ou peuvent être retrouvés lors d’une nouvelle visite. Conservez les objets achetés dans l’inventaire du joueur et passez par le système économique existant pour mettre à jour le solde. Testez la sortie de la boutique, le retour, la défaite et le chargement d’une sauvegarde effectuée après l’achat, mais avant la rencontre suivante.
L’IA peut-elle ajouter une boutique entre les manches à mon roguelike de gestion d’inventaire ?
L’IA peut examiner le gestionnaire de partie, le système de validation du placement dans le sac, les règles de synergie entre objets, la gestion de la monnaie et le fonctionnement des sauvegardes. Elle peut ensuite proposer une phase de boutique au périmètre défini et rédiger des tests. Vérifier l’équilibrage des objets ou le déterminisme des parties exige d’avoir accès au projet lui-même. Fournissez une liste des éléments modifiables, des exemples de graines, des inventaires de référence et une révision à restaurer en cas de retour en arrière.
Ajouter des offres tout en préservant le fonctionnement du sac
Confiez les horaires d’ouverture de la boutique au gestionnaire de partie, le placement des objets au système de validation existant et la monnaie au système économique actuel. Prévisualisez les achats, ne validez chacun qu’une fois et conservez les mêmes offres générées à partir d’une graine après rechargement. Testez la capacité du sac, la rotation, les synergies, la défaite et les anciennes sauvegardes avant d’étoffer le catalogue. Packlight Delver et la maquette sont des supports fictifs de planification. Ils ne démontrent ni le bon fonctionnement ni l’équité de la boutique.


