> For the complete documentation index, see [llms.txt](https://assetstore.essentialkit.voxelbusters.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://assetstore.essentialkit.voxelbusters.com/features/cloud-services/playmaker/use-cases.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.