mirror of
https://github.com/Droid-Deck/DroidDeck.git
synced 2026-11-21 22:05:59 +00:00
Stores: cloud saves recognise GOG games, wait for a new prefix, never overwrite blindly
On device nothing ran for ELDERBORN: a GOG game without arguments has no launcher .bat, Steam runs its exe, and droiddeck-store-launch only looked for the .bat. It now recognises the exe too, looking through the folders above it for the sidecar, and every path logs a result line. A first launch has no prefix yet: the download is answered as deferred and runs once Proton has made the prefix's user folder, within a minute, without holding the launch. Uploads are safe now. CloudPlan decides per file against this device's baseline - the local and cloud state at the last sync: no upload before a download has completed once, the first download lets the cloud win, and a file changed on both sides is a conflict that Manage saves offers to settle with Keep cloud or Keep local. The cloud copy is backed up before an upload replaces it, as the local folder is before a download.
This commit is contained in:
1 parent
b323a0b33e
commit
41422407c4
11 files changed
+464
-87
No files matched your search
@@ -118,10 +118,25 @@ parked overlay work is on the branch `park/epic-eos-overlay`.
|
||||
## Cloud saves
|
||||
|
||||
GOG and Epic games sync their saves with the store's cloud (`CloudSaves`, after Bannerlator's
|
||||
managers): before a launch the cloud copy comes down where it is newer, after the game exits what
|
||||
changed goes up - newest wins, file by file, with an MD5 check so a file the game only touched is
|
||||
not sent again. Before a download overwrites anything the folder is copied to
|
||||
`files/stores/cloud-backups/<store>-<id>/` (the last three kept).
|
||||
managers): before a launch the cloud copy comes down, after the game exits what changed goes up.
|
||||
`CloudPlan` decides per file against a baseline - each file's local MD5 and cloud MD5/time as of
|
||||
this device's last sync:
|
||||
|
||||
- **No upload before a download has completed once on this device** (no baseline): a first launch
|
||||
creates new profile files that must never replace the real saves in the cloud.
|
||||
- **The first download lets the cloud win** where the two differ.
|
||||
- **A file changed on both sides since the baseline is a conflict:** neither side is overwritten;
|
||||
Manage saves shows "Cloud conflict" with Keep cloud / Keep local.
|
||||
- Otherwise the side that changed wins; bytes that match move nothing.
|
||||
|
||||
Both sides are backed up before they are replaced: the local folder before a download writes into
|
||||
it, the cloud copies before an upload replaces them, under
|
||||
`files/stores/cloud-backups/<store>-<id>/local-*` and `cloud-*` (the last three of each).
|
||||
|
||||
A game launched before Proton has made its prefix (a first launch) gets its download deferred: the
|
||||
request is answered at once (`result=deferred reason=no-prefix`) and the download runs as soon as
|
||||
the prefix's user folder appears, within a minute. Every path logs
|
||||
`cloud <store> <id> down|up result=ok|skipped|deferred|failed files= bytes= reason=`.
|
||||
|
||||
- **The folder:** GOG's public remote-config gives a location template per game (by its Galaxy client
|
||||
id), e.g. `<?APPLICATION_DATA_LOCAL_LOW?>/Hyperstrange/ELDERBORN`; Epic's catalog gives
|
||||
@@ -132,6 +147,9 @@ not sent again. Before a download overwrites anything the folder is copied to
|
||||
- **The services:** GOG `cloudstorage.gog.com/v1/<user>/<client>` with a token issued to the game's
|
||||
own client (the client secret is kept at install; the Galaxy token is the fallback); Epic's
|
||||
savesync data storage with signed read and write links.
|
||||
- **Which launches:** `droiddeck-store-launch` recognises a store game by the launcher .bat Steam runs
|
||||
or, for a game without one (most GOG games), by its exe - the folders above it are searched for
|
||||
the sidecar.
|
||||
- **When:** every launch runs `droiddeck-store-launch`, which asks the app (`cloud-down`) and waits up
|
||||
to 15 s; for a store game with cloud saves it returns 10, and the compat tool then waits for
|
||||
Proton instead of exec'ing it and runs `droiddeck-store-launch --exited` after, which asks for
|
||||
|
||||
@@ -150,6 +150,13 @@ without it and Setup says "Stores engine not built").
|
||||
native start takes the whole set (`cdnBases`; the engine spreads its window across the hosts) and
|
||||
its `onBytes` - every 250 ms, including files still in flight - drives the bar and the speed, so a
|
||||
large file no longer moves the bar in one jump.
|
||||
- **Cloud saves, device round 1 (ELDERBORN, `b323a0b`): nothing ran** - a GOG game without arguments
|
||||
gets no launcher .bat, Steam runs its exe, and `droiddeck-store-launch` only recognised the .bat.
|
||||
It now recognises the exe too (searching the folders above it for the sidecar), and every path
|
||||
logs a result line. A first launch has no prefix yet: the download is deferred until Proton makes
|
||||
it, without holding the launch. Uploads are now safe: none before a download has set this
|
||||
device's baseline, a file changed on both sides is a conflict left for Keep cloud / Keep local,
|
||||
and the cloud copy is backed up before an upload replaces it (`CloudPlan`, tests for each rule).
|
||||
- **GOG and Epic cloud saves** (ported from Bannerlator's managers, device-proven there in August):
|
||||
down before every launch where the cloud copy is newer (the compat tool waits up to 15 s), up
|
||||
after the game exits (the compat tool waits for Proton for such a game, then asks without
|
||||
|
||||
Reference in new issue
Block a user