Settings

BeastySaveSettings contiene todas las opciones que usa una llamada de guardado o carga: adónde va el archivo, si está encriptado, si se conserva un backup, cuán estrictamente carga, y a qué versión de datos pertenece. Esta página lista cada campo, su valor por defecto, y la razón por la que lo cambiarías.

Las settings son por llamada, no por proyecto

No hay ningún settings asset global. Cada método de BeastySave recibe un BeastySaveSettings como argumento, y BeastySaveManager mantiene uno en su inspector para SaveAll y LoadAll.

Eso significa que dos guardados en el mismo proyecto pueden comportarse de forma completamente distinta. Un autoguardado puede ser tolerante, sin encriptar y sin backup, escribiendo a una carpeta Autosaves; un guardado manual puede ser estricto, encriptado y con backup, escribiendo a Saves. Nada en el sistema los obliga a coincidir.

static readonly BeastySaveSettings Manual = new BeastySaveSettings
{
    Folder = "Saves",
    Encrypted = true,
    EncryptionKey = "your own key",
};

static readonly BeastySaveSettings Auto = new BeastySaveSettings
{
    Folder = "Autosaves",
    Backup = false,
    Strict = false,
};

Si nunca escribes C#, obtienes un solo bloque de settings: el campo Settings en el componente BeastySaveManager, editado en el inspector o en la ventana Save Manager. Eso es suficiente para la mayoría de los juegos.

Los campos

Campo	Tipo	Por defecto	Qué hace
Folder	string	"Saves"	Subcarpeta bajo DataPath que contiene los archivos de guardado.
Extension	string	"save"	La extensión del archivo, sin el punto.
DataPath	string	vacío	Ruta base absoluta. Vacío significa Application.persistentDataPath.
Encrypted	bool	false	Encripta el payload de datos con AES-256.
EncryptionKey	string	vacío	La clave. Vacío significa la clave por defecto compartida que viene con el asset.
Backup	bool	true	Conserva el archivo anterior como <slot>.<ext>.bak al sobrescribir un slot.
Strict	bool	true	Carga todo o nada. false omite los campos malos y advierte.
DataVersion	int	1	La versión de esquema estampada en cada guardado. Dirige las migraciones.

La ruta final de un guardado es:

<DataPath o persistentDataPath>/<Folder>/<slot>.<Extension>

BeastySave.GetFolderPath(settings) y BeastySave.GetSlotPath("slot1", settings) te dan esas rutas sin que tengas que ensamblarlas tú.

Folder

Cámbialo para separar distintos tipos de guardado entre sí — Saves, Autosaves, Profiles. Carpetas diferentes son independientes: ListSlots en una nunca ve los archivos de la otra, y un slot llamado slot1 puede existir en ambas a la vez.

Extension

Cosmético. save por defecto; sav, dat, json funcionan todos. Sin punto inicial. Cambiarlo en un juego ya publicado significa que los archivos existentes de tus jugadores quedan invisibles para el nuevo build, así que elígelo antes de publicar.

DataPath

Déjalo vacío. Application.persistentDataPath es la ubicación de escritura por usuario que Unity te da en cada plataforma, y es donde pertenecen los guardados.

Configúralo cuando tengas una razón específica — una herramienta de editor que escribe dentro de la carpeta del proyecto, un test que escribe en un directorio temporal. Configurarlo a una ruta a la que el sistema operativo del jugador no te deje escribir es cómo consigues un IoError.

Encrypted

Desactivado por defecto. Actívalo y la sección data del archivo se convierte en un blob Base64 en lugar de JSON legible. El envelope y los metadatos se quedan en texto plano, así que una pantalla de selección de slot sigue funcionando.

Dos cosas que debes saber antes de activarlo:

• El flag tiene que coincidir con cómo se escribió el archivo. Con Encrypted = true el sistema rechaza cargar un guardado en texto plano, y con Encrypted = false no puede leer uno encriptado. Cambiar esta configuración en un juego ya publicado deja varados todos los guardados existentes.
• Esto es ofuscación, no seguridad. Lee encryption.md antes de confiar en ella.

EncryptionKey

Cualquier string no vacío funciona — de él se deriva una clave AES de 32 bytes con SHA-256. No necesitas producir una clave de una longitud particular.

