Ajouter une nouvelle couche de progression sans casser la carte

Planifiez une couche de progression persistante pour un metroidvania existant. Recensez les capacités, les passages verrouillés, l’état sauvegardé et les tests de non-régression à mener sans risque avant d’étendre le projet.

Seele Editorial TeamMis à jour 16 novembre 2026

Ajouter une capacité à un metroidvania existant peut perturber le fonctionnement de plusieurs portes verrouillées sans que cela se voie tout de suite. Elle peut aussi modifier les itinéraires facultatifs, les retours aux points de contrôle, l’accès aux boss et l’état du monde attendu par une ancienne sauvegarde. Commencez par cartographier l’état de progression et ses dépendances. Passez ensuite par le système qui gère déjà cet état pour introduire un seul changement persistant, de portée limitée, puis testez les itinéraires concernés.

Dans un metroidvania fictif, un petit explorateur masqué atteint une porte couverte de mousse qui vient de s’ouvrir après l’obtention d’une capacité de déplacement.
Glassroot est un exemple pédagogique fictif. Aucun projet de jeu ni aucune version exécutable n’ont été testés.

Ce guide s’adresse aux développeurs qui souhaitent étendre un projet existant sans repartir de zéro. Glassroot, le monde pris en exemple, est fictif. Servez-vous de la carte, des indicateurs sauvegardés et des cas de test ci-dessous pour planifier des changements adaptés à votre architecture.

Définir ce que signifie « progression persistante »

Avant d’ajouter un champ de sauvegarde, précisez quel changement perceptible par le joueur doit subsister après un changement de salle, un rechargement au point de contrôle ou un redémarrage complet. Une ruée acquise peut rester disponible. Une porte de pierre ouverte grâce à cette capacité peut rester ouverte. Un interrupteur temporaire, l’état d’alerte d’un ennemi ou un bonus de combat peuvent être réinitialisés au rechargement de la salle. Ces décisions relèvent de la conception du jeu, et non du mécanisme de sérialisation.

Type d’étatExempleDécision à prendre
CapacitéRuée, accrochage aux parois, double sautEst-elle acquise définitivement, accordée temporairement ou réinitialisée dans un mode de jeu ?
Modification du mondePassage à sens unique ouvertL’ouverture est-elle conservée à l’échelle du monde, de la région ou seulement jusqu’au départ du joueur ?
État de la salleLevier actionné, ennemi vaincuLa salle doit-elle retrouver cet état au retour du joueur ?
Effet temporaireFlash signalant des dégâts, bonus temporaireFaut-il un jour l’enregistrer dans le fichier de sauvegarde ?

Dans l’exemple fictif de Glassroot, l’explorateur acquiert définitivement une ruée, ouvre une porte de pierre qui porte un nom et peut emprunter une courte boucle pour revenir au carrefour central. Un ennemi à proximité réapparaît après son départ. Ces règles sont données à titre d’exemple et leur comportement n’a pas été testé. Vos propres règles de réinitialisation peuvent différer. Consignez-les avant de modifier le code.

Cartographier les passages et itinéraires liés aux capacités

Une capacité devient utile lorsque la carte lui donne un rôle. Pour chaque capacité, répertoriez les passages qui en dépendent, les salles accessibles avant et après son acquisition et le chemin de retour vers un carrefour ou un point de contrôle. Incluez les embranchements facultatifs et les chutes sans retour possible. Une carte des dépendances permet de repérer une erreur de conception courante. Un nouvel indicateur ouvre bien la porte prévue, mais laisse le joueur du mauvais côté du chemin de retour.

Une carte de metroidvania fictif relie la capacité de ruée à une barrière fissurée et à un chemin de retour vers le carrefour central.
Représentez ensemble la dépendance et le chemin de retour pour évaluer chaque passage dans son contexte.
Élément de la carteAvant l’acquisitionAprès l’acquisitionRégression à vérifier
Barrière fissuréeVisible mais infranchissableLa ruée permet de la briser ou de la franchirLe joueur peut-il revenir au point de contrôle ?
Rebord en hauteurL’itinéraire reste facultatifLa capacité ouvre un raccourciLe raccourci permet-il de contourner un tutoriel obligatoire ?
Sceau bloquant l’accès au bossLe chemin vers le boss reste ferméUn indicateur de l’état du monde autorise l’accèsPeut-on charger une sauvegarde où l’état du sceau et celui du boss sont incohérents ?

Appuyez-vous sur la carte réelle pour remplir le tableau. Si le joueur peut atteindre un itinéraire en contournant l’ordre prévu de la progression, décidez s’il faut autoriser ce détour, le bloquer ou simplement le tester. Avant de « corriger » un itinéraire inattendu à l’aide d’un verrou global, comprenez le chemin emprunté par le joueur et la liberté que le jeu est censé lui laisser.

Confier l’état de progression à un seul système

