BinaryFileIO : Real-time Save/Load

A replacement for BinaryFormatter to read and write the public fields and properties of class objects/scripts using BinaryReader and BinaryWriter.

Features

• Supports many common objects and collection types, including deeply nested combinations such as List<Dictionary<string, Vector3>>[,,,,,].
• Use public properties to save and restore references such as sprites, materials, addressables, and other Unity component data.
• Read and write asynchronously with Task-based methods or Unity coroutines.
• Update existing GameObjects and ScriptableObjects by reading data directly into them.
• Stores data in a compact binary format instead of a text-based format such as JSON.
• Convert objects to byte arrays for encryption, networking, or other custom processing.
• Convert objects to and from Base64 strings.
• Apply an XOR byte mask to serialized data to make it less human-readable.
• Find and read the first occurrence of a single saved field or property.
• Includes a SKILL.md file to help compatible AI coding assistants use BinaryFileIO correctly.

Deserialization Security

• Uses strongly typed read methods instead of resolving arbitrary serialized type names.
• Does not store or load fully qualified assembly names.
• Explicitly excludes known unsafe or unsupported runtime types.
• Does not invoke parameterized constructors when ordinary objects are recreated from their public fields and properties.

File Integrity

• Uses CRC-32 to detect corrupted or modified file data.
• Path-based writes are completed in a temporary file before being copied over the destination file.
• Uses thread-safe resource locking with SemaphoreSlim to prevent conflicting reads and writes.

Debug Log

• Shows read and write information while playing in the Unity Editor.
• Provides warnings for common configuration and serialization problems.
• Messages and warnings can be disabled and are excluded from final builds.

Tutorial for saving in Unity Loady Dungeons:

https://youtu.be/cTE1s_JueTE?si=8pFfQbqRpzw0Pmeq