Saltmire Save — One-Line Save/Load for Godot 4

Saving game state is something every game needs and nobody enjoys wiring. Saltmire Save does it in one line — then handles the parts that actually bite you in production: corrupt saves, save-file editing, schema changes across updates, and bloated save sizes.

Save.write("slot1", {"hp": 80, "level": 3})   # save
Save.read("slot1")                             # load (null if missing)

That is the whole free Lite API. Everything below is real, tested, and measurable — the addon ships a headless selftest that prints the numbers.

Why it is worth it (proven, not promised)

• 🔒 Encryption — AES-encrypts the file; plaintext markers are absent from the on-disk bytes, and a wrong key returns null. Save-editing blocked.
• 🗜️ Compression — gzip payloads: a 400-entry save goes 27,827 → 2,094 bytes (92.5% smaller), round-trip intact.
• ♻️ Corruption recovery — rotating backups auto-heal a trashed save on the next read.
• ⬆️ Schema migration — a v1 save is auto-upgraded to v3 in 2 steps as your game evolves, no data loss.
• 💾 Smart autosave — a dirty flag skips pointless writes (2 ticks, nothing changed → 1 write, 1 skipped).
• 📇 Slot metadata — level / playtime / timestamp for a Load Game screen, without deserializing the whole payload.

One autoload, zero dependencies, MIT. Works on desktop and web (IndexedDB) with the same API.

Install

Copy addons/saltmire_save/ into your project, enable "Saltmire Save" in Project Settings → Plugins. Done — the Save autoload is registered.

Part of Saltmire

Small, honest, drop-in tools for Godot 4. See the game-feel family too: Juice, FX, Spark, Impact.