Retracez la façon dont le projet gère déjà les capacités, les passages verrouillés, les rechargements de salle, les points de contrôle et les sauvegardes. Repérez le système qui gère l’inventaire ou les indicateurs de l’état du monde. Étendez-le dans la mesure du possible pour éviter de créer un second gestionnaire de progression. Deux copies indépendantes de l’indicateur « ruée acquise » peuvent diverger. L’interface affiche alors la capacité, tandis que la logique de la porte lit encore une valeur obsolète.

Pour les changements durables, utilisez des identifiants stables comme gate_moss_archive_open. Les noms de salles affichés à l’écran peuvent changer. Définissez une valeur par défaut pour les sauvegardes antérieures à l’ajout du champ. Si une sauvegarde ne contient aucun indicateur pour la porte, celle-ci doit-elle rester fermée, prendre un état déduit de l’indicateur du boss ou suivre une règle de migration appliquée une seule fois ? Choisissez la règle qui convient et documentez-la.

La documentation de la version stable de Godot présente user:// comme l’emplacement où le jeu peut écrire les données utilisateur et fournit des exemples de sauvegarde dans des fichiers. Son tutoriel sur les sauvegardes montre aussi comment identifier les objets persistants et sérialiser les données pertinentes. Ces références portent sur le stockage et la sérialisation et ne préconisent aucun schéma de sauvegarde pour un metroidvania. Vérifiez la version de votre moteur et conservez l’architecture de sauvegarde existante lorsque c’est possible.

Dans la mesure du possible, sauvegardez une représentation plus légère que l’arborescence de la scène. Des identifiants de capacité stables et des indicateurs de l’état du monde peuvent suffire à reconstituer l’apparence de la salle. Sauvegarder chaque nœud sans distinction peut compliquer le remaniement des scènes. Si le jeu sérialise déjà des objets, suivez ses conventions et ajoutez uniquement les valeurs nécessaires pour reconstituer correctement l’état.

Demander à l’IA une modification bien délimitée

L’IA peut aider à examiner un projet ou à évaluer un correctif envisagé. La demande doit préciser ce qui doit rester inchangé, comme dans cet exemple.

Examine le fonctionnement actuel de la progression et des sauvegardes avant toute modification. Ne modifie ni les déplacements du joueur, ni l’agencement des salles, ni l’ordre des boss, ni le comportement des points de contrôle, ni les identifiants des capacités existantes. Propose la plus petite modification qui permette de rendre persistants une nouvelle capacité et le passage qui en dépend, en passant par le système qui gère déjà cet état. Liste d’abord les fichiers et les hypothèses de migration. Présente ensuite un plan de modification réversible, les itinéraires concernés et les tests à effectuer sur des sauvegardes neuves, existantes et plus anciennes. N’affirme pas que le jeu a réussi les tests s’ils n’ont pas été exécutés dans ce projet.

Relisez le diff pour repérer les systèmes qui gèrent le même état en double, les textes d’affichage utilisés comme clés de sauvegarde, les hypothèses sur les anciennes sauvegardes et les changements apportés aux transitions entre salles. Demandez un résumé fichier par fichier et une procédure explicite de retour en arrière. Une idée ou une suggestion de code produite par l’outil ne prouve pas que la modification a été intégrée au jeu ou testée.

Le catalogue de SEELE présente la création de jeux à partir d’une idée écrite et la prise en charge de genres comme les RPG, les jeux de course de type runner, les jeux de tir et les roguelikes. SEELE peut donc servir à explorer un concept jouable à part ou à présenter une idée de progression. Le catalogue n’établit pas que SEELE puisse modifier un dépôt existant ou migrer des sauvegardes. Utilisez le processus de travail de votre projet pour ces changements.

Préserver les anciennes sauvegardes et définir la migration

Testez la migration sur une copie de la sauvegarde, jamais sur l’unique exemplaire. Recensez les nouveaux champs absents de ce fichier et les valeurs par défaut que le jeu applique. Vérifiez qu’une capacité acquise ne disparaît pas sans avertissement, qu’une porte ne se réinitialise pas de façon inattendue et que les anciens indicateurs d’achèvement gardent leur sens. Si la conception de la progression change sensiblement, attribuez des versions au schéma de sauvegarde et précisez le comportement de la migration.

Une note de migration utile indique l’ancienne et la nouvelle version du schéma, les champs ajoutés ou renommés, les valeurs de repli et le comportement prévu si l’analyse du fichier échoue. Alignez le comportement de récupération sur la conception actuelle du jeu. Une maquette d’écran de sauvegarde peut expliquer ces règles. Pour démontrer la compatibilité, il faut charger réellement la sauvegarde dans la version cible du jeu.

Valider une première mise en œuvre de bout en bout avant de l’étendre

