Use Cases

Quick-start guides for cloud save/sync using PlayMaker custom actions.

Available Use Cases

1. Save Player Progress

• What it does: Save level, score, and progress to cloud

• Actions: 2 (SetValue, Synchronize)

• Best for: Progress backup, cross-device play

2. Multi-Device Sync

• What it does: Load progress and handle remote updates

• Actions: 3 (GetValue, OnSavedDataChange, GetChangedKeys)

• Best for: Cross-device continuity, conflict resolution

3. Settings Cloud Backup

• What it does: Backup and restore player preferences

• Actions: 4 (SetValue, HasKey, GetValue, RemoveKey)

• Best for: Settings sync, user preferences

4. User Account Change Handling

• What it does: React to cloud user account status changes

• Actions: 3 (OnUserChange, GetUserInfo, Synchronize)

• Best for: Disabling cloud UI when signed out/restricted

5. Reset Cloud Data

• What it does: Remove specific keys or all keys from cloud

• Actions: 2 (RemoveKey/RemoveAllKeys, Synchronize)

• Best for: “Reset cloud save” settings actions

6. Easy Save Raw File Sync

• What it does: Sync a full ES3 file as raw bytes under one cloud key

• Actions: 1 (ES3EssentialKitCloudServicesSyncRawBytes)

• Best for: Full-file backup/restore without per-key policies

7. Easy Save Key-Value Sync

• What it does: Sync all ES3 keys with per-type conflict rules and missing-key policy

• Actions: 1 (ES3EssentialKitCloudServicesSyncKeyValues)

• Best for: Fine-grained conflict handling for ES3 key-value saves

Quick Action Reference

Action	Purpose
CloudServicesSetValue	Save data to cloud
CloudServicesGetValue	Load data from cloud
CloudServicesGetSnapshot	Read full snapshot as JSON
CloudServicesHasKey	Check if a key exists in the snapshot
CloudServicesSynchronize	Trigger manual sync
CloudServicesOnSavedDataChange	Listen for remote updates
CloudServicesGetChangedKeys	Read all changed keys as string array
CloudServicesGetCloudAndLocalCacheValues	Read cloud + local cache values for a key (conflict handling)
CloudServicesOnUserChange	Listen for user account changes
CloudServicesGetUserInfo	Read cached user id/status
CloudServicesRemoveKey	Delete specific key
CloudServicesRemoveAllKeys	Clear all cloud data
ES3EssentialKitCloudServicesSyncRawBytes	Sync ES3 file bytes to one cloud key (Easy Save support define required)
ES3EssentialKitCloudServicesSyncKeyValues	Sync ES3 key-values with conflict rules (Easy Save support define required)

Related Documentation

• README.md - Actions + key patterns + use-cases