三步提取Xbox Game Pass存档并迁移到SteamXGP-save-extractor完整指南【免费下载链接】XGP-save-extractorPython script to extract savefiles out of Xbox Game Pass for PC games项目地址: https://gitcode.com/gh_mirrors/xg/XGP-save-extractor假如你在 Game Pass 上通关了一款游戏随后买了 Steam 版进度却带不过去——Xbox 的存档藏在系统隐藏目录里格式和商店版对不上。XGP-save-extractor 是一款免费的开源脚本用于 Xbox Game Pass 存档提取它自动定位已安装支持游戏的存档、解析 Xbox 专有容器打包成可直接放入 Steam 或 Epic 存档目录的 ZIP适合从 Game Pass 迁移到 Steam/Epic 的玩家。为什么手动翻存档这么费劲存档路径是第一道坎XGP 游戏的存档位于%LOCALAPPDATA%\Packages\包名\SystemAppData\wgs目录下麻烦不只是藏得深目录名是编号不是人名。每个用户的存档目录以UserID_TitleID的十六进制形式命名想分清是哪位家庭成员的进度得手动对照 Xbox 账号 ID。里面是容器不是文件。真正的存档被装进 WGS 容器文件Windows Game Services 的打包格式索引文件containers.index用 GUID——全局唯一标识符类似文件的身份证号——来引用每个文件。把目录原样拷给 Steam 完全认不出来。云同步会捣乱。Xbox 应用在后台同步云存档同步途中读取会拿到不完整文件这也是存档损坏的常见来源。手动操作每款游戏大约要花 20-30 分钟多用户机器上还容易拿错账号的文件。XGP 存档提取原理从 GUID 容器到 ZIP 的 4 步一句话定位这个脚本是个容器拆包器——对照games.json判断装了哪些支持的游戏逐个解码容器索引按目标平台要求的结构重组存档最后压缩输出。定位游戏目录 解码容器索引 按游戏规则重组 打包输出 discover_games - read_user_containers - get_save_paths - ZIP %LOCALAPPDATA%\ containers.index 重命名/加后缀/ 游戏名_账号_时间戳.zip Packages 下扫描 GUID 文件映射 建嵌套目录不同游戏的存档组织方式不同工具为此准备了几种通用处理器handler和专属逻辑1c1f一个容器一个文件如 Manor Lords、1cnf一个容器装多个文件如 Hades、1cnf-folder每个容器对应一个目录如 Persona 5 RoyalStarfield、Control、Lies of P、Palworld 等还有专门分支——比如 Starfield 把单个存档拆成多个分片文件存放脚本需要按顺序重新拼接并补 padding 还原成一个 .sfs 存档这类二进制操作手动几乎做不了。三步存档备份最小路径跑通第一次提取第 1 步准备环境并获取工具需要 Python 3.10操作指令git clone https://gitcode.com/gh_mirrors/xg/XGP-save-extractor cd XGP-save-extractor python --version预期结果终端显示 3.10 及以上版本号项目目录里能看到main.py和games.json两个文件。第 2 步运行脚本等待自动探测操作指令python main.py预期结果打印 Installed supported games: 后列出本机已安装的支持游戏每款游戏下显示各用户的可提取存档清单若 Xbox 应用正在做云存档同步会出现!! ... !!警告提示稍后再试。第 3 步拿到 ZIP 并核对内容操作指令提取完成后到项目目录找到生成的压缩包命名格式为游戏名_账号名_时间戳.zip。 预期结果终端显示Save files written to ...打开 ZIP 能看到可识别的存档文件如.sav或.sfs将其放入 Steam/Epic 对应游戏的存档目录即可。⚠️ 迁移后首次进游戏建议新建存档槽并手动保存一次确认进度可用避免旧档被新档覆盖。机制与取舍手动存档复制 vs 自动 WGS 容器解析环节手动方式XGP-save-extractor定位存档目录翻 Packages 目录、对照 ID✅ 自动扫描已装支持游戏区分归属账号自己解析十六进制用户 ID✅ 自动关联 gamertag 或用户 ID解码容器格式❌ 无可行手段二进制 GUID 映射✅ 按游戏 handler 解析文件名/目录重组靠猜目标平台的组织方式✅ 自动重命名、加后缀、建目录同步未完成防护❌ 无法察觉⚠️ 仅提示警告需手动重试单游戏耗时约 20-30 分钟易出错一条命令跑完全部已装游戏取舍很明确工具只处理支持列表内的游戏games.json中 40 余款而像 A Plague Tale: Requiem、Forza Horizon 4 等 12 款与商店版存档格式差异过大、无法简单转换的游戏被列在 README 的不兼容清单里——遇到这些别浪费时间硬提。进阶存档场景多账户、添加新游戏、批量备份多账户机器脚本会遍历wgs下的每个用户目录独立处理不同账号各自生成独立 ZIP文件名里带账号标识家庭共享设备不再混档。若目录里存在 Xbox 应用生成的backup子目录脚本会提示并跳过它们避免重复读取。添加新游戏先看games.json中是否已有配置每条规则只需商店包名和处理器{ name: Forza Horizon 5, package: Microsoft.624F8B84B80_8wekyb3d8bbwe, handler: forza }未收录的游戏先翻一遍 Issues 确认是否有人提交过再提新 issue容器格式分析完成后由社区合并进列表你之后重新拉取即可。批量备份python main.py默认一次性提取本机所有已安装的支持游戏每款各出一个 ZIP。养成习惯的话通关或卸载 Game Pass 游戏前跑一次就是最省心的存档备份方式。存档提取报错自查常见警告快速修复清单现象运行后提示No supported games installed或直接退出。原因本机没有安装支持列表里的游戏或games.json缺失、格式损坏。处理先把任意一款支持游戏安装并运行一次生成目录仍报错就检查项目目录里games.json是否完整有效。现象出现Missing container ...或Missing file ...警告个别文件被跳过。原因云存档同步未完成文件还没就位。处理等几分钟、关闭 Xbox 应用后重试官方说明也建议提取失败时稍后再跑一次。现象提示Two files exist for container ...同一文件存在两个 GUID 副本脚本跳过它。原因同步冲突留下的中间状态工具无法判断取哪一份。处理等待云同步彻底完成可让 Xbox 应用后台跑一会儿再重新提取。现象ZIP 正常生成目标平台却读不了存档。原因游戏版本不匹配或该游戏的 handler 规则与当前版本不符。处理在目标平台手动新建一个存档对比两边文件结构差异把结论反馈给社区列表中的状态✅ 已确认可用 / ❔ 未确认也会随之更新。README 中维护着完整的已支持游戏表与不兼容游戏表迁移前建议先查目标游戏对应的平台是否已标记为可用遇到新游戏或 bug提 issue 是最快的推动方式。【免费下载链接】XGP-save-extractorPython script to extract savefiles out of Xbox Game Pass for PC games项目地址: https://gitcode.com/gh_mirrors/xg/XGP-save-extractor创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 三步提取Xbox Game Pass存档并迁移到Steam：XGP-save-extractor完整指南
三步提取Xbox Game Pass存档并迁移到SteamXGP-save-extractor完整指南【免费下载链接】XGP-save-extractorPython script to extract savefiles out of Xbox Game Pass for PC games项目地址: https://gitcode.com/gh_mirrors/xg/XGP-save-extractor假如你在 Game Pass 上通关了一款游戏随后买了 Steam 版进度却带不过去——Xbox 的存档藏在系统隐藏目录里格式和商店版对不上。XGP-save-extractor 是一款免费的开源脚本用于 Xbox Game Pass 存档提取它自动定位已安装支持游戏的存档、解析 Xbox 专有容器打包成可直接放入 Steam 或 Epic 存档目录的 ZIP适合从 Game Pass 迁移到 Steam/Epic 的玩家。为什么手动翻存档这么费劲存档路径是第一道坎XGP 游戏的存档位于%LOCALAPPDATA%\Packages\包名\SystemAppData\wgs目录下麻烦不只是藏得深目录名是编号不是人名。每个用户的存档目录以UserID_TitleID的十六进制形式命名想分清是哪位家庭成员的进度得手动对照 Xbox 账号 ID。里面是容器不是文件。真正的存档被装进 WGS 容器文件Windows Game Services 的打包格式索引文件containers.index用 GUID——全局唯一标识符类似文件的身份证号——来引用每个文件。把目录原样拷给 Steam 完全认不出来。云同步会捣乱。Xbox 应用在后台同步云存档同步途中读取会拿到不完整文件这也是存档损坏的常见来源。手动操作每款游戏大约要花 20-30 分钟多用户机器上还容易拿错账号的文件。XGP 存档提取原理从 GUID 容器到 ZIP 的 4 步一句话定位这个脚本是个容器拆包器——对照games.json判断装了哪些支持的游戏逐个解码容器索引按目标平台要求的结构重组存档最后压缩输出。定位游戏目录 解码容器索引 按游戏规则重组 打包输出 discover_games - read_user_containers - get_save_paths - ZIP %LOCALAPPDATA%\ containers.index 重命名/加后缀/ 游戏名_账号_时间戳.zip Packages 下扫描 GUID 文件映射 建嵌套目录不同游戏的存档组织方式不同工具为此准备了几种通用处理器handler和专属逻辑1c1f一个容器一个文件如 Manor Lords、1cnf一个容器装多个文件如 Hades、1cnf-folder每个容器对应一个目录如 Persona 5 RoyalStarfield、Control、Lies of P、Palworld 等还有专门分支——比如 Starfield 把单个存档拆成多个分片文件存放脚本需要按顺序重新拼接并补 padding 还原成一个 .sfs 存档这类二进制操作手动几乎做不了。三步存档备份最小路径跑通第一次提取第 1 步准备环境并获取工具需要 Python 3.10操作指令git clone https://gitcode.com/gh_mirrors/xg/XGP-save-extractor cd XGP-save-extractor python --version预期结果终端显示 3.10 及以上版本号项目目录里能看到main.py和games.json两个文件。第 2 步运行脚本等待自动探测操作指令python main.py预期结果打印 Installed supported games: 后列出本机已安装的支持游戏每款游戏下显示各用户的可提取存档清单若 Xbox 应用正在做云存档同步会出现!! ... !!警告提示稍后再试。第 3 步拿到 ZIP 并核对内容操作指令提取完成后到项目目录找到生成的压缩包命名格式为游戏名_账号名_时间戳.zip。 预期结果终端显示Save files written to ...打开 ZIP 能看到可识别的存档文件如.sav或.sfs将其放入 Steam/Epic 对应游戏的存档目录即可。⚠️ 迁移后首次进游戏建议新建存档槽并手动保存一次确认进度可用避免旧档被新档覆盖。机制与取舍手动存档复制 vs 自动 WGS 容器解析环节手动方式XGP-save-extractor定位存档目录翻 Packages 目录、对照 ID✅ 自动扫描已装支持游戏区分归属账号自己解析十六进制用户 ID✅ 自动关联 gamertag 或用户 ID解码容器格式❌ 无可行手段二进制 GUID 映射✅ 按游戏 handler 解析文件名/目录重组靠猜目标平台的组织方式✅ 自动重命名、加后缀、建目录同步未完成防护❌ 无法察觉⚠️ 仅提示警告需手动重试单游戏耗时约 20-30 分钟易出错一条命令跑完全部已装游戏取舍很明确工具只处理支持列表内的游戏games.json中 40 余款而像 A Plague Tale: Requiem、Forza Horizon 4 等 12 款与商店版存档格式差异过大、无法简单转换的游戏被列在 README 的不兼容清单里——遇到这些别浪费时间硬提。进阶存档场景多账户、添加新游戏、批量备份多账户机器脚本会遍历wgs下的每个用户目录独立处理不同账号各自生成独立 ZIP文件名里带账号标识家庭共享设备不再混档。若目录里存在 Xbox 应用生成的backup子目录脚本会提示并跳过它们避免重复读取。添加新游戏先看games.json中是否已有配置每条规则只需商店包名和处理器{ name: Forza Horizon 5, package: Microsoft.624F8B84B80_8wekyb3d8bbwe, handler: forza }未收录的游戏先翻一遍 Issues 确认是否有人提交过再提新 issue容器格式分析完成后由社区合并进列表你之后重新拉取即可。批量备份python main.py默认一次性提取本机所有已安装的支持游戏每款各出一个 ZIP。养成习惯的话通关或卸载 Game Pass 游戏前跑一次就是最省心的存档备份方式。存档提取报错自查常见警告快速修复清单现象运行后提示No supported games installed或直接退出。原因本机没有安装支持列表里的游戏或games.json缺失、格式损坏。处理先把任意一款支持游戏安装并运行一次生成目录仍报错就检查项目目录里games.json是否完整有效。现象出现Missing container ...或Missing file ...警告个别文件被跳过。原因云存档同步未完成文件还没就位。处理等几分钟、关闭 Xbox 应用后重试官方说明也建议提取失败时稍后再跑一次。现象提示Two files exist for container ...同一文件存在两个 GUID 副本脚本跳过它。原因同步冲突留下的中间状态工具无法判断取哪一份。处理等待云同步彻底完成可让 Xbox 应用后台跑一会儿再重新提取。现象ZIP 正常生成目标平台却读不了存档。原因游戏版本不匹配或该游戏的 handler 规则与当前版本不符。处理在目标平台手动新建一个存档对比两边文件结构差异把结论反馈给社区列表中的状态✅ 已确认可用 / ❔ 未确认也会随之更新。README 中维护着完整的已支持游戏表与不兼容游戏表迁移前建议先查目标游戏对应的平台是否已标记为可用遇到新游戏或 bug提 issue 是最快的推动方式。【免费下载链接】XGP-save-extractorPython script to extract savefiles out of Xbox Game Pass for PC games项目地址: https://gitcode.com/gh_mirrors/xg/XGP-save-extractor创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考