Implémentez une capacité, un passage qui en dépend et un chemin de retour. Testez ensuite la boucle complète avant d’appliquer le même modèle à toutes les régions. Notez la version du jeu testée, la version de la sauvegarde, la salle, les étapes, l’état attendu et l’état observé. En cas d’échec, déterminez si l’écart survient lors de l’acquisition, de la sérialisation, de la reconstitution au chargement, de l’entrée dans la salle ou de l’affichage du retour visuel.

Cas de testActionRésultat à observer
Nouvelle sauvegardeCommencer sans la capacitéLe passage est fermé et l’itinéraire prévu en début de partie reste accessible
AcquisitionObtenir la capacité et franchir le passage associéLa capacité et l’indicateur de l’état du monde sont mis à jour une seule fois
Retour en arrièrePartir puis revenir par la boucleL’état du passage, celui du point de contrôle et la carte sont cohérents
RechargementSauvegarder, quitter, puis rechargerLa capacité et l’état persistant du passage sont restaurés
Ancienne sauvegardeCharger une copie antérieure au changementLes valeurs par défaut ou la migration préservent un itinéraire praticable
RéinitialisationUtiliser la commande de redémarrage prévue par le projetLes valeurs persistantes et temporaires suivent les règles documentées

L’image fictive du point de contrôle ci-dessous illustre une capacité toujours disponible et un passage ouvert. Elle ne provient pas d’un jeu en cours d’exécution.

L’explorateur fictif revient à un point de contrôle. La ruée est toujours disponible et la porte ouverte est visible au loin.
Cet état après rechargement est donné à titre d’illustration. Vérifiez la persistance dans la version exécutable du jeu.

Questions fréquentes

Quels éléments de progression doivent persister dans un metroidvania ?

Conservez uniquement les éléments dont le jeu a besoin après la sortie d’une salle ou un redémarrage, comme les capacités acquises, l’ouverture des passages à sens unique, l’issue des combats de boss et les changements durables du monde. Gérez séparément les effets de combat temporaires et les interactions de salle non sauvegardées. Adaptez les champs au système qui gère déjà l’état du jeu et à ses règles de réinitialisation.

Comment ajouter une capacité sans perturber les itinéraires existants ?

Cartographiez tous les passages qui dépendent de la capacité et vérifiez qu’au moins un itinéraire prévu reste accessible avant son acquisition. Vérifiez les chemins de retour, les points de contrôle, les possibilités de contourner l’ordre prévu de la progression et les salles facultatives. Servez-vous de la carte pour passer en revue les itinéraires, puis validez chacun d’eux dans la version exécutable du jeu.

Les passages ouverts doivent-ils le rester après le chargement d’une sauvegarde ?

Si l’ouverture du passage représente un changement permanent du monde, enregistrez un identifiant stable pour ce passage ou un indicateur de l’état du monde, puis reconstituez la salle à partir de cet état au chargement. Si elle dépend simplement d’un interrupteur temporaire, conservez-la dans l’état de la salle. Faites votre choix en fonction de l’itinéraire prévu et indiquez aux joueurs ce qui se réinitialise.

Où Godot stocke-t-il les données de jeu persistantes ?

La documentation de la version stable de Godot présente user:// comme l’emplacement où le jeu peut écrire les données utilisateur et donne des exemples de sauvegarde dans des fichiers. Vérifiez la plateforme cible et la version du moteur utilisée, puis appuyez-vous sur le système de sauvegarde existant lorsque c’est possible. La documentation ne détermine pas quels éléments de l’état du jeu doivent persister.

Comment tester une nouvelle couche de progression sans risque ?

Utilisez une copie de la sauvegarde et testez le démarrage d’une nouvelle partie, l’acquisition de la capacité, le passage qui en dépend, le retour en arrière, le rechargement au point de contrôle et le chargement d’une ancienne sauvegarde. Notez la version du jeu testée, la version de la sauvegarde, la salle et le résultat attendu. Une carte fictive ou une maquette d’interface peut expliquer le plan de test, mais ne prouve pas qu’une version exécutable du jeu a réussi les tests.

Attendre que la boucle fonctionne avant d’étendre la progression

Pour chaque capacité et chaque changement durable du monde, recensez les passages concernés, les chemins de retour, les règles de réinitialisation et le système responsable de la sauvegarde. Mettez en œuvre un premier cas de bout en bout, puis vérifiez l’acquisition, le retour en arrière, le rechargement et le comportement des anciennes sauvegardes avant de reproduire le modèle ailleurs sur la carte. Vous garderez ainsi la progression du jeu existant facile à comprendre et disposerez d’une base plus sûre pour l’étendre.

Si vous souhaitez esquisser un concept jouable à part autour de cette boucle de progression, essayez SEELE AI Game Maker. Cet outil sert à créer des concepts et ne permet pas de migrer un projet existant.

Sources

SEELE AI

Transformez ce guide en projet jouable.

Commencez par un brief précis, puis développez votre idée dans Seele AI Workspace.

Commencer à créer