Python MIT

XGP-save-extractor

Python script to extract savefiles out of Xbox Game Pass for PC games

Z

Z1ni

Dernière activité 9 oct. 2025
Z1ni/XGP-save-extractor

983

étoiles

92

forks

264

issues ouvertes

a-plague-tale-requiematomic-heartbackupcelestecontrolepic-games-storefinal-fantasy-xvgame-saveshadesjust-cause-4lies-of-pmigrationoctopathtravelerpalworldpython3starfieldsteamtotally-accurate-battle-simulatorxbox-game-passyakuza-0

Ce README est souvent en anglais.

XGP-save-extractor

Python script to extract/backup savefiles out of Xbox Game Pass for PC games.

When run, the script produces a ZIP file for each supported game save found in the system.

In most cases the files in the ZIP can be copied to the save directory of the Steam/Epic version of the game. To find out the save file location, check PCGamingWiki.

Important

If you want the script to support another game, please open an issue here.

Check the incompatible game list below and search the issues for a duplicate before creating a new one.

Supported games

If you migrate a save to Steam/Epic version that's listed with ❔ below, please open an issue and confirm whether it worked, so the table can be updated.

Legend: ✅ Confirmed working, ❔ Unconfirmed, - Not available in the store

Game Tested w/ Steam Tested w/ Epic
Arcade Paradise ✅ ✅
Atomic Heart ✅ -
The Callisto Protocol ✅ -
Celeste ❔ ❔
Chained Echoes ❔ ❔
Chorus ✅ ❔
Control ❔ ✅
Coral Island ✅ -
Clair Obscur: Expedition 33 ✅ -
Cricket 24 ✅ -
Doom Eternal ✅ ?
Final Fantasy XV ✅ -
Forza Horizon 5 ✅ -
Fuga: Melodies of Steel 2 ❔ ❔
Hades ✅ ❔
High on Life ✅ ❔
Hi-Fi RUSH ✅ ❔
Hypnospace Outlaw ✅ ❔
Just Cause 4 ❔ ❔
Lies of P ✅ -
Manor Lords ✅ ❔
Mechwarrior 5 Clans ✅ ❔
Monster Train ✅ -
Ninja Gaiden Sigma ✅ -
Oblivion Remastered ✅ ❔
Octopath Traveller ❔ ❔
One Lonely Outpost ✅ ❔
Palworld ✅ -
Persona 5 Royal ✅ -
Persona 5 Tactica ✅ -
Railway Empire 2 ❔ ❔
Remnant 2 ✅ ❔
Remnant: From the Ashes ❔ ❔
Sea of Stars ✅ ❔
Solar Ash ✅ ❔
SpiderHeck ✅ ❔
Starfield ✅ -
State of Decay 2 ✅ ❔
The Alters ✅ ❔
Totally Accurate Battle Simulator ✅ -
Trials of Mana ✅ ❔
Wo Long: Fallen Dynasty ❔ -
Yakuza 0 ✅ -

Incompatible games

These games use different save formats than the Steam/Epic version that can't be easily converted.

Game Issue
A Plague Tale: Requiem #139
ARK: Survival Ascended #165
Chivarly 2 #39
Death's Door #79
Forza Horizon 4 #71
Like a Dragon Gaiden: The Man Who Erased His Name #66
Like a Dragon: Ishin! #180
Neon White #185
Persona 3 Reload #114
Tinykin #28
Yakuza: Like a Dragon #72

Running

Important

If the save file extraction fails, wait for a bit and try again. The Xbox cloud save sync can take some time and produce invalid files while syncing is in progress.

Important

Some anti-virus/anti-malware software can flag the executable as malicious. The executable is produced with PyInstaller and contains the Python interpreter alongside with the same main.py script as in this repo.

Download the latest release for an one-file executable: https://github.com/Z1ni/XGP-save-extractor/releases

Or

Run main.py with Python 3.10+. The script produces ZIP files for each of the supported games that are installed for the current user.

Thanks

Thanks to @snoozbuster for figuring out the container format at goatfungus/NMSSaveEditor#306.

Also thanks to everyone that has contributed by adding support for new games.

Projets similaires

Utility to transfer save files between the games installed from the Xbox app and other storefronts. https://ko-fi.com/fr33dan

C#gamesxbox
FFr33dan
631 étoiles55

Backup tool for PC game saves

Rustbackupclicross-platform
Mmtkennerly
6,3 k étoiles139

A versatile game save backup manager, featuring Steam detection, Minecraft support, drag & drop, desktop shortcuts and emulator compatible.

Pythonautomationbackupdesktop-app
MMatteo842
507 étoiles11