Preguntas frecuentes

Respuestas breves. Cada una enlaza a la página que lo explica en detalle.

¿Necesita Newtonsoft, o algún otro paquete?

No. El paquete tiene cero dependencias externas. Incluye su propio motor JSON, así que no hay nada que instalar y nada que entre en conflicto con una versión de Newtonsoft que tu proyecto ya use. Los módulos convertidores opcionales necesitan los propios módulos de Unity (física, audio, uGUI, etc.), y si alguno de ellos no está presente el módulo simplemente no compila y el resto del paquete sigue funcionando.

Consulta Instalación y Módulos convertidores.

¿Puedo usarlo con mis datos de guardado existentes?

No directamente. Un guardado de Beasty es un sobre (envelope) con su propia versión, checksum y payload, así que el sistema no puede leer un archivo escrito por otro asset de guardado o por tu propio serializador hecho a mano.

La ruta de migración es algo puntual en tu código: lee tu archivo antiguo con lo que sea que lo escribió, construye tu objeto de datos a partir de él, y llama a BeastySave.Save. A partir de ese momento el archivo es un guardado de Beasty. BeastySave.RegisterMigration sirve para moverse entre versiones de tus propios guardados de Beasty, no para importar un formato ajeno. Consulta Versionado y migraciones.

¿Funciona con IL2CPP?

Sí. Mono e IL2CPP están ambos soportados, y las rutas de serialización — las que suelen romperse en builds AOT — se ejercitan mediante una escena de humo ejecutada contra un build real de IL2CPP, no contra el editor con el backend cambiado. Consulta Plataformas y límites.

¿Funciona en WebGL?

No. WebGL no está soportado en 1.0.0. La escritura atómica depende de la semántica del sistema de archivos que el build de navegador no proporciona, y las variantes asíncronas están basadas en Task. No hay ninguna opción que lo active y ningún workaround soportado; un build de navegador necesita una capa de persistencia diferente. Plataformas y límites explica exactamente por qué.

¿Es segura la encriptación?

No, y no deberías tratarla como si lo fuera. Es AES-256, y es AES-256 real — pero la clave viene incluida dentro de tu juego y puede extraerse del build. Eso la convierte en ofuscación contra un jugador que edita su guardado en el Bloc de notas, no en seguridad contra un atacante decidido. No protegerá una tabla de clasificación ni una compra dentro de la aplicación.

Úsala para detener las trampas casuales, y diseña cualquier cosa que deba ser fiable para que se valide en un servidor. Consulta Encriptación.

¿Puedo guardar un Dictionary?

Sí. Dictionary, HashSet, SortedSet, Queue, Stack, List y los arrays se guardan y recuperan correctamente. Las claves de un Dictionary deben ser strings, primitivos o enums — una clave de cualquier otro tipo hace fallar el guardado. Consulta Qué se guarda.

¿Puedo guardar una referencia a un ScriptableObject? ¿Un sprite? ¿Un prefab?

No. Las referencias a UnityEngine.Object nunca se escriben en un archivo de guardado — ni como campos, ni dentro de colecciones. Este es el filo más afilado del paquete y es deliberado.

La ventaja es que tampoco se sobrescriben al cargar: las referencias que conectaste en la escena sobreviven sin tocarse. El patrón es guardar un id — un string — y resolver el asset tú mismo después de cargar. Consulta Qué se guarda.

¿Puedo tener configuraciones distintas para el autoguardado y el guardado manual?

Sí, desde código. BeastySaveSettings es una clase serializable normal y cada llamada a BeastySave recibe una instancia, así que puedes pasarle una diferente a cada llamada — una carpeta distinta, una extensión distinta, encriptación activada para una y desactivada para la otra.

El camino sin código usa un solo objeto de settings: BeastySaveManager mantiene un único campo settings que SaveAll y LoadAll usan ambos. Ten en cuenta que cambiar Folder o Extension cambia lo que ListSlots encuentra. Consulta Settings.

