codebase-save-load

What problem does it solve?

Provides a deterministic, versioned save and load workflow for persisting and restoring complex game state so that serialization changes, missing derived data, and incompatible files are detected and handled with clear errors.

Core Features & Use Cases

• Versioned envelope pattern that serializes GameState inside a SaveFile with an explicit version number to prevent accidental incompatible loads.
• Uses RON for human-readable serialization and includes post-load reconstruction steps such as rebuilding spatial indices and updating lighting.
• Clear error reporting on version mismatch, tests for roundtrip integrity, and guidance for when to bump the save schema version; useful when adding, removing, or renaming GameState fields or diagnosing corrupted saves.

Quick Start

Use the save system to write the current game state to the default save file and verify that loading performs index rebuilds and lighting updates.