steam-cloud-saves

Implement Steam Cloud saves using Auto-Cloud configuration or the ISteamRemoteStorage API.

1|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/TMHSDigital/Steam-Cursor-Plugin --skill steam-cloud-saves-tmhsdigital
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: steam-cloud-saves
Source: https://github.com/TMHSDigital/Steam-Cursor-Plugin/tree/main/skills/steam-cloud-saves
Command: npx skills add https://github.com/TMHSDigital/Steam-Cursor-Plugin --skill steam-cloud-saves-tmhsdigital

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Adding cloud save support to a Steam game involves choosing between Auto-Cloud file syncing and manual SDK calls, configuring per-platform paths, and handling sync conflicts and quotas, which is easy to get wrong without guidance. ## Core Features & Use Cases - Auto-Cloud Configuration: Set up file-based cloud syncing via the Steamworks Partner site or a steam_autocloud.vdf file with per-platform roots like WinAppDataLocal and LinuxHome. - Manual Cloud Storage: Use ISteamRemoteStorage API calls (FileWrite, FileRead, GetQuota, FileDelete) with code examples in C++, C# (Steamworks.NET), and GDScript (GodotSteam). - Conflict Resolution & Quotas: Handle sync conflicts between machines, check cloud quotas, and avoid pitfalls like endianness issues and case-sensitive filenames. - Use Case: A developer with a roguelike storing run_data.json in AppData wants cloud saves; the Skill recommends Auto-Cloud, provides the VDF config for Windows, Linux, and Mac, and suggests appropriate quota limits. ## Quick Start Ask the agent to add Steam Cloud save support to your game, providing your App ID and whether you prefer Auto-Cloud or manual SDK integration.

Frequently Asked Questions about steam-cloud-saves

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add Steam Cloud saves to my game?▼

Use Auto-Cloud for file-based syncing with no code changes, configured via the Steamworks Partner site or a steam_autocloud.vdf file. For full control, use the ISteamRemoteStorage API with FileWrite and FileRead calls in the Steamworks SDK.

What is the difference between Steam Auto-Cloud and ISteamRemoteStorage?▼

Auto-Cloud syncs files from specified paths automatically without any code, while ISteamRemoteStorage gives manual control over what gets synced and when through SDK API calls. Auto-Cloud suits simple save files; manual storage suits custom conflict handling.

How do I configure steam_autocloud.vdf for multiple platforms?▼

Add numbered entries with Root values like WinMyDocuments, WinAppDataLocal, LinuxHome, or MacHome, plus SubDirectory, FileType patterns, and Recursive flags. Each platform gets its own entry pointing to the equivalent save location.

Why are my Steam Cloud saves not syncing?▼

Common causes include exceeding the per-user cloud quota, case-sensitive filename mismatches on Linux, and endianness issues in binary saves. Check quota with GetQuota(), standardize filenames to lowercase, and prefer text-based formats like JSON.

How do I handle Steam Cloud sync conflicts?▼

For Auto-Cloud, Steam shows a conflict dialog letting the user pick local or remote. For manual cloud storage, compare FileRead content with the local save, check timestamps with GetFileTimestamp, and present a UI letting the user choose which version to keep.