Cyg: Sistema de guardado asíncrono y robusto para GameMaker

Uno de los mayores dolores de cabeza al desarrollar en GameMaker suele ser el sistema de guardado. Históricamente, GML no lo ponía fácil: gestionar la serialización, evitar que el juego se congele al escribir archivos grandes y asegurar que los datos no se corrompan es una tarea que consume horas de documentación.

Últimamente, GameMaker ha mejorado mucho sus funciones de archivos y estructuras, pero todavía falta esa "capa" de robustez que te dé tranquilidad. Por eso, he estado trabajando en Cyg, una librería propia que automatiza estas tareas pesadas.

¿Qué hace a Cyg diferente?

No quería simplemente "escribir un JSON". Quería algo que aguantara el flujo de trabajo de un proyecto real:

  • I/O Asíncrono por defecto: Fundamental para evitar tirones de frames (stuttering) y asegurar compatibilidad con plataformas más allá de Desktop, como consolas o navegadores.
  • Gestión de Backups y Compresión: Reduce el peso de los archivos y, más importante, genera automáticamente un archivo .bak de respaldo. Si algo falla durante la escritura, el progreso del jugador no se pierde.
  • Seguridad y Verificación: Incluye cifrado RC4 opcional y verificación de integridad mediante checksums para evitar manipulaciones externas simples.
  • Sistema de "Fixers" (Migraciones): Quizás mi parte favorita. Si actualizas tu juego y cambias la estructura de los datos, puedes registrar un fixer para que los archivos antiguos se transformen automáticamente a la nueva versión sin romper nada.

Un ejemplo rápido de uso

La idea es que sea una API estática y sencilla de implementar:

// Guardar datos del jugador de forma asíncrona
Cyg.Add("player", { name: "Hero", level: 10 });
Cyg.Export("save/slot1.sav", "player", false, function(_success) {
    if (_success) show_debug_message("¡Partida guardada!");
});

// Cargar datos con un callback
Cyg.Import("save/slot1.sav", "player", false, function(_success, _data) {
    if (_success) {
        var _hero = Cyg.Get("player", undefined);
    }
});

Espero que esta herramienta les sirva para sus proyectos tanto como me está sirviendo a mí. Pueden revisar el repositorio y la documentación completa en el siguiente enlace:

https://github.com/Totobal5/Cyg

Comentarios

Publicar un comentario

Cargando menciones...

Entradas más populares de este blog

Cimplicity: Cambiar texto de un botón según el estado de un punto

Imagen
Recientemente, en un proyecto implementé una solución para un botón de conmutación ( toggle ) que indica el modo de operación ( Manual o Automático ) de forma dinámica. A continuación, explico cómo configurar este comportamiento utilizando variables de objeto y procedimientos. El Desafío Necesitamos que un mismo objeto gráfico realice dos tareas: Invertir el valor de un bit en el PLC. Cambiar su propio texto para reflejar el nuevo estado. Para que esto sea eficiente, el texto no puede ser estático. Utilizaremos una variable interna, en este caso llamada {Modo} , que servirá como puente entre la lógica del punto y la visualización. Configuración de la Variable Dentro de las propiedades del grupo o botón, en la pestaña Variables , debemos declarar la variable {Modo} . Es recomendable asignarle un valor inicial como "INDEFINIDO" o "ERROR" para detectar rápidamente si la lógica de actualización no se está ejecutando. Lógica de Eventos y Procedimientos El secreto para...

Cimplicity: Un problema de región

Imagen
A veces, en automatización, los errores más desesperantes no vienen de la lógica del proceso, sino de los detalles más pequeños del sistema operativo. Hace poco, trabajando con Cimplicity , me topé con un error tan extraño como molesto que me impidió avanzar por un buen rato. El Problema Intentaba ingresar una expresión simple en un objeto de texto para mostrar un valor analógico con sus unidades. La idea era usar esta fórmula: FormatReal(EU_CONV('02727-PI-08328'), 2, 4, 1, 0, 0) + " [bar]" A pesar de que la sintaxis es correcta según el manual, el Workbench simplemente rechazaba la expresión. No permitía validarla, como si estuviera escrita en otro idioma. ¿Qué estaba pasando realmente? Después de investigar, llegué a la raíz del problema: la configuración regional de Windows . Resulta que el motor de expresiones de Cimplicity es extremadamente sensible a cómo el sistema operativo maneja los separadores. En Chile ...

RISH LM-1360: No muestra el menú de IP

Imagen
Durante la configuración de un analizador de redes RISH LM 1360 para integración con PLC, se detectó la desaparición de las opciones de configuración de red (IP Address, Subnet Mask, etc.) dentro de la interfaz del dispositivo. A pesar de que el equipo había sido configurado previamente mediante Ethernet, el menú correspondiente dejó de ser accesible de forma local. El manual de usuario no documenta condiciones de error que oculten este submenú. El acceso al menú de configuración IP en este modelo está condicionado por los parámetros de la interfaz de comunicación serial. Si el Baud Rate o la configuración de paridad no coinciden con ciertos valores predeterminados de fábrica o estables para el firmware, el sistema oculta las opciones de red TCP/IP para priorizar o estabilizar el stack de comunicación. Solución del Fabricante Para restablecer la visibilidad del menú IP, se deben ajustar los parámetros en el menú de comunicación serial ( SEr ) a los siguientes valores específicos: Ba...