SaveForge

🚀 Up and Running in 3 Lines

No config. No scene tree wiring. No boilerplate. Register your variables, call save(), and SaveForge handles everything — serialization, file I/O, slot management, backup, encryption, and more.

func _ready() -> void:
    SaveManager.register("player_health", 100, "Player")
    SaveManager.register("gold",          0,   "Player")
    SaveManager.register("level",         1,   "World")
    SaveManager.load_data()
func _on_save_pressed():
    SaveManager.save()
func _on_load_pressed():
    SaveManager.load_data()

Open the SaveForge dock at the bottom of the Godot editor to manage everything visually — no more code needed for basic setup.

---

✨ Why SaveForge?

🖥️ Visual Editor Dock
Browse, search, add, edit and remove variables without running the game. Live preview when the game runs, direct disk edit when it doesn't.

🔒 Production-Grade Safety
AES-256 encryption · SHA-256 integrity checking · atomic safe write · automatic rolling backup. Four layers of protection on every save.

💽 Full Godot Type Support
Not just primitives. Vector2/3/4, Color, Transform2D/3D, Basis, Quaternion, NodePath, PackedByteArray — all round-trip correctly through JSON, Binary, and ConfigFile formats.

⚡ Flexible Auto Save
Timer-based, scene-change, or any signal can trigger a save. Ctrl+Shift+S / Ctrl+Shift+L shortcuts work inside the Godot editor too.

🔄 Data Migration
Added or renamed a variable between versions? Register migration steps — old saves upgrade automatically on load, nothing breaks for existing players.

🧩 SaveableNode Base Class
Extend SaveableNode instead of Node. Override two functions — the node auto-registers its variables on _ready() and auto-unregisters when removed from the scene tree.

---

📋 Complete Feature List

⚙️ Core System
Global SaveManager Singleton · Dual Interface (Code API + Editor Panel) · Register Variable API · Save API · Load API · Delete API · Save All API · Node-Based Save Component · Scene Auto Variable Detection · Serializable Variant Support · Data Type Validation · Nested Array Serialization · Nested Dictionary Serialization

🗂️ Save Structure
Save Profiles · Save Slots · Save Categories · Save Groups · Default Values System · Missing Key Auto Fill · Save Data Versioning · Data Migration System

⚡ Save Triggers
Manual Save Trigger · Auto Save Timer · Auto Save On Scene Change · Save On Signal · Quick Save Shortcut (Ctrl+Shift+S) · Quick Load Shortcut (Ctrl+Shift+L)

💽 Storage Formats
JSON Format · Binary Format · ConfigFile Format · Format Chooser · Smart Default Format Selection · Custom Save Locations · Save Path Builder · user:// Path Explorer

🔒 Data Safety
AES-256 Encryption · Corruption Detection · SHA-256 Checksum Validation · Safe Write System · Automatic Backup System · Backup Rotation · Restore From Backup

🖥️ Editor Panel
Bottom Dock Panel · Variable Table View · Variable Search Bar · Variable Filtering · Variable Category View · Category Color Coding · Live Value Preview · Variable Validation Scanner · Save Trigger Warning Icons · One Click Variable Add · One Click Variable Remove · One Click Category Reset · One Click Category Wipe · Import Variable Preset · Export Variable Preset · No-Code Variable Picker · Script Path Detection

🎮 In-Game Save Indicators
In-Game Save Overlay · Overlay Position Selector · Overlay Corner Anchoring · Custom Overlay Text · Overlay Font Selection · Overlay Size Control · Overlay Color Control · Overlay Animation · Overlay Enable Toggle

📡 Signals & Hooks
Data Saved Signal · Data Loaded Signal · Save Failed Signal · External Signal Hooks

🐛 Debug & Development
Debug Mode · Debug Panel Indicator · Verbose Logging Mode · Error Reporting System · Broken Reference Repair Tool · Script Rename Auto Sync · Hot Reload Support · Performance Optimization

📁 Save File Management
Save File Manager · Import Save Data · Export Save Data · Save Data Inspector · Save Folder Access

✨ Plugin Experience
Setup Wizard · Plugin Settings Panel · Themed Editor UI · Full PDF Documentation

🏆 Release Quality
Full PDF Documentation (27 pages) · Code Snippet Library · API Reference · Unit Tested Core API · Cross Platform Compatibility

---

📦 What's Included

• Full plugin source code — 36 GDScript files, fully commented
• PDF documentation — 27 pages covering every feature
• Copy-paste code snippet library
• Full API reference for every class and method
• Unit test suite (core API, formats, safety systems)
• Import / export tools
• In-game save indicator overlay
• Setup wizard on first install
• All future v1.x updates included
• No royalties · use in unlimited projects

---

🎮 Compatibility

Godot 4.x — originally made and tested in Godot 4.6 stable
GDScript only · No C# required · No external dependencies · All platforms supported by Godot

---

Questions or issues? Leave a comment below or reach out directly. — SaturnKM