Un juego de detectives debería recordar las pruebas que ha conseguido el jugador sin tener que conservar todas las teorías a medio formular. Los puzles resueltos, las pistas recogidas, los intentos de deducción en curso y las conclusiones del caso son datos de estado distintos. Agruparlos en un solo bloque puede duplicar pruebas o permitir que una teoría desactualizada sobrescriba el estado que rige la historia.

Esta guía describe un misterio ficticio ambientado en un puerto. No se ha probado ningún proyecto, investigación ni migración de partidas guardadas. El objetivo es guardar el progreso de los puzles sin alterar el flujo de recogida de pruebas y resolución del caso que ya funciona.
Separa las pruebas, los puzles resueltos, los intentos y las conclusiones
Haz una lista de los datos que registra ahora el juego. Una prueba puede tener un ID estable y un origen. Un puzle puede tener un indicador de resolución. Un tablero de deducciones puede guardar una disposición temporal de las pistas y un caso puede almacenar una conclusión o el estado del capítulo. Decide qué valores se conservan al salir de una sala, cerrar el juego, reiniciar un capítulo o empezar un caso nuevo.
| Estado | Ejemplo | Qué se conserva |
|---|---|---|
| Prueba | Fotografía, nota, ID de una pista física | ¿Se queda en el inventario del caso? |
| Resultado del puzle | Cerradura de latón abierta | Al volver, ¿se omite el puzle o se muestra de nuevo? |
| Intento de deducción | Disposición actual de las pistas | ¿Se puede retomar una teoría a medias? |
| Conclusión | Indicador de una rama narrativa o desenlace del caso | ¿Qué sistema narrativo lo gestiona? |
En el caso ficticio de Lantern Pier, al abrir la cerradura se registra un ID de puzle estable y se añade una pista al tablero de pruebas. La disposición provisional de las pistas para una teoría se borra cuando el detective sale de la sala. La conclusión final sigue dependiendo del estado del caso que ya gestiona el juego. Estas reglas sirven de ejemplo y no describen un juego de detectives real.
Integra la resolución de los puzles en el sistema de casos existente
Sigue el recorrido desde la interacción con un puzle hasta la recogida de su pista y el desbloqueo de un diálogo o una conclusión. Averigua qué componente gestiona los ID de las pruebas, los indicadores de capítulo y los finales. Pide a la IA que trace ese recorrido antes de modificar el código. Deja el estado del caso en manos de un único componente para evitar que un inventario independiente de puzles entre en conflicto con el tablero de pruebas.
Cuando se resuelva un puzle, emite un único evento de resolución con el ID estable del puzle y la consecuencia prevista. El sistema de casos puede comprobar si el evento ya está registrado, añadir la pista una sola vez y desbloquear la rama que depende de ella. Volver a reproducir una animación o recargar una escena no debería conceder la misma prueba otra vez.
Usa ID en lugar del texto que se muestra en pantalla. Así se puede cambiar el nombre de una pista o traducirlo sin alterar su clave en la partida guardada. Si se elimina una pista o un puzle en la próxima versión, decide si vas a migrar su ID, ocultarlo o conservar el registro antiguo para los casos ya resueltos.

Define qué significa volver a jugar un puzle
Un jugador puede volver a un puzle resuelto para ver la animación, intentarlo de nuevo, explorar una rama alternativa o reiniciar el capítulo. Cada acción tiene un propósito distinto. Se puede volver a reproducir la animación sin modificar el estado de las pruebas, y una rama nueva puede generar su propio registro de conclusión. Define qué comportamientos admite el juego.
Presta atención al reinicio de capítulos y a la opción Nueva partida. Si al reiniciar un capítulo se borra el progreso de sus puzles, pero se conserva el diario, deja clara esa regla. Si empezar un caso nuevo borra todos los datos del caso, asegúrate de que no se pierda también el contenido desbloqueado en el perfil que no guarda relación con él. Siempre que sea posible, reutiliza el proceso de reinicio existente en vez de añadir reglas de borrado exclusivas para los puzles.
El progreso en línea o en varios dispositivos requeriría diseñar por separado la resolución de conflictos. Este artículo parte del modelo actual del proyecto, que guarda los casos en local. Solo cabe hablar de sincronización entre dispositivos si el juego ya la admite y se ha comprobado su funcionamiento.
Versiona el formato de guardado y conserva los casos antiguos
Usa la ruta de almacenamiento y el método de serialización que admite el proyecto. La documentación de la versión estable de Godot describe user:// como una ruta con permisos de escritura para datos persistentes e incluye ejemplos de guardado en archivos. Comprueba la plataforma de destino y la versión actual del motor. El formato de guardado también necesita un esquema versionado, valores por defecto para los campos ausentes y un mecanismo de recuperación si los datos están mal formados.
Prueba la migración con una copia de un caso antiguo. Compara los ID de las pruebas y de los puzles resueltos, las entradas del diario y los indicadores de conclusión antes y después de cargar la partida. Antes de asignar al nuevo campo el valor por defecto «resuelto» o «sin resolver», considera cómo afectará al punto de la historia en el que se encuentran los jugadores actuales.
Durante el desarrollo, lleva un registro breve con el ID del caso, el ID del puzle, el evento recibido, la prueba añadida, el indicador de conclusión que ha cambiado y la versión del guardado. Así podrás distinguir si el estado ha dejado de actualizarse o si la interfaz sigue mostrando una versión antigua del tablero.
Registra el origen de cada pista
Cuando un puzle desbloquee una prueba, registra de dónde procede si el sistema de casos admite esa relación. El ID de una pista puede apuntar a la sala, la conversación o el objeto que permitió descubrirla. Esto ayuda a explicar en el diario cómo obtuvo el detective esa información y facilita la depuración de las ramas que dependen de varias pistas.
Una ilustración o una imagen generada de una prueba no sustituye el registro real de la pista. La partida guardada debe almacenar los ID estables y las consecuencias para el caso que el juego consulta. Si el jugador puede descartar pruebas o volver a examinarlas, respeta el funcionamiento actual del diario y evita crear un segundo inventario.
Pide a la IA un cambio acotado y reversible
Indica al asistente qué debe respetar: la recogida de pruebas, el orden de los diálogos, los reinicios de capítulo, los finales y los controles de los puzles. Pídele que guarde solo los ID de los puzles resueltos y las consecuencias que hayas definido, y que mantenga los intentos parciales como datos temporales. Debe enumerar los archivos que se modificarán, explicar cómo funcionará la migración e indicar los pasos para revertir el cambio. Pídele un plan para el parche antes de que edite nada.
Revisa el diff para detectar pruebas que se guardan por duplicado, textos de interfaz que se usan como ID y conclusiones que se almacenan tanto en el puzle como en el gestor de la historia. Conserva una partida guardada de un caso conocido como referencia para las pruebas de regresión. Si la IA cambia la lógica del final para que un puzle funcione, separa ese cambio de la petición de persistencia y revísalo por su cuenta.

