Save Forge 1.0

Save Forge 1.0 — Save, Load & Persistence Toolkit

Build reliable save systems without writing slot management, migrations, backups, validation, and recovery logic from scratch.

Save Forge is a source-first persistence toolkit for Godot 4, Unity 6, and engine-agnostic state workflows.

Features

• Multiple save slots
• Save metadata
• Timestamps
• Custom slot names
• Playtime and version metadata
• Generic state-provider registry
• Deterministic JSON serialization
• Save format versioning
• Sequential migrations
• Safe writes using temporary files
• Atomic save replacement
• Optional backups
• Backup restore
• Opt-in autosave
• Manual save
• Checkpoint save
• Event-triggered save
• Save validation
• Corrupt save detection
• Malformed data handling
• Unsupported version detection
• Migration failure reporting
• State export / import
• Save slot inspection
• Debug tools
• Godot editor integration
• Unity editor integration
• Source included

Works standalone

Save Forge works fully on its own.

Forge Core and all other MAVAR Forge products are optional.

You can register your own state providers and use Save Forge as a complete standalone persistence system.

Better together

When Forge Core is installed, Save Forge can persist the aggregate state of the entire MAVAR Forge ecosystem.

Example:

Inventory + Progression + Quest + Crafting + Dialogue → Save Forge → disk

Then:

reset game state → load save → restore all modules

Save Forge handles persistence.

Forge Core handles aggregate state.

Each game system remains independent.

Versioning & migrations

Save Forge includes real save-format versioning and migration support.

Example:

player.gold

can migrate safely to:

player.currency.gold

Older valid saves can be upgraded instead of discarded.

Safety

Save Forge is designed to fail safely.

It can detect:

• corrupted saves
• malformed payloads
• unsupported versions
• failed migrations
• invalid provider state

Invalid data is rejected without uncontrolled crashes or silent corruption.

Tested

• Godot 4.7.2 — PASS
• Unity 6.6 / 6000.6.0f1 — PASS
• Standalone save/load — PASS
• Multiple slots — PASS
• State-provider roundtrip — PASS
• Save migrations — PASS
• Backup / restore — PASS
• Corrupt save handling — PASS
• Forge Core integration — PASS
• Six-module ecosystem roundtrip — PASS
• Inventory restore — PASS
• Progression restore — PASS
• Quest restore — PASS
• Crafting restore — PASS
• Dialogue restore — PASS
• Regression tests — PASS

Demo scenarios

• RPG Save
• World Save
• Migration Demo

Save Forge is the sixth module in the MAVAR Forge ecosystem.

Each Forge product works independently, while Forge Core and Save Forge can connect them into a complete shared-state workflow.