Documentation Index
Fetch the complete documentation index at: https://mintlify.com/legendary-gl/legendary/llms.txt
Use this file to discover all available pages before exploring further.
legendary sync-saves compares your local save game files against those stored in Epic’s cloud and synchronises them in whichever direction is needed. By default it processes every installed game that supports cloud saves, though you can narrow the operation to a single title by passing its App Name. On the first run for any game, Legendary will compute the expected save path and ask you to confirm (or correct) it before syncing.
Usage
Positional Arguments
| Argument | Description |
|---|---|
<App Name> | App name of the game to sync (optional — if omitted, all supported installed games are synced) |
Options
| Flag | Description |
|---|---|
--skip-upload | Only download new saves from the cloud; do not upload local saves |
--skip-download | Only upload new saves to the cloud; do not download from cloud |
--force-upload | Force an upload even if local saves are older than the cloud copy |
--force-download | Force a download even if local saves are newer than the cloud copy |
--save-path <path> | Override the save game path for this session (requires a single App Name to be specified) |
--disable-filters | Disable save game file filtering when uploading |
--skip-upload and --skip-download are mutually exclusive in effect — combining both would mean no data is transferred. Use one or the other when you intentionally want a one-way sync.Examples
Sync all installed games that support cloud saves:Save Path Confirmation
The first time you run
sync-saves for a game, Legendary will compute the expected save path from the game’s metadata and ask you to confirm it is correct. If the computed path contains unresolved variables (shown as %VARIABLE% or {variable}), you will be prompted to enter the path manually. The confirmed path is stored in Legendary’s installed-games database so subsequent syncs require no interaction.Global -y Flag
Passing -y (or --yes) at the global level before the command skips all interactive prompts. When combined with sync-saves, games whose save paths have not yet been confirmed are skipped rather than prompted: