Cloud Saves

Automatic, versioned save file sync for your players across devices

What is Cloud Saves?

The Cloud Saves add-on automatically backs up and synchronizes your players' save files across their devices. It follows the Steam Auto-Cloud model: you tell the launcher where your game stores its saves, and the launcher handles the rest. No game code changes are required.

The launcher downloads the latest cloud save before your game launches
The launcher uploads changes after your game exits
Every upload is stored as a new version, so the server never overwrites a save

Cloud Saves Addon is a separate subscription service. 14 DAYS FREE TRIAL AVAILABLE See plans here

Requirements

Requirement

Why

Enable Authentication System addon

Saves are stored per player, so each player needs an account

Players signed in

Guest sessions do not sync (there is no player identity to attach saves to)

Cloud Saves requires the Authentication System addon to be enabled on the same launcher. Players who continue as guests will play with local saves only.

How It Works

The Sync Lifecycle

Before launch: when a player presses Play, the launcher checks the cloud for a newer save version and downloads it into the configured save folder
While playing: the launcher does not touch the save folder
After exit: the launcher scans the configured save paths and, if anything changed, uploads the files as a new version
Version history: the last N versions (you choose 1 to 10) are kept per player, per app, and can be restored at any time

Conflict Resolution

If both the local save and the cloud save changed since the last sync (for example, the player played offline on another PC), the launcher shows a conflict dialog before launching:

Local save: last modified date, machine name, and size
Cloud save: last modified date, machine name, and size

The player picks which one to keep. Nothing is lost either way: the cloud side keeps its version history, and the chosen save is uploaded as a new version.

Versions and Restore

Every upload creates a new version, and the server never overwrites existing data. Players can open the Cloud Saves panel in the launcher (right-click the app) and restore any of the stored versions, for example to recover from a corrupted save.

Save Paths

For each app you configure where the saves live, per platform (Windows, Linux, macOS). A save path is made of three parts:

A base location token (a well-known folder on the player's machine)
A relative subpath inside that base location (for example MyStudio/MyGame/Saves)
Optional include/exclude patterns (glob patterns, one per line)

Base Location Tokens

Token

Windows

Linux

macOS

AppData

C:\Users\<player>\AppData\Roaming

~/.config

LocalAppData

C:\Users\<player>\AppData\Local

~/.local/share

Documents

C:\Users\<player>\Documents

The user's Documents folder

SavedGames

C:\Users\<player>\Saved Games

~ (home folder)

UserProfile

C:\Users\<player>

~ (home folder)

InstallDir

The app's install folder

Example

Base location AppData with subpath MyStudio/MyGame/Saves resolves to:

Windows: C:\Users\<player>\AppData\Roaming\MyStudio\MyGame\Saves
Linux: /home/<player>/.config/MyStudio/MyGame/Saves

The relative subpath is required: you cannot sync an entire base folder such as Documents. Absolute paths and .. segments are rejected for safety.

Include and Exclude Patterns

Fine-tune which files are synced with glob patterns (one pattern per line). The default include pattern is **/* (everything under the save folder).

Pattern

Type

Effect

**/*

Include

Sync every file (default)

**/*.sav

Include

Sync only .sav files, in any subfolder

cache/**

Exclude

Skip everything under the cache folder

*.tmp

Exclude

Skip temporary files in the root folder

Keep the synced set small: exclude caches, logs, screenshots, and anything the game can regenerate. Smaller saves sync faster and use less of your storage pool.

Quotas and the Storage Pool

Tier

Storage pool

Max per-player quota (per app)

Free Trial

5 GB

200 MB

Essential

50 GB

200 MB

Professional

250 GB

500 MB

Studio

1 TB

1 GB

Cloud Saves uses two limits that work together:

Storage pool: the total cloud storage for your entire launcher, shared across all apps and all players. Its size depends on your tier.
Per-player quota: how much storage a single player can use per app. You configure it in MB for each app (default 200 MB), up to the maximum allowed by your tier.

Stored versions count toward both limits: keeping fewer versions or excluding regenerable files frees up space. You can watch the pool usage meter and per-app usage from the dashboard at any time.

How to Enable

Go to your launcher in the dashboard and open the Add-ons tab
Select Cloud Saves
Accept the Cloud Saves feature terms
Start the 14 day free trial or choose a tier (Essential, Professional, or Studio)
Make sure the Authentication System addon is enabled on the same launcher
Configure each app that should sync saves (see below)

Once an app is configured, players' launchers start syncing automatically: no new launcher build is needed.

Per-App Configuration

Open the app's settings in the dashboard and go to the Cloud Saves tab:

Setting

Default

Notes

Enable Cloud Saves

Off

Turns sync on for this app

Per-player quota

200 MB

In MB, up to your tier's maximum

Versions to keep

Between 1 and 10 versions per player

Save paths

(empty)

Base token + subpath + patterns, per platform (Windows, Linux, macOS)

Configure a save path for every platform your app ships on. A platform without a save path simply does not sync on that platform.

Player Experience

For players, Cloud Saves is invisible when everything goes well:

Sign in to the launcher and press Play
The latest cloud save is downloaded before the game starts
Play normally
When the game exits, changed save files are uploaded in the background

The Cloud Saves Panel

Players can right-click an app in the launcher and open Cloud Saves to:

See their quota usage and last sync time
Browse the stored versions and restore any of them
Trigger a manual Sync now
Disable Cloud Saves on this machine (local saves only on that PC; other machines keep syncing)

Offline Play

Playing offline just works: the game uses the local saves. The next time the player launches online, the launcher reconciles. If the cloud also changed in the meantime, the player resolves it through the conflict dialog.

Dashboard Monitoring

The launcher's Cloud Saves addon tab shows:

Storage pool usage meter (how much of your pool is used)
Per-app usage breakdown
Monthly transfer stats (uploads and downloads)

Troubleshooting & FAQ

What happens when a player plays offline? The game runs with local saves. On the next online launch the launcher syncs normally, and shows the conflict dialog only if both sides changed.

What happens when a player exceeds their quota? The upload is skipped and the player sees a notice in the Cloud Saves panel. Local saves are never touched. Free up space by raising the per-player quota, upgrading your tier, or keeping fewer versions.

What happens when the launcher storage pool is full? New uploads pause across the launcher until space is freed or the tier is upgraded. Existing saves and versions stay available for download.

If I disable the addon, are player saves deleted? No. Syncing stops, but the stored versions remain until you delete them. Re-enabling the addon resumes syncing where it left off.

Do guest players get Cloud Saves? No. Saves are tied to a player account, so guests play with local saves only.

What if the save folder does not exist yet? Nothing is uploaded until the game creates its first save files. This is normal for brand-new players.

Need Help?

If you have questions about Cloud Saves or need a larger storage pool, contact our support team.

PreviousCustom Auth (Bring Your Own Auth)NextOverview

Last updated 18 days ago

Was this helpful?