Déjalo vacío y el sistema usa BeastySaveSettings.SharedDefaultEncryptionKey, que viene incluido en cada copia del asset. Cualquiera que posea Beasty Save System tiene ese string. Existe para que la encriptación funcione de fábrica, no para que la publiques con ella. Si la encriptación está activada y no has configurado tu propia clave, el sistema te avisa una vez en el editor y en los builds de desarrollo.

Configura tu propia clave antes de publicar. Luego lee encryption.md, que es honesta sobre el hecho de que tu clave también viene incluida dentro de tu juego.

Backup

Activado por defecto. Cuando un guardado sobrescribe un slot existente, el archivo antiguo se rota a <slot>.<ext>.bak primero. BeastySave.RestoreBackup lo devuelve; la ventana Save Manager tiene un botón Restore Backup que hace lo mismo.

Dos comportamientos que vale la pena conocer:

• El primer guardado de un slot no crea backup. No había nada que rotar.
• Un slot cuyo checksum no verifica nunca se rota hacia el backup. Un archivo corrupto no puede destruir tu última copia buena.

Desactívalo solo donde guardes tan a menudo que el archivo extra sea un coste real — un autoguardado frecuente, por ejemplo. El valor por defecto está activado por una buena razón. Consulta backups-and-corruption.md.

Strict

Activado por defecto. Una carga estricta es todo o nada: si un campo no se puede leer de vuelta, la carga falla y no se aplica nada. El estado de tu juego se queda exactamente como estaba, y obtienes un resultado de error para mostrarle al jugador.

Tolerante (Strict = false) omite el campo que no pudo leer, lo registra en LoadResult.Warnings, y carga el resto.

Publica en modo estricto. Usa el tolerante cuando renombraste un campo a mitad de producción y prefieres perder ese único valor a perder el guardado. La comparación completa, incluyendo el comportamiento de rollback y una advertencia importante sobre las raíces de tipo struct, está en strict-vs-tolerant.md.

DataVersion

La versión de esquema de tus datos. Empieza en 1 y se escribe en cada archivo. Cuando cargas un archivo cuya versión es más baja que la actual, las migraciones registradas se ejecutan en orden para ponerlo al día.

Lo subes cuando cambias la forma de tus datos de guardado de una manera que los archivos antiguos no pueden sobrevivir, y registras una migración para el paso. Un archivo con una versión más alta que tu configuración falla con VersionTooNew — un build antiguo se niega a adivinar sobre un guardado escrito por uno más nuevo, en lugar de corromperlo.

Consulta versioning-and-migrations.md.

Nombres de slot

El slot es el nombre de archivo desnudo, y el sistema lo valida. Un slot rechazado hace que la llamada falle con InvalidArgument y un mensaje que dice exactamente por qué.

Un nombre de slot es rechazado cuando:

Regla	Ejemplo que es rechazado	Por qué
Está vacío o solo espacios en blanco	""	No hay nombre de archivo.
Contiene un separador de ruta	saves/slot1, saves\slot1	Podría escribir fuera de la carpeta de guardado.
Contiene ..	../slot1	La misma razón.
Es una ruta con raíz	C:\slot1, /slot1	La misma razón.
Contiene caracteres que no son válidos en un nombre de archivo	slot:1, slot*	El sistema operativo no puede crear el archivo.
Es un nombre de dispositivo reservado de Windows	CON, PRN, AUX, NUL, COM1–COM9, LPT1–LPT9	El nombre direcciona a un dispositivo, no a un archivo — CON.save incluido.

Los nombres de dispositivo de Windows se rechazan en todas las plataformas, no solo en Windows. Una carpeta de guardado escrita en macOS o Linux se mantiene utilizable si el jugador luego la copia a una máquina Windows.

Si tu juego deja que los jugadores nombren sus propios guardados, pasa el nombre por BeastySave.Save y muestra el mensaje InvalidArgument, o sanéalo primero. No asumas que un nombre está bien porque se veía bien en tu máquina.

Ver también

• encryption.md — los límites reales
• backups-and-corruption.md — el archivo .bak y cómo restaurarlo
• strict-vs-tolerant.md — los dos modos de carga
• versioning-and-migrations.md — DataVersion en la práctica
• slots-and-metadata.md — listar slots y leer sus metadatos
• results-and-errors.md — cada código de error