Añadir una habilidad a un metroidvania existente puede provocar, sin que se note enseguida, fallos que van más allá de una puerta cerrada. Puede alterar las rutas opcionales, el regreso a los puntos de control, el acceso a los jefes y el estado del mundo que espera encontrar una partida antigua. Empieza por identificar el estado de la progresión y sus dependencias. Después, introduce un cambio persistente y acotado en el sistema que ya gestiona ese estado y prueba las rutas afectadas.

Esta guía va dirigida a quienes quieren ampliar un proyecto existente. Glassroot, el mundo del ejemplo, es inventado. Usa el mapa, los indicadores guardados y los casos de prueba que aparecen a continuación como herramientas de planificación y adáptalos a tu arquitectura.
Define qué significa «progresión persistente»
Antes de añadir un campo al guardado, identifica qué cambio debe seguir siendo visible para el jugador tras cambiar de sala, cargar un punto de control o reiniciar el juego por completo. Un impulso rápido desbloqueado puede seguir disponible. Una puerta de piedra abierta con esa habilidad puede quedarse abierta. Un interruptor temporal, el estado de alerta de un enemigo o una bonificación de combate pueden volver a su estado inicial al recargar la sala. Esas decisiones corresponden al diseño del juego y son independientes del serializador.
| Tipo de estado | Ejemplo | Qué decidir |
|---|---|---|
| Habilidad | Impulso rápido, agarre a paredes, salto doble | ¿Se consigue de forma permanente, se concede temporalmente o se pierde en algún modo de juego? |
| Cambio en el mundo | Puerta de un solo sentido abierta | ¿Se conserva en todo el mundo, por región o solo hasta salir de la zona? |
| Estado de la sala | Palanca accionada, enemigo derrotado | ¿Debe restaurarse ese estado al volver a la sala? |
| Efecto transitorio | Destello al recibir daño, mejora temporal | ¿Hay algún caso en el que deba incluirse en el archivo de guardado? |
En el ejemplo ficticio de Glassroot, el explorador consigue un impulso rápido permanente, abre una puerta de piedra con nombre propio y puede seguir un recorrido corto que lo devuelve a la zona central. Un enemigo cercano reaparece después de que el explorador se marche. Son reglas ilustrativas cuyo comportamiento no se ha comprobado. Las reglas de reinicio de tu juego pueden ser distintas. Anótalas antes de modificar el código.
Relaciona las habilidades con las barreras y las rutas
Una habilidad resulta útil cuando cumple una función en el mapa. Enumera las barreras que dependen de ella, las salas accesibles antes y después de conseguirla y el camino de vuelta a una zona central o un punto de control. Incluye los desvíos opcionales y las caídas sin retorno. Un mapa de dependencias ayuda a detectar un error habitual de diseño: un indicador nuevo abre la puerta prevista, pero deja al jugador atrapado en el lado equivocado de la ruta de vuelta.