¿Cuán grande puede ser un guardado?

No hay un límite estricto, pero la serialización es síncrona — incluso dentro de SaveAsync, que hace la IO de archivos de forma asíncrona mientras construye y encripta el JSON en el hilo que la llama. Así que un guardado muy grande cuesta un hitch de frame proporcional a su tamaño, y hacer await no elimina ese hitch.

Guarda el estado del juego, no la escena completa, y autoguarda en momentos en los que un hitch sea invisible. Consulta Plataformas y límites y Guardado asíncrono.

¿Puedo leer un archivo de guardado a mano?

Sí, a menos que lo hayas encriptado. Un guardado es JSON, indentado con dos espacios, UTF-8 sin BOM, y puedes abrirlo en cualquier editor de texto. Eso es útil para depurar y para soporte, y también es una invitación abierta para un jugador con un editor de texto — que es para lo que sirve la opción de encriptación.

El diccionario meta permanece en texto plano incluso cuando el guardado está encriptado, así que una pantalla de selección de slot puede mostrar el nivel y el tiempo de juego sin la clave. Trátalo como datos de visualización no confiables: se lee antes de verificar el checksum. Consulta El formato del archivo de guardado y Slots y metadatos.

¿Es seguro para hilos (thread-safe)?

Llámalo desde el hilo principal. Cualquier cosa que guarde el estado de la escena tiene que tocar la API de Unity, y la API de Unity es solo para el hilo principal. Las variantes asíncronas son async/await, no trabajos en segundo plano — te evitan el bloqueo de la IO, no mueven tu trabajo a un hilo de trabajo (worker thread). Consulta Plataformas y límites.

¿Puedo usar solo el motor JSON?

Sí. JsonNode, JsonMapper, JsonParser y JsonWriter son públicos y utilizables por sí solos, sin dependencia del pipeline de guardado. Parsea, construye un DOM, mapea objetos hacia y desde él, y vuelve a escribirlo. Consulta El motor JSON.

¿Funciona sin el paquete de novela visual?

Sí. Beasty Save System es un paquete independiente, vendido por separado, que además viene incluido dentro de Beasty Visual Novel. No tiene ninguna dependencia del código de la novela visual y nada en él asume un proyecto de VN.

¿Tengo que escribir código para usarlo?

No. Añade un BeastySaveManager a la escena, añade un BeastySaveable a los objetos que quieras recordar, marca los componentes que llevan su estado, y conecta SaveAll y LoadAll directamente al OnClick de un Button uGUI con el nombre del slot escrito en el inspector. Consulta Guardar sin código.

¿Qué pasa si un archivo de guardado se daña?

La escritura es atómica — un cierre inesperado a mitad de la escritura no puede dejar un guardado a medias — y el archivo anterior se rota a <slot>.<ext>.bak en cada guardado después del primero. Un archivo corrupto nunca se rota hacia la copia de seguridad, así que el .bak siempre es la última copia que se verificó.

Un archivo dañado falla al cargar con Corrupt, y todo LoadResult lleva BackupAvailable. Ofrécele al jugador BeastySave.RestoreBackup. Consulta Copias de seguridad y corrupción.

¿Lanza excepciones?

No. Cada llamada en BeastySave devuelve un resultado tipado — SaveResult o LoadResult<T> — con un flag Success, un código BeastySaveError y un mensaje. Nunca tienes que envolver un guardado en un try/catch. Sí tienes que comprobar el resultado. Consulta Resultados y errores.

¿Puedo añadir soporte para un tipo que no conoce?

Sí, y también puedes reemplazar lo que guarda un convertidor incorporado. Implementa IBeastyConverter y regístralo con BeastySave.RegisterConverter (prioridad más alta) o BeastySave.RegisterModule (un grupo con nombre, idempotente). Regístralo desde un [RuntimeInitializeOnLoadMethod] — entrar en Play Mode reinicia las variables estáticas. Consulta Convertidores personalizados.