# Use Cases

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

## Available Use Cases

### 1. [Save Player Progress](/features/cloud-services/playmaker/use-cases/use-case-1-save-progress.md)

* **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](/features/cloud-services/playmaker/use-cases/use-case-2-multi-device-sync.md)

* **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](/features/cloud-services/playmaker/use-cases/use-case-3-settings-backup.md)

* **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](/features/cloud-services/playmaker/use-cases/use-case-4-user-account-change.md)

* **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](/features/cloud-services/playmaker/use-cases/use-case-5-reset-cloud-data.md)

* **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](https://github.com/voxelbusters/essential-kit-docs/blob/master/tutorials/v3/features/cloud-services/playmaker/use-cases/use-case-6-es3-raw-bytes-sync.md)

* **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](https://github.com/voxelbusters/essential-kit-docs/blob/master/tutorials/v3/features/cloud-services/playmaker/use-cases/use-case-7-es3-key-value-sync.md)

* **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**](/features/cloud-services/playmaker.md) - Actions + key patterns + use-cases


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://assetstore.essentialkit.voxelbusters.com/features/cloud-services/playmaker/use-cases.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.