Si un puzle cambia la historia, ese cambio debería seguir presente cuando el jugador vuelva. Eso no implica guardar cada pulsación. En un juego de narrativa ramificada, la resolución persistente de un puzle, el intento temporal y la consecuencia narrativa son tres estados distintos. Mantenerlos separados ayuda a integrar un cambio hecho con IA en la lógica de diálogos y finales que ya tiene el juego.

El cuaderno del faro que aparece a continuación es un ejemplo didáctico inventado. No describe ningún proyecto real, ninguna prueba ni ningún estudio con jugadores. Úsalo para planificar el cambio y comprueba después el comportamiento en el proyecto real antes de afirmar nada sobre la implementación.
Distingue entre la resolución del puzle, el intento y la consecuencia narrativa
Empieza por enumerar los datos que registra el juego. Un puzle puede tener un ID definido en el contenido, un estado de resolución, una recompensa, un nivel de pista, datos introducidos a medias y uno o varios indicadores narrativos. Señala qué valores se conservan al cambiar de escena, cuáles sobreviven a un reinicio y cuáles son temporales por diseño. Evita agrupar todos los datos del puzle en un único objeto de guardado solo porque aparecen en la misma pantalla.
| Estado | Ejemplo | Qué decidir |
|---|---|---|
| Definición del puzle | Orden de las pistas, regla de resolución, momento de la historia asociado | Contenido de diseño que se versiona con el proyecto |
| Resolución | ID estable del puzle del cuaderno una vez resuelto | Guárdala si debe conservarse cuando vuelva el jugador |
| Intento | Código incompleto, selección actual, pista activa | Decide expresamente si se reinicia o se reanuda |
| Consecuencia | Indicador de diálogo, ruta desbloqueada, requisito para un final | Usa el componente que ya gestiona el estado narrativo |
En el ejemplo, al resolver el puzle del cuaderno por primera vez, el juego registra su ID y activa el indicador narrativo existente que señala que se ha encontrado la pista. Si el personaje sale del despacho, la pista sigue constando como encontrada. Si el código del teclado se queda a medias, se borra al salir. Al volver a abrir el puzle, se puede volver a ver su presentación sin recibir la pista otra vez. Esta decisión evita recompensas duplicadas y condiciones incoherentes en las ramificaciones.
Sigue el recorrido de la historia antes de pedir cambios a la IA
Sigue el recorrido de un puzle existente desde el momento en que se activa la interacción hasta el siguiente diálogo o la siguiente ramificación. Identifica qué script o registro de datos determina si el puzle está resuelto, dónde guarda el juego los indicadores narrativos, cómo se recargan las escenas y cómo consulta el final esos indicadores. Haz una copia del proyecto y de una partida guardada de ejemplo antes de cambiar nada.
Pide a la IA que trace ese recorrido y proponga el parche más pequeño posible. Especifica qué debe conservarse tal cual: el orden de los diálogos, la disponibilidad de las opciones, los finales actuales, los controles del puzle y el funcionamiento de las pistas. Pídele que reutilice el indicador narrativo o el mecanismo de eventos existente y que indique qué archivos prevé modificar. Antes de aceptar un segundo sistema de «progreso de los puzles», comprueba cómo se mantendrá sincronizado con el estado narrativo que ya existe en el proyecto.
Usa identificadores estables en lugar del texto que se muestra en pantalla. «ledger_solution» puede seguir siendo la clave de guardado aunque el título del puzle cambie en una revisión o traducción posterior. Un ID estable también permite al sistema narrativo consultar si se ha resuelto un puzle sin buscar su título traducido.
Conecta el puzle con la historia mediante un único evento de resolución
Establece un punto de conexión claro entre la interacción y la actualización narrativa. Cuando la solución es válida, el puzle puede emitir un evento con su ID estable y la consecuencia prevista. El componente que gestiona el estado narrativo comprueba si el puzle con ese ID ya figura como resuelto, concede la pista o la recompensa una sola vez y actualiza el indicador existente de la ramificación. Así es más fácil revisar el flujo que si el teclado, la pantalla de diálogo, el diario y el final escriben cada uno su propia copia del mismo dato.
Un registro conceptual podría tener este aspecto:
{
"schema_version": 1,
"solved_puzzle_ids": ["lighthouse_ledger"],
"story_flags": {
"keeper_clue_found": true,
"north_stairs_open": false
}
}
Este esquema no se ha probado. Si el proyecto ya distingue los datos de diseño del estado en tiempo de ejecución, mantén separadas la definición del contenido y el progreso del jugador. Define qué hacer con los ID de puzles ausentes o retirados para que un cambio de nombre no borre silenciosamente todas las decisiones narrativas que dependen de ese puzle.

