v2 to v3

Summary: Carry over v2 settings, configure the legacy binary reader and understand how resetting settings affects migration.

Use these settings when carrying over a Save System v2 project and configuring the reader for existing v2 binary saves. For a new installation, use the Setup Guide.

Carry over your settings

Open Tools › Gley › Save System. When v2 is detected, choose Upgrade from v2 to carry over its platform storage choices and serializer settings. The upgrade also enables Read v2 binary saves when the old settings use binary storage. Encryption stays off after the upgrade.

Create fresh settings instead creates a new setup with encryption enabled. It does not carry over the old platform choices or binary-save settings.

Read v2 binary saves

In the Advanced tab, find Migration and enable Read v2 binary saves when you need to read existing v2 binary saves. The v2 binary reader works on every platform except WebGL builds.

Reset to defaults disables Read v2 binary saves, clears platform overrides, turns encryption on and sets the serializer to JsonUtility. The current encryption key and previous keys are kept. After a reset, recheck the migration setting and serializer before testing existing v2 saves.

Save System Advanced tab with the Migration section and Read v2 binary saves setting below the general advanced controls.
On This Page