| Dependencia | Antes de conseguir la habilidad | Después de conseguir la habilidad | Qué comprobar |
|---|---|---|---|
| Barrera agrietada | Se ve, pero no se puede atravesar | El impulso rápido la rompe o permite atravesarla | ¿Puede el jugador volver al punto de control? |
| Saliente elevado | La ruta sigue siendo opcional | La habilidad abre un atajo | ¿Permite el atajo saltarse un tutorial obligatorio? |
| Sello de acceso al jefe | El camino hacia el jefe sigue cerrado | Un indicador del mundo permite el acceso | ¿Puede cargarse una partida en la que el sello y el jefe tengan estados incoherentes entre sí? |
Mantén la tabla al día con el mapa real. Si se puede llegar a una ruta saltándose el orden previsto, decide si vas a admitirlo, bloquearlo o simplemente incluirlo en las pruebas. Antes de «arreglar» una ruta inesperada con un bloqueo global, analiza el recorrido del jugador y cuánta libertad quieres darle en el juego.
Centraliza el estado de la progresión en un solo sistema
Revisa cómo gestiona el proyecto las habilidades, las barreras, la recarga de salas, los puntos de control y el guardado. Localiza el sistema que ya gestiona el inventario o los indicadores del mundo. Siempre que puedas, amplía ese sistema para evitar duplicar la gestión de la progresión. Dos copias independientes del estado «impulso rápido adquirido» pueden discrepar: el HUD muestra la habilidad mientras la lógica de la puerta sigue leyendo un valor desactualizado.
Usa identificadores estables para los cambios duraderos, como gate_moss_archive_open. Los nombres de sala que se muestran al jugador pueden cambiar. Define un valor predeterminado para las partidas guardadas antes de que existiera el nuevo campo. Si una partida carece del indicador de la puerta, ¿debe esta permanecer cerrada, tomar su estado de un indicador del jefe o seguir una regla de migración que se aplique una sola vez? Decide qué comportamiento quieres y documéntalo.
La documentación de la versión estable de Godot describe user:// como la ubicación donde se pueden escribir los datos de usuario y ofrece ejemplos de guardado en archivos. Su tutorial de guardado también muestra cómo identificar objetos persistentes y serializar los datos pertinentes. Esas referencias cubren el almacenamiento y la serialización y no recomiendan un esquema específico para metroidvanias. Confirma qué versión del motor usas y conserva la arquitectura de guardado del proyecto siempre que sea viable.
Siempre que puedas, guarda una representación más compacta que el árbol de escenas. Los identificadores estables de las habilidades y los indicadores del mundo pueden bastar para reconstruir el aspecto de las salas. Guardar todos los nodos indiscriminadamente puede dificultar la refactorización de las escenas. Si el juego ya serializa objetos, respeta sus convenciones y añade solo los valores necesarios para reconstruir el estado correctamente.
Pide a la IA un cambio acotado
La IA puede ayudarte a examinar un proyecto o a evaluar un parche propuesto. Especifica en la petición qué debe mantenerse. Por ejemplo:
Revisa cómo funcionan actualmente la progresión y el guardado antes de editar. No cambies el movimiento del jugador, la topología de las salas, el orden de los jefes, el comportamiento de los puntos de control ni los identificadores de las habilidades existentes. Propón el cambio más pequeño que permita conservar una nueva habilidad y el estado de la barrera que depende de ella mediante el sistema que ya gestiona ese estado. Primero enumera los archivos y los supuestos de la migración. Después, presenta un plan de cambios reversible, las rutas afectadas y las pruebas para partidas nuevas, existentes y antiguas. Solo afirma que el juego ha superado las pruebas si se han ejecutado en este proyecto.
Revisa el diff para detectar sistemas duplicados que gestionen el mismo estado, textos de la interfaz usados como claves de guardado, supuestos sobre partidas antiguas y cambios en las transiciones entre salas. Pide un resumen por archivo y un procedimiento claro para revertir los cambios. Si la herramienta solo ha generado un concepto o una sugerencia de código, eso no demuestra que se haya integrado el cambio en el juego ni que se haya probado.
El catálogo de SEELE presenta la creación de juegos a partir de una idea escrita y menciona categorías jugables como RPG, runners, shooters y roguelikes. Puedes usarlo para explorar un concepto jugable independiente o comunicar una idea de progresión. El catálogo no confirma que SEELE pueda editar un repositorio existente o migrar partidas guardadas. Usa el flujo de trabajo de tu proyecto para esos cambios.
Conserva las partidas antiguas y define la migración
Prueba la migración con una copia de la partida guardada y conserva siempre el original. Enumera qué campos nuevos faltan en ese archivo y qué valores predeterminados aplica el juego. Comprueba que el jugador conserva las habilidades que ya había conseguido, que ninguna puerta vuelve inesperadamente a su estado inicial y que los indicadores antiguos de progreso siguen siendo coherentes. Si el diseño de la progresión cambia de forma sustancial, asigna una versión al esquema de guardado y especifica cómo se realiza la migración.
En la nota de migración, indica la versión anterior y la nueva del esquema, los campos añadidos o renombrados, los valores alternativos y qué ocurre si falla la lectura de los datos. Ajusta el comportamiento de recuperación al diseño del juego. Una ficha de guardado simulada puede explicar estas reglas. Para demostrar la compatibilidad, hace falta cargar una partida en la compilación de destino.
Prueba un recorrido completo antes de ampliar el sistema
Implementa una habilidad, una barrera que dependa de ella y un camino de vuelta. Prueba el recorrido completo antes de aplicar el mismo patrón a todas las regiones. Registra la compilación, la versión del guardado, la sala, los pasos y los estados esperado y observado. Si una comprobación falla, localiza si la discrepancia se produce al adquirir la habilidad, al serializar el estado, al reconstruirlo durante la carga, al entrar en la sala o al mostrar el resultado al jugador.
| Caso de prueba | Acción | Qué observar |
|---|---|---|
| Partida nueva | Empieza sin la habilidad | La barrera está cerrada y se puede acceder a la ruta inicial prevista |
| Adquisición | Consigue la habilidad y atraviesa la barrera correspondiente | La habilidad y el indicador del mundo se actualizan una sola vez |
| Regreso | Sal y completa el camino de vuelta | La barrera, el punto de control y el mapa muestran un estado coherente |
| Recarga | Guarda, sal del juego y vuelve a cargar la partida | Se restauran la habilidad y el estado persistente de la barrera |
| Partida antigua | Carga una copia guardada antes del cambio | Los valores predeterminados o la migración conservan una ruta jugable |
| Reinicio | Usa la acción de reinicio prevista en el proyecto | Los valores persistentes y transitorios siguen las reglas documentadas |
La imagen ficticia del punto de control que aparece a continuación ilustra cómo se conserva la habilidad y cómo la ruta sigue abierta. No procede de una partida en ejecución.

