GamePassStorageXbox Connected Storage, done carefully

A game-agnostic .NET 10 library and the wgs tool for reading and safely writing the save folders Game Pass PC titles use.

Get started

Why it is careful

View on GitHub

Container layer only

Handles containers.index, container.N manifests and GUID blobs. What is inside a blob belongs to a game adapter. One ships for Abiotic Factor, more load as plugins, and a generic model covers every other title.

Game adapters

Built around cloud sync

ETags are echoed, never minted. The index timestamp always advances. Unresolved conflicts are never hidden. Writes go blob, then manifest, then index.

Read the safety model

No package dependencies

Filesystem, clock and logging are injected, so a store can run against an in-memory filesystem or a fault-injecting one in your own tests.

Test your code

A command-line tool

List, diagnose, inspect, extract, back up, snapshot, compare, put, delete, restore, export and import, with a backup required before any write.

CLI reference

Documented format

Byte layouts, state and sync-flag meanings, read and write rules, sources, and an honest list of what is still unverified.

Format reference

Typed results

Lock conflicts, concurrent changes, in-flight syncs and unsupported layouts come back as status values you can act on, not exceptions to guess at.

Every status explained

Install

console

dotnet add package GamePassStorage           # the library
dotnet tool install -g GamePassStorage.Tool  # the `wgs` command-line tool

A first look

csharp

using GamePassStorage;

var opened = WgsStore.TryOpen(storeFolder);
if (!opened.Succeeded) { Console.WriteLine(opened.Message); return; }

foreach (var c in opened.Store!.Containers)
    Console.WriteLine($"{c.Name}  {c.State}  {c.BlobSize} bytes");

console

wgs list "C:\Users\me\AppData\Local\Packages\<family>\SystemAppData\wgs"
wgs diagnose <store>

Close the game before you write

Local file access does not give control over Xbox cloud sync. Close the game (and ideally go offline) before writing, and let the title upload the change on its next launch.

GamePassStorage was extracted from Abiotic Editor. Abiotic Factor is the only title verified so far; see Supported titles.