Comprueba la recogida de pistas, el regreso, la repetición y la migración
Las siguientes pruebas son propuestas. No son resultados de Lantern Pier:
| Caso de prueba | Acción | Qué comprobar |
|---|---|---|
| Caso nuevo | Empieza con un perfil limpio | No aparecen pistas ni conclusiones de partidas anteriores |
| Resolver un puzle | Completa un puzle que dé acceso a una pista | La prueba se añade una sola vez y se actualiza el estado de la rama narrativa |
| Salir y volver | Sal de la sala y vuelve a entrar | El estado del puzle y el tablero del caso respetan la regla definida |
| Intento parcial | Sal antes de resolver el puzle | El intento se reinicia o se reanuda según lo previsto |
| Volver a jugar | Interactúa de nuevo con un puzle resuelto | No se duplica ninguna prueba ni se genera una conclusión imprevista |
| Caso antiguo | Carga una copia de una partida guardada con una versión anterior | Las pistas y los indicadores narrativos siguen siendo coherentes |
Registra la versión de la compilación, los ID del caso y del puzle, la versión del guardado, los pasos, el resultado esperado y el observado. Comprueba tanto lo que muestra el diario como el comportamiento de la rama narrativa. Una maqueta del tablero de pruebas no demuestra que una pista guardada desbloquee el final correcto.
Preguntas frecuentes
¿Qué progreso debe guardarse en un juego de detectives?
Guarda los ID de las pruebas recogidas, los ID de los puzles resueltos y las consecuencias para el caso de las que depende la historia. Trata los intentos de deducción a medias, la disposición elegida para el tablero y las pistas de ayuda temporales como datos de estado separados, salvo que el juego ya permita recuperarlos al reanudar la partida. Usa la terminología y el formato de registro de casos que ya utiliza el proyecto.
¿Cómo debe afectar un puzle resuelto al tablero del caso?
Envía un único evento de resolución al componente que ya gestiona el estado del caso. Este puede registrar el ID del puzle, desbloquear la pista o la conclusión prevista e impedir que, al repetir la interacción, se conceda la misma prueba dos veces. Haz que el tablero y el modelo del caso consulten el mismo componente.
¿Deberían los jugadores poder volver a jugar un puzle de detectives?
Decide si volver a jugar sirve para ver de nuevo la secuencia, iniciar otro intento o abrir una nueva rama del caso. Volver a reproducir una animación no debería duplicar pruebas ni sobrescribir una conclusión anterior sin avisar. Documenta qué ocurre al volver a jugar para que los jugadores sepan qué se reinicia. Mantén el resultado guardado separado de cualquier nuevo intento en otra rama.
¿Dónde deben guardarse las pruebas y el estado de los puzles?
Usa la ruta de datos persistentes y el modelo de guardado versionado que admite el proyecto. La documentación de la versión estable de Godot describe user:// y el guardado en archivos. Confirma la versión actual del motor y la plataforma de destino antes de elegir un formato. Verifica estos campos en el proyecto real y en la plataforma de destino.
¿Qué debo probar después de añadir deducciones persistentes?
Prueba un caso nuevo, la recogida de una pista, la resolución de un puzle, el regreso al tablero de pruebas, la recarga de la partida, la repetición del puzle y la carga de una partida antigua. Registra el caso y la compilación que hayas probado. Una cadena de pistas ficticia no constituye un resultado de prueba. Incluye el ID del caso y la versión del guardado al registrar el resultado observado.
Mantén el estado del caso en un solo lugar
Guarda los resultados estables de los puzles y las consecuencias de las pruebas a través del sistema que ya gestiona la investigación. Mantén los intentos parciales como datos temporales, salvo que el juego permita expresamente retomarlos. Antes de ampliar el sistema de pistas, comprueba en el proyecto real qué ocurre al volver a una sala, al repetir un puzle y al cargar partidas antiguas.
Si tienes una idea para un prototipo independiente que pueda jugarse en el navegador, prueba SEELE AI Game Maker. La invitación se refiere a crear un prototipo independiente y no a modificar el sistema de casos de un juego de detectives existente.