Preguntas frecuentes
¿Qué debe persistir en el sistema de progresión de un metroidvania?
Guarda solo el estado que el diseño requiera conservar al salir de una sala o reiniciar el juego: las habilidades adquiridas, las puertas de un solo sentido que se hayan abierto, el resultado de los combates contra jefes y los cambios duraderos en el mundo. Mantén aparte los efectos temporales de combate y las interacciones de sala que no se guardan. Adapta los campos al sistema que ya gestiona el estado del juego y a sus reglas de reinicio.
¿Cómo añado una habilidad sin romper las rutas existentes?
Identifica todas las barreras que dependen de la habilidad y confirma que se puede acceder al menos a una de las rutas previstas antes de conseguirla. Comprueba los caminos de vuelta, los puntos de control, los saltos en el orden de progresión y las salas opcionales. Usa el mapa para revisar el diseño y luego valida cada ruta en la compilación real.
¿Deben seguir abiertas las puertas tras cargar una partida?
Si la puerta representa un cambio permanente en el mundo, guarda un identificador estable de la puerta o un indicador del mundo y reconstruye la sala a partir de ese estado al cargar. Si la puerta solo depende de un interruptor temporal, conserva su estado en el de la sala. Decide según el recorrido previsto y explica a los jugadores cuándo se restablece el estado.
¿Dónde guarda Godot los datos persistentes del juego?
La documentación de la versión estable de Godot describe user:// como la ubicación donde se pueden escribir los datos de usuario y muestra ejemplos de guardado en archivos. Confirma la plataforma de destino y la versión del motor que usas. Después, utiliza el sistema de guardado existente del proyecto siempre que puedas. Qué estado debe persistir es una decisión de diseño que la documentación deja abierta.
¿Cómo puedo probar una nueva capa de progresión de forma segura?
Usa una copia de la partida guardada y prueba el inicio de una partida nueva, la adquisición de la habilidad, la barrera que depende de ella, el camino de vuelta, la recarga del punto de control y la carga de una partida antigua. Registra la compilación, la versión del guardado, la sala y el resultado esperado. Un mapa ficticio o una maqueta de la interfaz sirven para explicar el plan de pruebas. Para demostrar que una compilación real las supera, hay que ejecutarlas en ella.
Amplía el sistema cuando funcione el recorrido completo
Relaciona cada habilidad persistente y cada cambio duradero del mundo con sus barreras, sus caminos de vuelta, sus reglas de reinicio y el sistema responsable de guardar su estado. Implementa un recorrido completo y comprueba la adquisición de la habilidad, el regreso, la recarga y el comportamiento de las partidas antiguas antes de repetir el patrón por todo el mapa. Así se mantiene clara la progresión del juego existente y se reducen los riesgos al ampliarlo.
Si quieres esbozar una idea jugable independiente en torno a este recorrido de progresión, prueba SEELE AI Game Maker. Sirve para desarrollar conceptos. La migración de proyectos existentes queda fuera de su alcance.


