SO Evolver - Safe ScriptableObject Migrations

Never lose data when refactoring ScriptableObjects again.

Unity's serialization is powerful but unforgiving. If you delete a field from your script before migrating the data, that data is lost forever. If you work on a team, changing shared data structures often leads to merge conflicts.

SO Evolver solves these problems by adding explicit version control and a safe migration framework to your ScriptableObjects.

KEY FEATURES

• Explicit Versioning: Assets track their own schema version (V0 → V1 → V2).
• Safety First: Automatic timestamped backups are created before every migration.
• Dry Runs: Preview exactly what will change in a log report before modifying files.
• One-Click Restore: Undo mistakes instantly from the dashboard using the backup history.
• Audit Logs: Keeps a complete history of all migrations in your project logs.
• Team-Friendly: Uses a linear versioning model to prevent merge conflicts.
• Batch Operations: Migrate hundreds of assets in a single click.

THE WORKFLOW

1. Inherit: Change your class to inherit from VersionedScriptableObject.
2. Modify: Add new fields to your script (keeping the old ones temporarily).
3. Migrate: Write a simple C# migration script to map old data to new data.
4. Execute: Use the SO Evolver Window to Dry Run and apply changes to all assets.
5. Clean: Safely delete the old fields from your script.

PACKAGE INCLUDES

• Migration Dashboard (Editor Window)
• Core Base Classes (VersionedScriptableObject, SOMigration)
• Automatic Backup & Restore Systems
• Comprehensive Documentation (Quickstart, Safe Workflow, API Reference)
• 10+ Real-world Migration Examples

If you find this tool useful, please leave a review! It helps me add new features.