Elige dónde guardar los datos según la ruta admitida por el motor y la arquitectura que ya tiene el proyecto. La documentación de la versión estable de Godot recomienda user:// para los datos persistentes del usuario y muestra cómo guardar datos sencillos en JSON, con consideraciones sobre los tipos de datos y la codificación. Unity documenta Application.persistentDataPath para los datos que se conservan entre ejecuciones. La ubicación depende de la plataforma. Ninguna de las dos páginas dicta cómo modelar una historia ramificada: esa decisión corresponde a cada proyecto.
Define con claridad qué ocurre al repetir un puzle o reiniciar la partida
«Repetir el puzle» puede significar varias cosas. El jugador podría volver a la habitación, ver la animación de la pista, resolver de nuevo el puzle, restablecer el indicador narrativo o volver a conseguir la recompensa. Decide cuál de esas acciones quieres permitir. Como regla general, en un puzle narrativo es prudente que repetir la interacción no vuelva a aplicar una consecuencia única, salvo que el juego contemple expresamente resultados alternativos.
Define también qué abarca el reinicio. Reiniciar un capítulo puede borrar las pistas propias de ese capítulo y conservar las entradas permanentes del diario. Empezar la historia de cero puede borrar todo el progreso. Si el juego ya cuenta con Nueva partida+ o selección de capítulos, aplica las reglas de reinicio existentes en lugar de añadir una excepción exclusiva para los puzles.
Si la consecuencia de una decisión cambia ramificaciones posteriores, comprueba también esas ramificaciones, además del estado de resolución. Una entrada del diario puede indicar que se ha encontrado la pista mientras un final sigue consultando un indicador desactualizado. Contar con una única fuente para el estado narrativo y un solo evento de resolución facilita el diagnóstico.
Pide a la IA un cambio acotado y reversible
Una instrucción acotada podría pedir que se conserve el sistema de diálogos y finales, que solo se guarden los ID de los puzles resueltos y las consecuencias narrativas ya definidas, que se borren los datos introducidos a medias cuando se cierre la escena y que nunca se conceda la pista dos veces. Pide también que se enumeren los archivos modificados y se explique cómo se cargará una partida guardada antigua. Solicita un diff y los casos de prueba antes de aceptar el parche.
Revisa si el código escribe datos sin pasar por el componente que gestiona el estado narrativo. Comprueba que, si falla el guardado, el puzle no figure por error como resuelto de forma permanente, que volver a entrar en la escena no conceda la recompensa dos veces y que se aplique un valor predeterminado definido expresamente al cargar una partida antigua que carezca del campo nuevo. Conserva una copia para revertir el cambio y prueba la migración con un duplicado de la partida guardada.
Comprueba qué ocurre al volver, repetir el puzle y seguir una ramificación
Una tabla de verificación debe cubrir distintos puntos de la historia. Las siguientes comprobaciones se proponen para un proyecto real. El ejemplo ficticio no aporta resultados de pruebas.
| Caso | Acción | Resultado esperado que hay que comprobar |
|---|---|---|
| Perfil nuevo | Empieza sin una partida guardada previa | No quedan ID de puzles resueltos ni indicadores de ramificación de partidas anteriores |
| Resolver y salir | Resuelve un puzle, sal de la escena y vuelve | El estado de resolución y la pista prevista siguen siendo coherentes entre sí |
| Intento parcial | Introduce parte de un código y sal | El intento se borra o se reanuda según lo previsto en el diseño |
| Repetición | Vuelve a abrir un puzle resuelto | La presentación funciona y la recompensa de una sola vez no se duplica |
| Ramificación de la historia | Avanza hasta un diálogo o final que dependa del resultado | La ramificación consulta la misma consecuencia en el estado narrativo de referencia |
| Partida guardada antigua | Carga una copia desechable de una partida guardada antes de que se añadiera el nuevo campo | La migración conserva las decisiones conocidas y establece un valor predeterminado seguro |
Registra la versión de la compilación, la plataforma, la partida guardada que has usado, los pasos y los resultados esperados y observados. Si falla un caso, corrige esa transición de estado antes de ampliar la función. Evita presentar la ilustración conceptual o una interfaz simulada como prueba de que la migración de una partida guardada ha funcionado.

Preguntas frecuentes
¿Qué datos de los puzles conviene guardar en un juego de narrativa ramificada?
Por lo general, conviene guardar los ID de los puzles resueltos y las consecuencias que espera el sistema narrativo existente. Gestiona por separado la secuencia de entrada actual, los códigos a medio introducir y las pistas temporales, salvo que el juego ya permita reanudar un puzle sin terminar.
¿Cómo debe conectarse un puzle con una ramificación de la historia?
Usa un ID estable para el puzle y actualiza el indicador narrativo o la consecuencia que ya existe en el proyecto mediante un único evento de resolución bien definido. Evita crear un sistema de ramificaciones paralelo que pueda entrar en conflicto con los diálogos, el estado de las misiones o los finales.
¿Deberían los jugadores poder repetir un puzle ya resuelto?
Decide por separado si al repetir el puzle se vuelve a ver la presentación, se puede volver a resolver o se permite cambiar el estado de la historia. Puedes mostrar el puzle de nuevo sin conceder dos veces la recompensa. Documenta el comportamiento previsto antes de cambiar el flujo de resolución.
¿Cómo puedo guardar el progreso de los puzles en Godot?
La documentación de la versión estable de Godot recomienda user:// para los datos persistentes del usuario e incluye un tutorial de guardado que muestra cómo usar JSON para estados sencillos. Comprueba la plataforma de destino y tus necesidades de almacenamiento de datos. Las limitaciones de JSON en cuanto a tipos de datos y codificación siguen siendo aplicables.
¿Qué debo probar después de añadir el guardado del progreso de los puzles?
Prueba con un perfil nuevo, resuelve un puzle, vuelve a la zona central, recarga la partida, sigue una ramificación que dependa del resultado, comprueba qué ocurre al repetir el puzle y carga una partida guardada antigua. Registra la compilación y los pasos. Un recorrido narrativo de ejemplo no demuestra que se haya hecho una prueba real.
Conserva una única fuente de referencia para el estado narrativo
El primer cambio más seguro suele ser pequeño: guarda los ID estables de los puzles resueltos, tramita la resolución a través del sistema narrativo existente y especifica qué ocurre exactamente al repetir un puzle o reiniciar la partida. Cuando el proyecto real supere las comprobaciones de retorno, ramificación, migración y recompensas, amplía el guardado del progreso solo donde lo requiera la historia.
Si tienes una idea para un prototipo independiente que se pueda jugar en el navegador, prueba SEELE AI Game Maker. Es una opción para crear un prototipo aparte. No implica que sirva para reparar un proyecto existente.


